1. OpenAI 兼容异步视频
星核API国际站
  • 开始
  • 模型API
    • 文本生成
      • OpenAI Chat Completions API
      • OpenAI Responses API
      • Anthropic Messages API
    • 图片生成
      • OpenAI 兼容异步生图
        • 提交图片生成任务
        • 查询图片生成任务
        • 提交图片编辑任务
        • 查询图片编辑任务
    • 视频生成
      • OpenAI 兼容异步视频
        • 提交视频生成任务
          POST
        • 查询视频生成任务
          GET
      • Seedance 官方 Ark 视频
        • 提交视频生成任务
        • 查询视频生成任务
  1. OpenAI 兼容异步视频

查询视频生成任务

GET
/v1/videos/{id}
使用创建响应的 id 查询,GET 无请求体。
status含义客户端处理
queued / in_progress排队或处理中约 5 秒后继续查询
completed成功停止轮询,调用内容接口下载
failed失败或取消停止轮询,检查 error
查询响应保留本平台任务 ID,不返回供应商私有 ID 或视频 CDN 地址。当前 progress 只是 0/100 标记,并非实时百分比。成功时可选返回 usage.total_tokens/input_tokens/output_tokens,客户端不能依赖用量对象判断成功,也不要依赖本文未定义的上游响应字段。

查询示例#

下载结果#

GET /v1/videos/{id}/content 使用相同 Bearer Key,正常响应 HTTP 200、Content-Type: video/mp4;请保存二进制响应。尚未完成返回 HTTP 409(error.code 为 NotReady);任务不存在或无权限返回 404;文件暂不可用可返回 502。先检查 HTTP 状态码,失败响应按错误 JSON 处理,不要把 JSON 错误内容当视频使用。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Path 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
BASE_URL=https://api.starcore.cloud
API_KEY='<YOUR_API_KEY>'
TASK_ID='task_example_01'
curl --fail-with-body --request GET "$BASE_URL/v1/videos/$TASK_ID" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Accept: application/json"

返回响应

🟢200
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
}
🟠400
🟠401
🟠403
🟠404
🟠429
🔴502
🔴503
修改于 2026-10-20 11:59:25
上一页
提交视频生成任务
下一页
提交视频生成任务
Built with