如何使用 Sora 2 文生视频 API：图生视频接入指南（2026）
Sora 2 文生视频 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。
Sora 2 文生视频 是一款图生视频模型（由 OpenAI 提供）：物理感知图生视频。 通过 3D 深度推断与身份锁定技术，让静态图片产生符合物理规律的逼真运动。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.400。
TL;DR
· 任务类型：图生视频，由 OpenAI 提供
· 价格：典型一次约 $0.400（$1 = 100 积分），按量计费无订阅
· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入
· 可调参数：3 个（见下方参数表）
· 无平台水印，商用可用（遵守服务条款）
用 Sora 2 文生视频 能做什么？
短视频与广告片段：从一句话或一张图直接产出可发布的动态素材。
产品演示与概念预览：低成本验证分镜和视觉方向，再决定是否实拍。
社媒内容工厂：批量生成竖屏短片，配合热点话题快速上线。
已有素材的二次创作：图生视频让静态作品动起来，延长内容生命周期。
怎么调用这个 API？
1. 在 NamiFusion 注册并在 API Keys 页面创建密钥（注册送免费积分）。
2. 用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
3. 用返回的 task_uuid 轮询任务状态，完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/openai/sora-2/image-to-video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"image": "https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/marketplace/thumbnails/2026-01-27/9d7ffa763411.jpeg",
"prompt": "Cinematic visual effects shot of a turbulent ocean storm. Massive waves crash against jagged black rocks, demonstrating physics-aware fluid dynamics with realistic foam and spray trajectories. The camera pans slowly to the right, revealing 3D depth between the foreground cliffs and the dark, churning horizon. Heavy atmospheric fog and lightning flashes in the distance. Audio: Roaring waves crashing, thunder rolling, and high-velocity wind.",
"duration": "4"
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"有哪些参数？
image（参考图片）：必填
prompt（动态提示词）：必填
duration（视频时长）：必填，默认 "4"
Sora 2 文生视频 的提示词怎么写？
1. 主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。
2. 用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
3. 迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。
4. 负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。
价格是多少？
按次积分计价，典型一次调用约 $0.400（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。
Sora 2 文生视频
物理引擎级动态模拟：高保真图像转视频，支持同步音频与身份锁定。
OpenAI Sora 2 (I2V) 能够将单张静态参考图转化为连贯、逼真的视频片段。基于 Sora 2 在物理模拟和 3D 深度推断方面的核心突破，该模型在合成可信运动的同时，能够完美保留原图的人物身份、光影和构图。它在处理惯性、重力、流体动力学等物理规律时表现出惊人的真实感。
🚀 核心亮点
- 物理感知运动 (Physics-Aware)：自然模拟接触、惯性以及毛发、布料的次级运动，动态效果符合物理直觉。
- 身份锁定 (Identity Lock-In)：严格锁定参考图中的人脸特征、纹理细节和场景布局，确保持续一致。
- 视差与深度推断：自动推断画面的 3D 结构，在运镜过程中实现令人信服的前景/背景分离效果（视差）。
- 音画同步：生成与画面动作节奏匹配的语音、环境音或音效。
- 强可控性 (Steerability)：对提示词指令反应灵敏。无论是调整运动幅度、镜头轨迹还是氛围，都能得到可预测的结果。
- 智能背景延展：在进行大幅度运镜（如摇摄或拉远）时，自动向外绘制合理的新背景细节。
🛠️ 技术参数
| 参数 | 说明 |
|---|---|
| 模型版本 | OpenAI Sora 2 I2V |
| 输入方式 | 单张参考图 (JPEG/PNG) + 文本提示词 |
| 支持时长 | 4秒、8秒、12秒 |
| 音频支持 | 同步生成 (可选) |
| 响应速度 | 极速 (无冷启动) |
关键参数：
image: 需要动态化的源图片。prompt: 描述情绪、运动风格或相机行为的文本指令。duration: 选择视频长度 (4s / 8s / 12s)。
💰 定价策略
线性计费模式：$0.10 / 秒
| 视频时长 | 总费用 |
|---|---|
| 4 秒 | $0.40 |
| 8 秒 | $0.80 |
| 12 秒 | $1.20 |
FAQ
可以先免费试用吗？+
注册即送积分，但赠送积分目前仅适用于应用内的部分换脸功能；本模型按量积分计费。Playground 仍可无代码试玩，提交前会显示准确报价。
生成内容可以商用吗？有水印吗？+
可以商用，NamiFusion 不给生成结果加平台水印；使用须遵守服务条款与适用法律。
内容政策是什么？+
NamiFusion 是无过滤引擎，不做武断限制、对 NSFW 友好，但禁止违法内容与非自愿的真人素材，详见服务条款。
Sora 2 文生视频 的任务要跑多久？+
取决于参数，图像通常数秒到数十秒，视频通常数十秒到几分钟；API 返回 task_uuid 供轮询。
分辨率/时长上限是多少？+
以模型参数表为准：每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。