Sora 4 视频生成

Sora 4 系列视频生成模型，支持文生视频、图生视频（单图/多图）、首帧/首尾帧参考、图片+音频参考，以及图片+视频+音频同时参考的全能参考模式。

接入地址

线路	Base URL
官网（推荐）	`https://iliu.ai`
海外直连	`https://api.xinliu.one`

Header

参数名	是否必填	说明
Authorization	是	`Bearer 你的令牌`
Content-Type	是	`application/json`

请求体（JSON）

参数	类型	必填	说明
model	string	是	视频模型名称，可选 `sora-v4-pro`（质量优先）或 `sora-v4-fast`（速度优先）
prompt	string	是	视频描述提示词
aspect_ratio	string	是	支持 `16:9`、`9:16`、`4:3`、`3:4`、`1:1`、`21:9`
resolution	string	是	可用值：`720p`
seconds	string	是	时长（秒），可用值：`10`、`15`；建议传字符串，例如 `"10"`，接口也兼容数字 `10`
image_url	string	否	单张参考图；支持 HTTP(S) URL、图片 Data URI 或纯 Base64；与 `reference_image_urls` 合计最多 9 张
reference_image_urls	array	否	多张参考图；每项支持 HTTP(S) URL、图片 Data URI 或纯 Base64；与 `image_url` 合计最多 9 张
reference_video	string	否	参考视频 URL；多个时使用 `reference_videos` 数组；最多 3 个，单条 2-15 秒，总时长不超过 15 秒；支持 MP4、MOV、WebM
reference_videos	array	否	参考视频 URL 数组；最多 3 个，单条 2-15 秒，总时长不超过 15 秒；支持 MP4、MOV、WebM
audio_url	string	否	参考音频 URL；需同时提供至少一张参考图；最多 3 个，单条 2-15 秒，总时长不超过 15 秒；支持 MP3、WAV、M4A、AAC、OGG/Opus，不支持 FLAC
audio_urls	array	否	参考音频 URL 数组；限制与 `audio_url` 相同；可与 `audio_url` 同时提交，接口会合并去重
video_config	object	否	视频高级配置对象，包含 `reference_mode` 字段：`auto`（默认，多图参考）、`start_frame`（首帧，必须正好 1 张图）、`start_end`（首尾帧，必须正好 2 张图，不能与参考视频同时使用）

可用模型

模型名	说明
sora-v4-pro	质量优先
sora-v4-fast	速度优先

curl 示例

文生视频：

图生视频（单图参考）：

图生视频（多图参考）：

参考图也支持 Data URI 或纯 Base64。Data URI 格式为 data:image/<格式>;base64,<Base64内容>；纯 Base64 不带 data: 前缀，支持 JPEG、PNG、WebP。

首帧参考（指定一张图片作为视频起始画面，需显式设置 reference_mode 为 start_frame，只能传 1 张图）：

首尾帧参考（两张图片分别作为起始和结束画面，需显式设置 reference_mode 为 start_end，必须正好传 2 张图，不能与参考视频同时使用）：

图片+音频参考（使用音频参考时必须同时提供至少一张参考图）：

全能参考（同一请求里同时传图片、视频、音频，不需要额外开关；image_url 为主参考图，reference_image_urls 为额外参考图）：

提交后立即返回

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "sora-v4-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1784117559,
  "seconds": "10",
  "size": "1280x720"
}

task_id：任务 ID，用于后续查询进度和下载结果

status：任务状态，见下方任务进度查询说明

progress：任务进度百分比

size：实际渲染分辨率，由 aspect_ratio + resolution 换算得到

任务进度查询与结果获取

复用共用节点：

查询任务状态：视频任务查询（共用） GET /v1/videos/{task_id}

下载视频：视频内容下载（共用） GET /v1/videos/{task_id}/content

任务状态依次为 queued、in_progress、completed、failed。建议每 5-10 秒轮询一次。任务状态变为 completed 后即可获取视频文件。

任务完成后查询接口返回：

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "sora-v4-fast",
  "status": "completed",
  "progress": 100,
  "created_at": 1784117559,
  "completed_at": 1784117735,
  "seconds": "10",
  "size": "1280x720",
  "url": "https://files.example.com/output.mp4",
  "video_url": "https://files.example.com/output.mp4",
  "result_url": "https://files.example.com/output.mp4"
}

url、video_url、result_url 三个字段值相同，即视频文件下载直链；也可通过共用下载节点 GET /v1/videos/{task_id}/content 获取（返回 302 跳转，curl 请加 -L 参数）。

参考素材数量限制

图片参考总数最多 9 张，按 image_url + reference_image_urls 合并计算

reference_video / reference_videos 最多 3 个，单条 2-15 秒，总时长不超过 15 秒

audio_url / audio_urls 最多 3 个，单条 2-15 秒，总时长不超过 15 秒，不支持 FLAC

单次请求上传文件总数（图片 + 视频 + 音频）不超过 15 个

使用音频参考时，必须同时提供至少一张参考图

首尾帧模式（start_end）不能与参考视频同时使用

错误码

HTTP 状态码	触发条件	返回示例
400	缺少 prompt	`{"code": "invalid_request", "message": "prompt is required", "data": null}`
401	令牌无效或缺失	`{"error": {"message": "Invalid token", "type": "new_api_error"}}`

Sora 4 视频生成