OpenAI 协议接入（视频）​

New API 提供与 OpenAI Videos API 对齐的异步视频接口。一个接口覆盖所有走异步任务的视频模型： 提交任务拿到任务 ID，再用任务 ID 查询状态、取回文件。

本页字段与状态取值直接对应仓库实现，改动代码时请同步更新： relay/common/relay_info.go（提交字段）、dto/openai_video.go（提交/查询响应的 OpenAI 形状）、 dto/task.go（网关通用任务响应）、model/task.go（任务状态常量）、router/video-router.go（路由）。

端点一览​

同一个提交入口还有一条别名：POST https://api.yu-yu.ai/v1/video/generations，查询别名为 GET https://api.yu-yu.ai/v1/video/generations/{task_id}。两者与上表行为一致，选任一条都可以。

鉴权​

所有端点都使用 API Key：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx
Content-Type: application/json

GET /v1/videos/{task_id}/content 额外允许控制台登录态直接访问（便于在浏览器里预览）， 但用 API Key 调用时与其他端点完全一致。

提交任务​

请求体字段​

metadata 里的常见键（是否生效取决于模型）：

请求示例​

curl -X POST 'https://api.yu-yu.ai/v1/videos' \
  -H 'Authorization: Bearer sk-xxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "wan3.0-video",
    "prompt": "一只橘猫坐在窗边打哈欠，清晨自然光，镜头缓慢推进",
    "size": "720p",
    "duration": 5
  }'

图生视频：

curl -X POST 'https://api.yu-yu.ai/v1/videos' \
  -H 'Authorization: Bearer sk-xxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "prompt": "镜头缓慢环绕",
    "image": "https://your-oss-domain/path/first-frame.jpg",
    "metadata": { "resolution": "1080p", "ratio": "16:9" }
  }'

提交响应​

提交成功后立即返回任务对象，此时视频还没生成：

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "wan3.0-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1767225600,
  "upstream_task_id": ""
}

查询任务​

curl 'https://api.yu-yu.ai/v1/videos/task_xxxxxxxxxxxxxxxx' \
  -H 'Authorization: Bearer sk-xxxxxxxxxxxxxxxx'

返回体有两种形状，以你实际拿到的为准：

形状 A：OpenAI 视频对象（绝大多数模型走这条）

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "wan3.0-video",
  "status": "completed",
  "progress": 100,
  "created_at": 1767225600,
  "completed_at": 1767225720,
  "seconds": "5",
  "size": "1280x720",
  "upstream_task_id": "cgt-2026xxxx",
  "metadata": { "url": "https://.../result.mp4" }
}

形状 B：网关通用任务对象（任务刚提交、模型平台信息尚未回填等情况下出现）

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://.../result.mp4",
    "resolution": "1280x720",
    "duration_seconds": 5,
    "submit_time": 1767225600,
    "start_time": 1767225610,
    "finish_time": 1767225720,
    "fail_reason": ""
  }
}

形状 B 的字段说明（data 内，来自网关任务对象）：

状态取值​

形状 A（小写）

形状 B（大写）

判断是否结束：形状 A 看 completed / failed / cancelled；形状 B 看 SUCCESS / FAILURE / CANCELLED。其余状态继续轮询。

取回视频文件​

GET https://api.yu-yu.ai/v1/videos/{task_id}/content 返回视频二进制流（不是 JSON），响应头带内容类型。 适合直接给播放器或下载：

curl -L 'https://api.yu-yu.ai/v1/videos/task_xxxxxxxxxxxxxxxx/content' \
  -H 'Authorization: Bearer sk-xxxxxxxxxxxxxxxx' \
  -o result.mp4

任务还没完成时该端点不返回半成品，会按任务状态给出错误；也可以直接用 result_url / metadata.url。

轮询建议​

任务耗时通常从十几秒到几分钟不等，建议：

• 首次查询延迟 5 秒以上，之后每次间隔 5 秒；单次任务轮询上限 10 次左右。
• 命中终态立即停止；连续查询失败不要重试到无限（网络类错误重试 2~3 次即可）。
• 长耗时模型（1080P、长时长）请放宽上限，或改用 callback_url 回调。

错误响应​

JSON 接口的错误体形如：

{
  "error": {
    "code": "task_not_exist",
    "message": "task_not_exist"
  }
}

常见错误码：

常见问题​

• 提交返回 model 不存在：确认模型名拼写，并用模型列表核对当前实例启用的模型。
• duration 传了字符串没生效：本接口同时接受数字与数字字符串，但不要传 "5s" 这类带单位的写法，只接受纯数字或纯数字字符串。
• 图生视频提示图片不可访问：参考图必须是公网可访问的 URL；本地文件先上传到对象存储。
• remix 报任务不存在：路径里的 {video_id} 必须是本 Key 自己提交成功过的任务 ID。
• 查询一直 in_progress：模型正在生成，或任务在排队。可用控制台任务页核对详细状态与进度。

在线调试​