{
"id": "task_example",
"object": "video",
"model": "YOUR_MODEL_ID",
"status": "queued",
"progress": 0,
"created_at": 1700000000
}创建视频任务
请求格式、响应与能力边界。
{
"id": "task_example",
"object": "video",
"model": "YOUR_MODEL_ID",
"status": "queued",
"progress": 0,
"created_at": 1700000000
}POST /v1/videos
提供 model、prompt，可选模型支持的 seconds、size 和参考图片。JSON 与 multipart 由执行插件解释；文件上传使用 multipart 的 input_reference。
当前宿主返回 HTTP 200 和公开任务 id，不表示生成完成。保存 ID 并查询状态；不要在轮询时再次 POST。公开协议保留不等于上游可用，尤其不能假定已停用的 OpenAI Sora 服务仍在线。
完整接入指南与可执行示例
Read in English授权
模型调用 API Key，不是控制台登录凭据 / Model API key, not console login credentials
请求体
当前密钥可用且支持此接口的模型 ID / Model ID available to the key and supporting this endpoint
"YOUR_MODEL_ID"
任务描述；遵循模型的长度和内容要求 / Task description; follow model length and content requirements
请求时长，单位秒；使用插件和模型允许的值，不以宿主安全上限作为模型能力 / Duration in seconds; use plugin/model values, not the host safety ceiling
"4"
模型支持的宽x高 / Model-supported widthxheight
"1280x720"
可选参考图片文件，格式与尺寸需模型支持 / Optional reference image file; format and dimensions must be supported
响应
接受任务，不代表生成完成 / Task accepted, not necessarily completed
网关公开任务 ID，后续查询/下载使用此值 / Public gateway task ID; use for retrieval/download
"task_example"
"video"
当前密钥可用且支持此接口的模型 ID / Model ID available to the key and supporting this endpoint
"YOUR_MODEL_ID"
以状态判断完成；unknown 必须单独处理 / Determine completion from status; handle unknown separately
queued, in_progress, completed, failed, unknown 进度提示，不等同于完成保证 / Progress hint, not proof of completion
Unix 秒 / Unix seconds
完成时间，可省略 / Completion timestamp; may be omitted
渠道可能提供的过期时间 / Optional expiry from channel
Show child attributes
Show child attributes