OpenAI Videos 兼容协议

该插件实现 /v1/videos 异步视频合同：以 multipart 创建任务，取得任务 ID 后查询同一路径下的任务资源。它用于 Sora/OpenAI Videos 风格渠道；模型、尺寸、时长、价格和保留期由实际渠道决定。

接口与鉴权

POST {channel_base_url}/v1/videos
GET  {channel_base_url}/v1/videos/{task_id}
Authorization: Bearer <API_KEY>
Content-Type: multipart/form-data

模型与能力边界

模型名必须是部署服务实际开放的视频模型。插件不把任意 sora-* 或 sd-* 名称视为可用，也不提供价格表。当前实现支持文生视频和单组参考图输入，不发送参考视频、参考音频、独立音频开关或水印。

参数与字段映射

duration -> seconds，发送为十进制字符串；aspectRatio -> size，这里应填写上游尺寸而不是只写 16:9；images -> input_reference multipart 部件。空字段不发送。

文生视频示例

curl -X POST "{channel_base_url}/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -F "model=YOUR_VIDEO_MODEL" \
  -F "prompt=清晨薄雾中的竹林，镜头缓慢向前推进" \
  -F "seconds=8" \
  -F "size=1280x720"

图片参考示例

curl -X POST "{channel_base_url}/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -F "model=YOUR_VIDEO_MODEL" \
  -F "prompt=保持参考图人物一致，镜头从中景推进到特写" \
  -F "seconds=8" \
  -F "size=720x1280" \
  -F "input_reference=@character.png"

创建、轮询与下载

{"id":"task_xxx","status":"queued"}

curl "{channel_base_url}/v1/videos/task_xxx" -H "Authorization: Bearer <API_KEY>"

完成响应可在顶层或嵌套对象提供 url、video_url、result_url 或视频数组。失败消息从 message、error、fail_reason 提取。当前插件没有取消接口，也不会自动删除上游任务；轮询间隔和下载有效期必须服从渠道说明。

官方与兼容资料

OpenAI Videos API reference
若渠道是 NewAPI 或其他兼容实现，还必须核对该部署的版本说明；路径相同不等于字段和模型完全一致。

2.3 KiB Raw Blame History Unescape Escape