推荐流程
/v1/videos 是后续主推的 OpenAI / Sora 兼容视频入口。/v1/video/generations 属于 Tapapi 任务兼容入口,适合受控场景或供应商适配,不建议普通接入优先使用。请求字段
不同模型可能使用
duration、aspect_ratio、quality 等私有字段。不要把某个模型的私有字段直接复用到所有视频模型。
请求示例
X-Oneapi-Request-Id。它用于定位“提交请求”本身;后续查询任务时还要保存查询请求自己的 request id。
Prompt 建议
示例:
生产注意
- 文生视频耗时通常明显高于文本和图片接口
- 视频任务成本更高,先做小流量验证
- 不要用同步 HTTP 等待完整生成结果
- 保存
task_id,用它做轮询、对账和客服排障 - 任务成功后尽快转存输出视频
- 轮询时按最终
status决定是否补跑,不要因为一次查询超时就重复提交新任务 seconds、size、duration、aspect_ratio等字段是否可用以具体模型为准