查询视频生成任务

接入信息	值
Base URL	`https://api.starcore.cloud`
请求	`GET /v1/videos/{id}`
鉴权	`Authorization: Bearer <YOUR_API_KEY>`

将路径中的任务 ID 替换为提交返回的 id，使用创建时的 Key。GET 无需请求体。

任务状态

status	含义	下一步
queued / in_progress	排队或处理中	约 5 秒后再查
completed	已完成	保存结果文件
failed	失败或已取消	停止查询，查看 error

成功后调用下方内容接口下载 MP4。progress 当前仅为 0 / 100，不代表实时生成百分比。

查询 cURL

整段复制到 Apipost / Apifox 的 cURL 导入，替换 <YOUR_API_KEY> 后使用。将 <TASK_ID> 替换为任务 ID。

下载 MP4

仅在 status=completed 后调用。Apipost / Apifox 请保存响应文件；终端执行保存为 generated.mp4。

未完成返回 HTTP 409；不存在或无权限返回 404；文件暂不可用可能返回 502。先检查 HTTP 状态码，避免把错误 JSON 保存成视频。

查询说明

遇到 HTTP 429 请降低查询频率；不存在、无权限或协议不匹配的任务可能返回 404。请以任务最终状态判断是否生成成功；结果文件准备完成后即可获取。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

application/json

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

Bodyapplication/json

示例

排队处理中已完成（用量为可选示例）任务失败

{
    "id": "task_example_01",
    "object": "video",
    "model": "dreamina-seedance-2.5",
    "status": "queued",
    "progress": 0,
    "created_at": 1792454400
}

任务状态

查询 cURL

下载 MP4

查询说明

请求参数

请求示例代码

返回响应

查询视频生成任务

任务状态#

查询 cURL#

下载 MP4#

查询说明#

请求参数

请求示例代码

返回响应

任务状态

查询 cURL

下载 MP4

查询说明