哈基米API站

Appearance

查询视频生成任务状态（OpenAI 兼容格式） ​

使用任务 id 查询 OpenAI 兼容格式提交的 Seedance 2.0 视频生成状态。任务完成后，可以从 metadata.url 获取视频直链。

完美兼容 New API / One API

本接口完美兼容 New API、One API 等各类中转分发平台。 如果你使用的是中转平台，请确保使用本接口来轮询和查询生成状态，切勿调用非 /v1 的豆包原生查询接口。

接口信息 ​

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

请求示例 ​

bash
curl --location 'https://api.gemai.cc/v1/video/generations/task_abc123def456' \
  --header "Authorization: Bearer $GEMAI_API_KEY"

状态说明 ​

text
queued -> in_progress -> completed
                      \-> failed
状态含义处理方式
queued任务已提交，等待调度继续轮询
in_progress正在生成视频继续轮询
completed生成成功读取 metadata.url
failed生成失败查看 error.message

完成返回 ​

json
{
  "id": "task_abc123def456",
  "task_id": "task_abc123def456",
  "object": "video",
  "model": "doubao-seedance-2-0-260128",
  "status": "completed",
  "progress": 100,
  "created_at": 1712345678,
  "completed_at": 1712345900,
  "metadata": {
    "url": "https://cdn.volcengineapi.com/videos/output-abc123.mp4"
  }
}

失败返回 ​

json
{
  "id": "task_abc123def456",
  "task_id": "task_abc123def456",
  "object": "video",
  "model": "doubao-seedance-2-0-260128",
  "status": "failed",
  "progress": 100,
  "error": {
    "code": "content_policy_violation",
    "message": "请求内容违反了内容安全策略，请修改 prompt 后重试"
  }
}

JavaScript 轮询示例 ​

javascript
const apiKey = process.env.GEMAI_API_KEY
const taskId = 'task_abc123def456'

for (let index = 0; index < 120; index += 1) {
  const response = await fetch(`https://api.gemai.cc/v1/video/generations/${taskId}`, {
    headers: {
      Authorization: `Bearer ${apiKey}`,
    },
  })

  if (!response.ok) {
    throw new Error(`查询任务失败：${response.status} ${await response.text()}`)
  }

  const result = await response.json()

  if (result.status === 'completed') {
    console.log('视频地址：', result.metadata?.url)
    break
  }

  if (result.status === 'failed') {
    throw new Error(result.error?.message || '视频生成失败')
  }

  await new Promise((resolve) => setTimeout(resolve, 5000))
}

注意事项 ​

  • 请使用提交接口返回的 id 或 task_id。
  • 建议每 5 秒查询一次，总超时设置为 10 分钟左右。
  • 如果需要代理下载视频文件，可以继续查看 任务查询结果。