Sora3 VIP5 视频生成 API 对接文档

本文档面向终端客户，说明如何通过 OpenAI 兼容接口调用 sora3-vip5 系列视频模型生成视频。

实际 API_BASE_URL 和 API Key 由服务商单独提供。

基础信息

接口基础地址：

API_BASE_URL

所有接口都需要携带 API Key：

也兼容：

可用模型

| 模型 ID | 分辨率档位 | 横屏输出 | 竖屏输出 | 时长 |
|---|---|---:|---:|---:|---:|
| sora3-vip5-480p | 480p | 854x480 | 480x854 | 请求参数决定，4-15 秒 |
| sora3-vip5-720p | 720p | 1280x720 | 720x1280 | 请求参数决定，4-15 秒 |
| sora3-vip5-1080p | 1080p | 1920x1080 | 1080x1920 | 请求参数决定，4-15 秒 |
| sora3-vip5-fast-480p | 480p | 854x480 | 480x854 | 请求参数决定，4-15 秒 |
| sora3-vip5-fast-720p | 720p | 1280x720 | 720x1280 | 请求参数决定，4-15 秒 |
| sora3-vip5-fast-1080p | 1080p | 1920x1080 | 1080x1920 | 请求参数决定，4-15 秒 |

说明：

sora3-vip5-* 是标准版，质量优先。

sora3-vip5-fast-* 是快速版，速度优先。

分辨率由模型名决定，不需要再通过 size 切换 480p、720p、1080p。

横竖屏建议通过 orientation 或 aspect_ratio 明确传递。

1. 创建视频任务

请求参数

参数	类型	必填	说明
`model`	string	是	模型 ID，只能传本文档列出的 6 个模型之一
`prompt`	string	是	视频提示词
`duration`	int	否	视频时长，支持 4-15 秒；不传默认 4 秒
`seconds`	int	否	`duration` 的兼容字段；两者建议只传一个
`orientation`	string	否	`landscape` 横屏，`portrait` 竖屏
`aspect_ratio`	string	否	推荐 `16:9` 或 `9:16`
`size`	string	否	可传 `1280x720`、`720x1280` 等，用于推断横竖屏；不用于切换分辨率档位
`image_refs`	string[]	否	图片参考 URL，最多 9 张
`audio_refs`	string[]	否	音频参考 URL，最多 3 条
`video_refs`	string[]	否	视频参考 URL，最多 3 条
`generate_audio`	boolean	否	是否生成音频，默认 `true`
`negative_prompt`	string	否	负向提示词

字段别名：

image_refs 也兼容 imageRefs。

audio_refs 也兼容 audioRefs。

video_refs 也兼容 videoRefs。

素材引用规则

场景	限制
只传图片参考	`image_refs` 最多 9 张
传视频参考	`video_refs` 最多 3 条，并且至少搭配 1 张 `image_refs`
传音频参考	`audio_refs` 最多 3 条，并且至少搭配 1 张 `image_refs`
音频 + 图片	使用 `audio_refs` 时，`image_refs` 最多 2 张
音频 + 视频	使用 `audio_refs` 时，`audio_refs` + `video_refs` 合计最多 3 条
单个素材大小	建议不超过 60MB

素材 URL 建议使用公网可访问的 HTTPS 链接。也支持 data: URL，但不建议大文件使用 data: 形式。

在 prompt 中可以用 @Image1、@Video1、@Audio1 这类占位符描述素材用途。编号从 1 开始，顺序与数组顺序一致。

占位符	对应字段	示例
`@Image1`	`image_refs[0]`	`@Image1 是主角照片`
`@Image2`	`image_refs[1]`	`@Image2 是场景参考`
`@Video1`	`video_refs[0]`	`参考 @Video1 的动作节奏`
`@Audio1`	`audio_refs[0]`	`角色使用 @Audio1 的声音`

2. 请求示例

2.1 文生视频，标准版 720p，横屏 8 秒

{
  "model": "sora3-vip5-720p",
  "prompt": "一只金毛犬在清晨的海边奔跑，电影感镜头，柔和阳光，真实自然的运动轨迹",
  "duration": 8,
  "orientation": "landscape",
  "generate_audio": true
}

curl 示例：

2.2 文生视频，快速版 480p，竖屏 6 秒

{
  "model": "sora3-vip5-fast-480p",
  "prompt": "竖屏短视频，一名年轻人在城市天台转身看向镜头，背景是夜晚霓虹灯",
  "duration": 6,
  "aspect_ratio": "9:16"
}

2.3 图生视频，标准版 1080p，横屏 12 秒

{
  "model": "sora3-vip5-1080p",
  "prompt": "@Image1 是主角形象。让主角在雨夜街道缓慢向前走，镜头从侧后方跟拍，电影质感，高级灰色调",
  "duration": 12,
  "aspect_ratio": "16:9",
  "image_refs": [
    "https://example.invalid/assets/character.png"
  ]
}

2.4 多图参考，快速版 720p，横屏 15 秒

{
  "model": "sora3-vip5-fast-720p",
  "prompt": "@Image1 是角色，@Image2 是服装，@Image3 是室内场景。生成角色穿着参考服装走进室内空间的连续镜头，动作自然，镜头平稳推进",
  "duration": 15,
  "orientation": "landscape",
  "image_refs": [
    "https://example.invalid/assets/person.png",
    "https://example.invalid/assets/outfit.png",
    "https://example.invalid/assets/room.png"
  ]
}

2.5 图片 + 视频参考，标准版 720p

{
  "model": "sora3-vip5-720p",
  "prompt": "@Image1 是主角外观，参考 @Video1 的动作节奏，让主角完成同样的转身和挥手动作",
  "duration": 10,
  "aspect_ratio": "16:9",
  "image_refs": [
    "https://example.invalid/assets/person.png"
  ],
  "video_refs": [
    "https://example.invalid/assets/motion.mp4"
  ]
}

2.6 图片 + 音频 + 视频参考，快速版 1080p

使用音频参考时，audio_refs 和 video_refs 合计最多 3 条，并且 image_refs 最多 2 张。

{
  "model": "sora3-vip5-fast-1080p",
  "prompt": "@Image1 是说话人，使用 @Audio1 的声音情绪，参考 @Video1 的镜头运动。生成说话人面对镜头说欢迎语的视频",
  "duration": 8,
  "orientation": "portrait",
  "image_refs": [
    "https://example.invalid/assets/speaker.png"
  ],
  "audio_refs": [
    "https://example.invalid/assets/voice.wav"
  ],
  "video_refs": [
    "https://example.invalid/assets/camera_motion.mp4"
  ]
}

3. 创建任务响应

成功提交后返回任务信息。任务可能处于 queued 或 processing。

{
  "id": "video_example_task_id",
  "object": "video.task",
  "created": 1780000000,
  "created_at": 1780000000,
  "updated_at": 1780000000,
  "model": "sora3-vip5-720p",
  "status": "queued",
  "progress": 0,
  "duration": 8,
  "seconds": 8,
  "usage": {
    "seconds": 8,
    "video_count": 1
  }
}

字段说明：

字段	说明
`id`	视频任务 ID，用于查询结果
`object`	固定为 `video.task`
`model`	请求使用的公开模型名
`status`	`queued`、`processing`、`completed`、`failed`
`progress`	进度，整数 0-100
`duration` / `seconds`	请求的视频秒数
`usage.seconds`	本次任务秒数
`usage.video_count`	本次任务视频数量，固定为 1

4. 查询视频任务

curl 示例：

处理中响应

{
  "id": "video_example_task_id",
  "object": "video.task",
  "created": 1780000000,
  "created_at": 1780000000,
  "updated_at": 1780000012,
  "model": "sora3-vip5-720p",
  "status": "processing",
  "progress": 35,
  "duration": 8,
  "seconds": 8,
  "usage": {
    "seconds": 8,
    "video_count": 1
  }
}

完成响应

{
  "id": "video_example_task_id",
  "object": "video.task",
  "created": 1780000000,
  "created_at": 1780000000,
  "updated_at": 1780000180,
  "completed_at": 1780000180,
  "model": "sora3-vip5-720p",
  "status": "completed",
  "progress": 100,
  "duration": 8,
  "seconds": 8,
  "usage": {
    "seconds": 8,
    "video_count": 1
  },
  "video_url": "https://DOWNLOAD_BASE/generated/example.mp4",
  "video": {
    "url": "https://DOWNLOAD_BASE/generated/example.mp4"
  },
  "url": "https://DOWNLOAD_BASE/generated/example.mp4",
  "output": {
    "url": "https://DOWNLOAD_BASE/generated/example.mp4"
  },
  "result": {
    "url": "https://DOWNLOAD_BASE/generated/example.mp4"
  }
}

下载链接兼容字段：

video_url

video.url

url

output.url

result.url

失败响应

{
  "id": "video_example_task_id",
  "object": "video.task",
  "model": "sora3-vip5-720p",
  "status": "failed",
  "progress": 0,
  "duration": 8,
  "seconds": 8,
  "usage": {
    "seconds": 8,
    "video_count": 1
  },
  "error": {
    "message": "生成失败原因"
  }
}

5. Chat Completions 兼容接口

如果客户系统只支持 OpenAI Chat Completions，也可以使用：

5.1 非流式请求

{
  "model": "sora3-vip5-fast-720p",
  "prompt": "生成一段横屏城市航拍视频，傍晚金色光线，电影感",
  "duration": 8,
  "orientation": "landscape",
  "stream": false
}

响应示例：

{
  "id": "chatcmpl_example_id",
  "object": "chat.completion",
  "created": 1780000180,
  "model": "sora3-vip5-fast-720p",
  "url": "https://DOWNLOAD_BASE/generated/example.mp4",
  "video": {
    "url": "https://DOWNLOAD_BASE/generated/example.mp4"
  },
  "output": "https://DOWNLOAD_BASE/generated/example.mp4",
  "result": {
    "url": "https://DOWNLOAD_BASE/generated/example.mp4"
  },
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "url = https://DOWNLOAD_BASE/generated/example.mp4\n\n```html\n<video src='https://DOWNLOAD_BASE/generated/example.mp4' controls></video>\n```"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0
  }
}

5.2 流式请求

长视频生成建议使用 stream: true，服务端会持续返回 SSE 心跳，避免客户端误判连接断开。

{
  "model": "sora3-vip5-1080p",
  "prompt": "@Image1 是主角，生成主角在舞台上缓慢走向镜头的视频，聚光灯，电影感",
  "duration": 12,
  "aspect_ratio": "16:9",
  "stream": true,
  "image_refs": [
    "https://example.invalid/assets/character.png"
  ]
}

流式响应片段示例：

data: {"id":"chatcmpl_example_id","object":"chat.completion.chunk","created":1780000000,"model":"sora3-vip5-1080p","choices":[{"index":0,"delta":{"content":""},"finish_reason":null}]}

data: {"id":"chatcmpl_example_id","object":"chat.completion.chunk","created":1780000000,"model":"sora3-vip5-1080p","choices":[{"index":0,"delta":{"content":"url = https://DOWNLOAD_BASE/generated/example.mp4\n\n```html\n<video src='https://DOWNLOAD_BASE/generated/example.mp4' controls></video>\n```"},"finish_reason":null}]}

data: [DONE]

5.3 Chat 多模态格式

也可以把文本和图片写进 messages：

{
  "model": "sora3-vip5-720p",
  "duration": 8,
  "stream": true,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "参考这张图生成角色转身的视频，镜头从中景推到近景"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.invalid/assets/reference.png"
          }
        }
      ]
    }
  ],
  "orientation": "portrait"
}

对于音频和视频参考，推荐优先使用顶层 audio_refs、video_refs 字段。

6. 查询可用模型

响应中会包含本文档列出的 6 个公开模型：

{
  "object": "list",
  "data": [
    {
      "id": "sora3-vip5-480p",
      "object": "model",
      "owned_by": "service",
      "description": "Seedance 2.0 video model (480p, duration via request)"
    },
    {
      "id": "sora3-vip5-fast-480p",
      "object": "model",
      "owned_by": "service",
      "description": "Seedance 2.0 Fast video model (480p, duration via request)"
    }
  ]
}

7. 常见错误

参数错误

{
  "error": {
    "message": "prompt is required",
    "type": "invalid_request_error"
  }
}

模型不存在

{
  "error": {
    "message": "Invalid video model. Use /v1/models to get supported video models",
    "type": "invalid_request_error"
  }
}

参考素材数量超限

{
  "error": {
    "message": "reference images cannot exceed 9",
    "type": "invalid_request_error"
  }
}

常见 HTTP 状态码

状态码	说明
`200`	请求成功
`400`	参数错误，如模型名错误、时长越界、参考素材数量超限
`401`	API Key 无效或缺失
`404`	查询的任务不存在
`429`	额度不足或请求过多
`503`	服务繁忙、队列已满、排队等待超时或上游临时不可用

8. 接入注意事项

API Key 必须由服务商单独发放，不要写入前端代码或公开仓库。

不要使用内部模型名，只使用本文档列出的 6 个公开模型。

duration 只支持 4-15 秒，建议传整数。

分辨率由模型名决定，size 只建议用于表达横竖屏，不用于切换清晰度档位。

参考素材 URL 必须能被服务端访问，建议使用公网 HTTPS。

使用音频参考时限制更严格：图片最多 2 张，音频和视频合计最多 3 条。

推荐使用 /v1/videos 异步任务接口；如果客户网关容易超时，避免使用长时间非流式同步请求。

使用 /v1/chat/completions 时，长任务建议传 stream: true。

sora-3vip5视频生成对接文档

Sora3 VIP5 视频生成 API 对接文档

基础信息

可用模型

推荐流程

1. 创建视频任务

请求参数

素材引用规则

2. 请求示例

2.1 文生视频，标准版 720p，横屏 8 秒

2.2 文生视频，快速版 480p，竖屏 6 秒

2.3 图生视频，标准版 1080p，横屏 12 秒

2.4 多图参考，快速版 720p，横屏 15 秒

2.5 图片 + 视频参考，标准版 720p

2.6 图片 + 音频 + 视频参考，快速版 1080p

3. 创建任务响应

4. 查询视频任务

处理中响应

完成响应

失败响应

5. Chat Completions 兼容接口

5.1 非流式请求

5.2 流式请求

5.3 Chat 多模态格式

6. 查询可用模型

7. 常见错误

参数错误

模型不存在

参考素材数量超限

常见 HTTP 状态码

8. 接入注意事项

sora-3vip5视频生成对接文档

Sora3 VIP5 视频生成 API 对接文档#

基础信息#

可用模型#

推荐流程#

1. 创建视频任务#

请求参数#

素材引用规则#

2. 请求示例#

2.1 文生视频，标准版 720p，横屏 8 秒#

2.2 文生视频，快速版 480p，竖屏 6 秒#

2.3 图生视频，标准版 1080p，横屏 12 秒#

2.4 多图参考，快速版 720p，横屏 15 秒#

2.5 图片 + 视频参考，标准版 720p#

2.6 图片 + 音频 + 视频参考，快速版 1080p#

3. 创建任务响应#

4. 查询视频任务#

处理中响应#

完成响应#

失败响应#

5. Chat Completions 兼容接口#

5.1 非流式请求#

5.2 流式请求#

5.3 Chat 多模态格式#

6. 查询可用模型#

7. 常见错误#

参数错误#

模型不存在#

参考素材数量超限#

常见 HTTP 状态码#

8. 接入注意事项#

Sora3 VIP5 视频生成 API 对接文档

基础信息

可用模型

推荐流程

1. 创建视频任务

请求参数

素材引用规则

2. 请求示例

2.1 文生视频，标准版 720p，横屏 8 秒

2.2 文生视频，快速版 480p，竖屏 6 秒

2.3 图生视频，标准版 1080p，横屏 12 秒

2.4 多图参考，快速版 720p，横屏 15 秒

2.5 图片 + 视频参考，标准版 720p

2.6 图片 + 音频 + 视频参考，快速版 1080p

3. 创建任务响应

4. 查询视频任务

处理中响应

完成响应

失败响应

5. Chat Completions 兼容接口

5.1 非流式请求

5.2 流式请求

5.3 Chat 多模态格式

6. 查询可用模型

7. 常见错误

参数错误

模型不存在

参考素材数量超限

常见 HTTP 状态码

8. 接入注意事项