Sora-2

视频模型，此接口与submit调用方式不同，与openai 官方接口调用方式一致，模型功能无差异。

异步提交任务

接口

https://airouter.xincache.cn/v1/videos

输入

参数	类型	是否必选	描述
model	string	是	模型名称，此处为 `sora-2`
prompt	string	是	提示词，用于指导视频生成
size	string	否	生成视频的尺寸。可选的分辨率： - `720x1280` - `1280x720`
duration	string	否	视频生成时长（秒），可选值 `4`, `8`, `12`
input_reference	string	否	首帧图

请求示例

⚠️ 如果您使用 Windows 系统，建议使用 Postman 或其他 API 调用工具。

curl -X POST "https://airouter.xincache.cn/v1/videos" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F prompt="She turns around and smiles, then slowly walks out of the frame." \
  -F model="sora-2" \
  -F size="1280x720" \
  -F seconds="8" \
  -F input_reference="@sample_720p.jpeg;type=image/jpeg"

输出

参数	类型	描述
id	string	异步任务的唯一标识
object	string	类型
model	string	模型名称
status	string	任务状态,queued, in_progress, completed, and failed
progress	int	任务进度
size	string	分辨率
seconds	string	时长

响应示例

{
    "id": "video_456",
    "object": "video",
    "model": "sora-2",
    "status": "queued",
    "progress": 0,
    "created_at": 1712698600,
    "size": "720x1280",
    "seconds": "8"
}

查询任务状态

接口

https://airouter.xincache.cn/v1/videos/<task_id>

请求示例

curl --location 'https://airouter.xincache.cn/v1/videos/video_6982fa1cd4f081908b619dc53cfc2435' \
-H "Authorization: Bearer $OPENAI_API_KEY"

输出

参数	类型	描述
id	string	异步任务的唯一标识
object	string	类型
model	string	模型名称
status	string	任务状态,queued, in_progress, completed, and failed
progress	int	任务进度
size	string	分辨率
seconds	string	时长

响应示例（成功）

{
  "id": "video_456",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1712698600,
  "size": "720x1280",
  "seconds": "8"
}

响应示例（失败）

{
  "error": {
    "message": "error",
    "type": "invalid_request_error",
    "param": null,
    "code": null
  }
}

下载视频

接口

https://airouter.xincache.cn/v1/videos/<task_id>/content

请求示例

curl --location 'https://airouter.xincache.cn/v1/videos/<task_id>/content' \
-H "Authorization: Bearer $OPENAI_API_KEY"
--output video.mp4

正常返回

返回二进制流

异常返回

{
    "error": {
        "message": "task is not completed yet, current status: Pending",
        "type": "invalid_request_error"
    }
}

remix

接口

https://airouter.xincache.cn/v1/videos/<task_id>/remix

请求示例

curl -X POST "https://airouter.xincache.cn/v1/videos/<task_id>/remix" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "赛博朋克风格"
  }'

正常返回

{
  "id": "video_456",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1712698600,
  "size": "720x1280",
  "seconds": "8",
  "remixed_from_video_id": "video_123"
}

异常返回

{
    "error": {
        "message": "Invalid param: prompt is required",
        "type": "invalid_request_error",
        "param": "6217f8ed-396d-434a-9b78-96775c0d2f99",
        "code": "param_error"
    }
}

Last modified: 25 April 2026