OpenAI 兼容 API 手册

视频生成任务

创建文生视频或图生视频任务后,使用 /v1/videos/tasks/:id 查询进度和结果。长任务可进入控制台任务日志,由 worker 写回状态、失败原因和扣费记录;后台全局任务列表默认脱敏 prompt、payload、上游 ID 和 URL。

POST /v1/videos/generations
Videos
curl https://api09.com/v1/videos/generations \
  -H "Authorization: Bearer sk-api09_xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"veo-3","prompt":"产品图变成 6 秒推进镜头","duration":6,"size":"16:9"}'

curl https://api09.com/v1/videos/tasks/task_id \
  -H "Authorization: Bearer sk-api09_xxx"

请求字段

字段类型说明
AuthorizationheaderBearer sk-api09_xxx。
modelstring视频模型 ID,例如 veo-3 或 wan-2-5。
promptstring视频任务描述。
duration / sizenumber / string可选,影响预估积分和上游任务参数。
GET /v1/videos/tasks/:idpath查询视频任务状态,任务必须属于当前 API Key 所属用户。

响应与计费

字段类型说明
data.idstringapi09 TaskLog ID。
data.status / progressstring / number任务状态与进度百分比。
data.creditsEstimate / creditsChargednumber预估积分与实际扣费积分。
data.upstreamTaskIdstring上游任务 ID;用户自己的任务查询可见,后台全局列表默认脱敏。
data.outputUrl / errorMessagestring成功时返回结果 URL,失败时返回脱敏错误信息;后台全局列表默认脱敏。
data.requestPayloadobject原始 payload 内的 URL、base64、token、authorization 等字段会被遮罩。

积分统一换算:1 USD = 200 积分。

生产检查

worker 成功后原子扣费
失败任务可从控制台重试
GET 查询不暴露其他用户任务