Sora-2 视频生成使用指南

Sora-2 系列适合写实短视频、产品镜头和社媒素材。先读 视频生成总览 了解共通端点，再看本页模型细节。

接口地址 & 模型

• 创建任务：POST https://www.yuzhixiaolongxia.com/v1/videos
• 查询任务：GET https://www.yuzhixiaolongxia.com/v1/videos/{task_id}
• 下载视频：GET https://www.yuzhixiaolongxia.com/v1/videos/{task_id}/content
• API 模型 ID：sora-2 / sora-2-pro
• 令牌分组：sora-veo-grok-video

分组开通须知

视频模型属于受控分组 sora-veo-grok-video。创建令牌时如果看不到这个分组，联系 zhiyanck@gmail.com 开通。

模型选择

模型 ID	适合场景	常用 size	当前售价
sora-2	试稿、社媒短视频、日常素材	720x1280 / 1280x720	0.308 元/秒
sora-2-pro	高质量交付、广告短片、细节要求更高的镜头	720x1280 / 1280x720 / 1792x1024 / 1024x1792	0.308 元/秒，高规格尺寸会放大预扣

sora-2 用常规尺寸试稿；需要 1792x1024 或 1024x1792 时切到 sora-2-pro。生产流程建议先用 sora-2 跑通提示词，再用 sora-2-pro 出终稿。

参数表

参数	类型	必填	说明
model	string	是	sora-2 或 sora-2-pro
prompt	string	是	视频描述，建议写清主体、动作、镜头、风格
seconds	string/int	否	支持 4 / 8 / 12；生产接入建议显式传
duration	int	否	兼容字段；新接入优先用 seconds
size	string	否	720x1280 / 1280x720；sora-2-pro 还可用 1792x1024 / 1024x1792
image	string	否	单张参考图 URL/base64
images	string[]	否	多张参考图 URL/base64
input_reference	file/string	否	multipart 参考图文件，或兼容参考图字段

图生视频必须传图片字段

图生视频必须传 image、images 或 input_reference，prompt 里写 “use image 1” 只是引用图片顺序，不能代替传图。

文生视频示例

curl -X POST "https://www.yuzhixiaolongxia.com/v1/videos" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "Cinematic shot of a steaming bowl of crawfish on a rustic wooden table, red spices glistening, slow camera push in, realistic food commercial style",
    "seconds": "8",
    "size": "1280x720"
  }'

查询：

curl "https://www.yuzhixiaolongxia.com/v1/videos/task_xxx" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

下载：

curl -L "https://www.yuzhixiaolongxia.com/v1/videos/task_xxx/content" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  --output sora-result.mp4

图生视频示例

curl -X POST "https://www.yuzhixiaolongxia.com/v1/videos" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro",
    "prompt": "Use image 1 as the product reference. Camera slowly pushes in, soft top light, premium beverage commercial, realistic motion",
    "seconds": "8",
    "size": "1792x1024",
    "images": [
      "https://example.com/your-product.jpg"
    ]
  }'

本地文件用 multipart：

curl -X POST "https://www.yuzhixiaolongxia.com/v1/videos" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -F "model=sora-2-pro" \
  -F "prompt=Use the uploaded image as the product reference. Slow push in, studio light, realistic commercial video" \
  -F "seconds=8" \
  -F "size=1792x1024" \
  -F "input_reference=@product.jpg"

计费与对账

Sora-2 系列按秒估算，任务提交时预扣，任务失败后会回退预扣。

预扣金额 = 0.308 元/秒 × seconds × 尺寸系数

参数组合	4 秒	8 秒	12 秒
sora-2 常规尺寸	1.232 元	2.464 元	3.696 元
sora-2-pro 常规尺寸	1.232 元	2.464 元	3.696 元
sora-2-pro 1792x1024 / 1024x1792	约 2.053 元	约 4.107 元	约 6.160 元

最终扣费以控制台「调用日志」里的精确金额为准。

生产接入建议

• 先用 sora-2 + seconds=4 做提示词试稿，再放大到 8 或 12 秒。
• 需要高规格尺寸时再切 sora-2-pro，并把客户端超时和任务轮询总时长放宽。
• POST /v1/videos 返回 200 和任务 ID 只代表提交成功；必须轮询到 completed 后才算成片成功。
• sora-2-pro 排队时间可能更长，出现 failed 或 task timeout 时不要直接循环重提，先记录错误、等待退款，再降低尺寸或换 sora-2 重试。

常见错误

错误/现象	原因	处理
invalid_size	sora-2 传了高规格尺寸，或 size 写错	sora-2 只用 720x1280 / 1280x720；高规格切 sora-2-pro
prompt is required	没传 prompt	补 prompt
图生视频不像参考图	没传图片字段，或 prompt 没引用	传 images/input_reference，prompt 写 use image 1
401	令牌错误或复制不完整	重新创建令牌
403 quota_exceeded	余额不足	充值后重试
任务长时间 queued	队列等待	不要重复提交，等 3-5 分钟再看
task timeout	高规格任务等待过久	等退款后降低 seconds / size，或先用 sora-2 出片

提示词模板

[主体] + [动作] + [镜头运动] + [光线] + [风格] + [画面比例]

示例：

A steaming bowl of red crawfish on a wooden table, steam rising, slow camera push in, soft warm top light, shallow depth of field, realistic food commercial, vertical 9:16 composition.

上一步：视频生成总览　|　下一步：Veo 3.1 视频生成使用指南