苏姆卡皮首页 / 视频 API
视频 API
苏姆卡皮 · OpenAI 兼容 AI API 网关 · Base URL https://sub.sumcapi.top/v1
文生视频与图生视频统一成一套任务式接口，先对比能力再比较时长与分辨率，避免为换模型重写业务代码。
视频 API
能力范围
- 文生视频（Text-to-Video）：由提示词直接生成短视频片段，适合分镜预览与素材测试。
- 图生视频（Image-to-Video）：以参考图为首帧或主体，控制镜头运动与时长，一致性更好。
- 结果取回：任务式返回
task_id，轮询或回调获取成片地址。
接口形状
curl https://sub.sumcapi.top/v1/videos \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "视频模型名",
"prompt": "镜头缓慢推进，咖啡倒入白瓷杯，暖色台灯光，浅景深",
"seconds": 5,
"size": "1280x720"
}'任务式接口的推荐处理顺序：创建任务 → 保存 task_id 到业务库 → 轮询状态 → 成功后立刻下载转存到自己的存储。上游返回的临时地址通常有有效期。
选型顺序建议
- 先定能力：是否需要首帧一致性（选图生视频）、是否需要音频、是否需要多镜头。
- 再定规格：时长、分辨率、帧率三者共同决定成本，先用 5 秒草稿验证构图。
- 最后定风格：把运镜、光线、材质写成固定模板，只替换主体，批次风格才稳定。
成本与失败率
- 视频按秒计费，分辨率档位单价差异明显；草稿阶段用低档，定稿用高档。
- 生成失败常见于提示词包含品牌名、真实人物或受限内容，改写提示词比强行重试更省时。
- 建议为视频任务保留至少两个可用模型，路由在失败时自动兜底。