查询视频生成任务

GET

/api/v3/contents/generations/tasks/{id}

将创建响应的 id 放入路径，使用同一 Key 查询。

status	含义	客户端处理
running	排队或处理中	约 5 秒后继续查询
succeeded	生成成功	读取 `content.video_url`，下载保存
failed	失败或取消	停止轮询，读取 `error`

成功不要求一定存在 usage。公开用量字段为 total_tokens/input_tokens/output_tokens（可选），不要要求必须返回上游的 completion_tokens。本期返回字段见 Schema，不保证返回官方全部字段，如实际时长、分辨率或更新时间。

查询示例

若创建时设置 return_last_frame=true，成功响应还可包含 content.last_frame_url，值为平台转存后的 OSS 地址。不要把输入 role=last_frame 与输出 last_frame_url 混淆。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

BASE_URL=https://api.starcore.cloud
API_KEY='<YOUR_API_KEY>'
TASK_ID='task_example_01'
curl --fail-with-body --request GET "$BASE_URL/api/v3/contents/generations/tasks/$TASK_ID" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Accept: application/json"

返回响应

🟢200

application/json

任务状态；成功、处理中和失败均使用 HTTP 200，请检查 status。

Bodyapplication/json

示例

处理中成功（用量为示例，允许不返回）任务失败成功并返回已转存的最后一帧

{
    "id": "task_example_01",
    "model": "dreamina-seedance-2.5",
    "status": "running",
    "created_at": 1792454400
}

🟠400

🟠401

🟠403

🟠404

🟠429

🔴502

🔴503

修改于 2026-10-20 11:59:42

提交视频生成任务

查询视频生成任务

查询示例#

请求参数

请求示例代码

返回响应

查询示例