任务查询结果

任务完成后，可以通过内容接口获取视频文件或视频下载地址。这个接口适合需要由本站代理下载生成结果的场景。

接口信息

项目	值
方法	GET
路径	/v1/videos/{task_id}/content
示例地址	https://api.gemai.cc/v1/videos/task_abc123def456/content
鉴权	Authorization: Bearer sk-你的令牌

请求示例

cURL

curl --location 'https://api.gemai.cc/v1/videos/task_abc123def456/content' \
  --header "Authorization: Bearer $GEMAI_API_KEY" \
  --output output.mp4

JavaScript

import fs from 'node:fs/promises'

const response = await fetch('https://api.gemai.cc/v1/videos/task_abc123def456/content', {
  headers: {
    Authorization: `Bearer ${process.env.GEMAI_API_KEY}`,
  },
})

if (!response.ok) {
  throw new Error(`下载视频失败：${response.status} ${await response.text()}`)
}

const buffer = Buffer.from(await response.arrayBuffer())
await fs.writeFile('output.mp4', buffer)

Python

import os
import requests

response = requests.get(
    'https://api.gemai.cc/v1/videos/task_abc123def456/content',
    headers={'Authorization': f"Bearer {os.environ['GEMAI_API_KEY']}"},
    timeout=300,
)

response.raise_for_status()
with open('output.mp4', 'wb') as file:
    file.write(response.content)

返回结果

成功时可能直接返回视频二进制文件，也可能返回包含下载地址的 JSON。请根据响应头和响应体内容处理：

{
  "url": "https://cdn.volcengineapi.com/videos/output-abc123.mp4"
}

注意事项

• 请先确认任务状态已经完成，再请求内容接口。
• 如果接口返回 JSON，请读取其中的 url 或相关视频地址字段。
• 如果接口直接返回二进制内容，使用 --output、arrayBuffer() 或 response.content 保存为 .mp4 文件。