Sora 2 视频生成 API 指南

Sora 2 概述

Sora 2 是 OpenAI 的视频生成模型，通过 Ruxa AI 提供。支持文生视频、图生视频和角色动画功能。

可用模型

模型	分辨率	时长
`sora-2`	1280x720, 720x1280	10秒, 15秒
`sora-2-hd`	1792x1024, 1024x1792, 1280x720, 720x1280	10秒, 15秒, 25秒

基础文生视频

从文本提示生成视频：

curl --request POST \
  --url https://api.ruxa.ai/api/v1/tasks/create \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "input": {
      "prompt": "金毛犬在阳光明媚的草地上奔跑，慢动作，电影级画质",
      "seconds": "10",
      "size": "1280x720"
    }
  }'

图生视频

将参考图像动画化：

curl --request POST \
  --url https://api.ruxa.ai/api/v1/tasks/create \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "input": {
      "prompt": "图中的人开始向前走",
      "input_reference": "https://example.com/your-image.jpg",
      "seconds": "10",
      "size": "1280x720"
    }
  }'

角色动画

创建可复用的角色，用于一致的视频生成：

curl --request POST \
  --url https://api.ruxa.ai/api/v1/tasks/create \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "input": {
      "prompt": "角色挥手打招呼",
      "character_url": "https://example.com/character-video.mp4",
      "character_timestamps": "1,3",
      "character_create": true,
      "seconds": "10"
    }
  }'

注意： 角色视频中不能出现真人。

风格选项

为视频应用视觉风格：

风格	描述
`winter`	冬天/雪景风格
`comic`	漫画风格
`news`	新闻播报风格

{
  "model": "sora-2",
  "input": {
    "prompt": "一只猫在玩毛线球",
    "style": "comic",
    "seconds": "10"
  }
}

参数参考

参数	类型	必填	描述
`prompt`	string	是	视频描述
`seconds`	string	否	时长："10"、"15"、"25"（仅HD）
`size`	string	否	分辨率（见上表）
`input_reference`	file/url	否	图生视频的参考图像
`watermark`	boolean	否	添加水印（默认：false）
`private`	boolean	否	隐藏视频（默认：false）
`style`	string	否	视觉风格
`character_url`	string	否	创建角色的视频 URL
`character_timestamps`	string	否	角色出现范围 "start,end"（1-3秒）
`character_create`	boolean	否	从结果自动创建角色
`character_from_task`	string	否	使用已有任务的角色

查询任务状态

curl --request GET \
  --url 'https://api.ruxa.ai/api/v1/tasks/query/{taskId}' \
  --header 'Authorization: Bearer sk-xxxxxx'

提示词技巧

获得最佳效果：

具体描述 - 描述镜头运动、光线和氛围
使用电影术语 - "推镜头"、"跟踪镜头"、"特写"
匹配复杂度与时长 - 更长的视频可以处理更复杂的场景
包含风格描述 - "电影级"、"慢动作"、"专业"

示例提示词：

"日落时分海浪拍打岩石悬崖的电影镜头，黄金时段光线，慢动作，航拍无人机视角，专业电影画质"

响应状态码

状态码	描述
200	成功
401	未授权
402	积分不足
422	验证错误
429	速率限制
500	服务器错误
501	生成失败

Sora 2 概述

可用模型

基础文生视频

图生视频

角色动画

风格选项

参数参考

查询任务状态

提示词技巧

响应状态码

了解更多

作者

分类

目录

更多文章

Ruxa AI API 集成最佳实践

Ruxa AI API 入门指南

Nano Banana 图像生成 API 指南

邮件列表