视频生成 API
通过 宁享Token 的视频生成 API，你可以根据文本或图片生成短视频。我们支持业界主流的视频生成模型，提供原生与 OpenAI 兼容两种协议。
支持的供应商
| 供应商 | 模型 | 协议格式 | 说明 |
|---|---|---|---|
| 火山方舟 | doubao-seedance-2-0 / fast / mini / 2-5 | 原生 + OpenAI 兼容 | Seedance 2.0/2.5 系列，文生/图生视频 |
| 可灵 (Kling) | kling-3.0 / 3.0-omni（暂未开放）/ 3.0-turbo / o1 / 2.6 / 2.5-turbo / v2-new（已下架）/ v1（已下架） | 原生 + OpenAI 兼容 | 快手可灵，按秒计费，分辨率分档。⚠️ kling-v3 与 kling-image-o1 是官方图片模型 ID（见图像生成），不在视频面 |
| 阿里云 | happyhorse-1.0 / 1.1、wan2.7-t2v / i2v / r2v（均已下架/暂未开放） | OpenAI 兼容 | 欢乐马 + 万相 2.7 |
| 小米 | xiaomi/mimo-v2.5-pro | OpenAI 兼容 | 图生视频 |
| 其他 | image2video、advanced-lip-sync | OpenAI 兼容 | 图转视频、对口型 |
任务模型
视频生成均为异步任务：先通过 POST 提交任务获得 task_id，再通过 GET 轮询任务状态。详细接口请参考各模型说明页与 任务管理。
快速开始
python
import requests
# 提交文生视频任务
r = requests.post("/v1/video/generations", headers={
"Authorization": "Bearer <YOUR_API_KEY>",
}, json={
"model": "kling-3.0",
"prompt": "猫咪在草地上奔跑，阳光明媚",
}).json()
task_id = r["id"]
# 轮询
while True:
r = requests.get(f"/v1/video/generations/{task_id}", headers={
"Authorization": "Bearer <YOUR_API_KEY>",
}).json()
if r["status"] == "completed":
print(r["metadata"]["url"])
break
if r["status"] == "failed":
print("生成失败:", r.get("error"))
break如何选择模型
- 通用文生视频：kling-3.0、happyhorse-1.1-t2v、wan2.7-t2v（已下架/暂未开放）
- 图生视频：kling-3.0、seedance-2-0、wan2.7-i2v（已下架/暂未开放）
- 高清 / 4K 输出：kling-3.0 / kling-3.0-omni（暂未开放，配置已就绪）
- 快速生成 / 低成本：kling-2.5-turbo、doubao-seedance-2-0-mini
文档目录
计费
视频生成按模型分别采用按次 / 按秒档 / 按 token 计费（可灵系按秒档、Seedance 系按 token 等），以定价总表为准。所有费用以 CNY 结算。
常见问题
支持哪些输入格式？
- 文生视频：自然语言描述
- 图生视频：图片 URL 或 Base64 + 描述
视频输出格式？
默认为 MP4（H.264）。部分模型可返回原始帧序列。
生成失败是否收费？
按上游厂商官方返回的计费信息核算，与官方口径一致：官方未计费（返回的计费量为 0）→ 平台不计费、预扣额度自动退还；官方已计费（计费量大于 0）→ 维持计费（该次生成的算力已被上游消耗）。 「任务失败」本身不等于「不计费」，判据是厂商的计费结果 —— 详见错误码 · 任务失败会扣费吗。 成功但不满意不可退款。