查询视频任务

按 task_id 查询生成状态与结果 URL。任务进行中时会自动向上游轮询最新状态。

GET/v1/videos/generations/{task_id}已上线
GET/v3/contents/generations/tasks/{task_id}已上线

鉴权

所有 /v1/* 接口均必须携带平台 API Key:Authorization: Bearer sk-pyo-...。Key 在 控制台 → API Keys 创建。上游移动云等供应商 Key 由平台托管,客户无需直接使用。

# OpenAI 风格
curl "https://www.openmodels.com.cn/v1/videos/generations/cgt-20260822120000-xxxxx" \
  -H "Authorization: Bearer <OPENMODELS_API_KEY>"

# 火山 Ark 风格(baseURL = https://ai.pengyoo.com/api/v3)
curl "https://ai.pengyoo.com/api/v3/contents/generations/tasks/cgt-20260822120000-xxxxx" \
  -H "Authorization: Bearer <OPENMODELS_API_KEY>"
{
  "id": "cgt-20260822120000-xxxxx",
  "model": "chinamobile-seedance-2.0",
  "status": "succeeded",
  "content": {
    "video_url": "https://…上游签名地址….mp4",
    "last_frame_url": "https://…上游签名地址….png"
  },
  "duration": 5,
  "resolution": "720p",
  "ratio": "16:9",
  "generate_audio": true,
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1724328000,
  "updated_at": 1724328120,
  "error": null
}

status 与火山一致:queued(排队中)、running(运行中)、cancelled(已取消,仅排队中任务可取消,24 小时后不再可查)、succeeded、failed、expired(超时)。仅可查询最近 7 天的任务。

model 始终等于创建时提交的平台 model id,不透传上游内部版本号。created_at / updated_at 为本平台 Unix 秒:创建时两者相同, 状态变化后 updated_at 才更新,不会改用上游时钟。 成片请读取 content.video_url(与火山/移动一致,为上游原文链接,通常约 24 小时内有效,请及时下载)。error 始终返回:成功为 null,失败为 { "code": "...", "message": "..." }。