Skip to main content
GET
https://www.geeknow.top
/
v1
/
videos
/
{id}
curl -X GET https://www.geeknow.top/v1/videos/task_01jz8s3dbke8p9vq2m8r9a7gk4 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "task_01jz8s3dbke8p9vq2m8r9a7gk4",
  "object": "video",
  "created": 1790557800,
  "model": "seedance-2.0-pro",
  "status": "in_progress"
}

​
Seedance-2 查询视频任务

这个接口用于查询 Seedance-2 异步视频任务的最新状态。
  • 根据创建任务返回的 id 查询
  • 任务完成后返回 video_url
  • 失败任务会返回 error
  • 状态统一为 queued、in_progress、completed、failed

​
方法与路径

GET /v1/videos/{id}

curl -X GET https://www.geeknow.top/v1/videos/task_01jz8s3dbke8p9vq2m8r9a7gk4 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
响应示例

{
  "id": "task_01jz8s3dbke8p9vq2m8r9a7gk4",
  "object": "video",
  "created": 1790557800,
  "model": "seedance-2.0-pro",
  "status": "in_progress"
}

​
认证

Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
id
string
required
视频任务 ID。创建视频任务接口返回的 id，例如 task_01jz8s3dbke8p9vq2m8r9a7gk4。

​
Response

​
object
string
对象类型，通常为 video。
​
id
string
视频任务 ID。
​
status
string
任务状态。支持 queued、in_progress、completed、failed。
​
created
integer
创建时间戳。
​
model
string
任务使用的模型名称。
​
video_url
string
任务完成时返回的视频 URL。
​
actualDuration
integer
实际生成的视频时长。上游返回该字段时透出。
​
totalTokens
integer
任务计费用量。上游返回该字段时透出。
​
error
string
任务失败原因。

​
状态映射

上游状态返回状态
pending、queuedqueued
processing、running、in_progressin_progress
succeeded、completedcompleted
failed、cancelledfailed

​
使用场景

​
轮询到任务完成

创建任务后保存返回的 id，每隔数秒调用一次查询接口。status 为 completed 时读取 video_url。 
GET /v1/videos/task_01jz8s3dbke8p9vq2m8r9a7gk4

​
获取失败原因

当 status 为 failed 时，读取 error 字段定位失败原因。 
{
  "status": "failed",
  "error": "task failed"
}

​
注意事项

  • 查询接口只读取任务状态，不会重新提交生成任务。
  • video_url 只在任务完成且上游返回结果地址后出现。
  • 如果需要代理下载视频内容，可使用 GET /v1/videos/{id}/content。

​
相关页面