首页 / 模型指南 / Sora 2

30 秒结论

• 它擅长什么：OpenAI 视频生成模型，支持文生视频与图生视频，走 /v1/videos 一个端点即可开始。
• 怎么接：把 OpenAI SDK 的 base_url 改成 https://sub.sumcapi.top/v1，api_key 换成苏姆卡皮密钥，模型名填 Sora 2。
• 注意什么：视频生成 以控制台与模型广场实时展示为准；生产链路请配置超时、退避与兜底模型。

接口与关键参数

鉴权统一使用 Authorization: Bearer <API_KEY>。任务式接口先取回任务 ID，再轮询或回调获取结果

请求示例

cURL

# 创建任务：任务式返回，先取 id
curl https://sub.sumcapi.top/v1/videos \
  -H "Authorization: Bearer $SUMCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Sora 2",
    "prompt": "镜头缓慢推进，咖啡倒入白瓷杯，暖色台灯光，浅景深",
    "seconds": 5,
    "size": "1280x720"
  }'

# 轮询结果：3–5 秒一次，并为单个任务设置总超时
curl https://sub.sumcapi.top/v1/videos/<task_id> -H "Authorization: Bearer $SUMCAPI_KEY"

Python（OpenAI SDK）

import requests

base, key = "https://sub.sumcapi.top/v1", "sk-你的密钥"
h = {"Authorization": "Bearer " + key}
task = requests.post(base + "/videos", headers=h, json={
    "model": "Sora 2",
    "prompt": "镜头环绕产品旋转一周，纯色背景，柔光",
    "seconds": 5,
}).json()
print(task)   # 取 id 后轮询 /videos/<id>

响应要点

• 结果地址有有效期，落库前先下载转存。
• 建议记录请求 ID：排查问题与计费争议都需要它。
• 同名模型可能由不同渠道提供，输出风格会有细微差异，切模型前做一轮回归。

常见错误与处理

计费口径

• 按 秒 或按 任务 计费：时长、分辨率、帧率三个因子共同决定成本。
• 草稿阶段用低档 + 短时长验证构图，定稿再上高档。
• 创建失败、或返回失败状态且无成片的任务不计费；上游临时地址有有效期，请及时转存。
• 批量投放建议保留至少两个可用视频模型便于兜底，见 视频 API。

适用场景

• 短视频素材：5 秒草稿批量测试构图与节奏，跑通后再出高清成片。
• 分镜预览：给团队或客户看镜头语言，比文字描述省沟通成本。
• 商品动态展示：图生视频保持主体一致性，适合单品旋转与使用场景。
• 广告 A/B：同一脚本换不同运镜与光线，快速产出多版本。

选型建议

广告短片、分镜预览。同一能力建议同时配置 2 个以上候选模型，网关会在限流与过载时自动切换，见 路由与错误。

接入三步

1. 在控制台创建密钥并绑定包含该模型的分组；
2. 用上面的示例跑通一次最小请求，确认 model 返回模型名；
3. 把 model 做成配置项，在 模型广场 对照可用清单，逐步迁移业务链路。

相关模型（视频生成）

想看全部能力入口，见 模型指南 与 能力与场景。

常见问题