查询视频任务

轮询单个视频（及可灵、Midjourney 生图）任务的状态与结果地址。

GET/v1/video/tasks/{task_id}

用提交时返回的任务 ID 轮询，推荐每 5 秒一次；轮询不占并发、不计费。Seedance / Grok 响应用 task 包装，MiniMax / 可灵是顶层字段——不要读错层级。

Seedance 任务创建超过 24 小时仍未结束会被自动判为失败（不计费），task.error.message 为 The task did not finish within 24 hours and was terminated automatically。结果地址是 api.hop-base.com 下的签名地址，再次查询返回同一地址、不会续期：Seedance 与 Grok 30 天，可灵、MiniMax 6 小时，请在有效期内下载保存。未完成的任务 24 小时（Seedance）或 2 小时（可灵、MiniMax）后判失败。

查询视频任务

curl https://api.hop-base.com/v1/video/tasks/vtEXAMPLE \
  -H "Authorization: Bearer $HOPBASE_API_KEY"

200application/json

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "dreamina-seedance-2-5-260628",
    "status": "completed",
    "duration_seconds": 5,
    "outputs": [
      "https://api.hop-base.com/example-signed-video.mp4"
    ],
    "last_frame_url": "https://api.hop-base.com/example-signed-last-frame.jpg",
    "usage": {
      "completion_tokens": 1000,
      "total_tokens": 1000
    },
    "error": null,
    "created_at": "2026-09-23T08:00:00Z",
    "completed_at": "2026-09-23T08:03:10Z"
  },
  "usage": {
    "cost": 3.4,
    "currency": "CNY",
    "cost_cny": 3.4,
    "cost_usd": 0.5
  }
}

请求头

Authorization:必填string

Bearer sk-…：控制台「API 密钥」里创建的密钥，所属分组须包含请求的模型

路径参数

task_id:必填string

提交返回的任务 ID：vt…（Seedance / Grok）、mmt…（MiniMax）、kt…（可灵）

200任务对象（含失败任务）

系列

task:可选object

任务

usage:可选object

任务结束后才有，且只对创建任务的密钥返回。0 表示失败且未扣费

错误

401没带密钥、密钥无效或已过期（missing_api_key / invalid_api_key / api_key_expired）

404任务不存在或不属于这把密钥

请求头

路径参数

返回

错误

相关页面