Skip to main content
文生视频用于把文本描述转成短视频。当前按受控开放能力处理:只有控制台可见、价格已发布、模型文档明确支持的模型,才适合接入生产。

推荐流程

/v1/videos 是后续主推的 OpenAI / Sora 兼容视频入口。/v1/video/generations 属于 Tapapi 任务兼容入口,适合受控场景或供应商适配,不建议普通接入优先使用。

请求字段

不同模型可能使用 durationaspect_ratioquality 等私有字段。不要把某个模型的私有字段直接复用到所有视频模型。

请求示例

返回值会包含任务 ID 和初始状态,字段可能随兼容格式略有差异:
提交成功后请同时保存响应头 X-Oneapi-Request-Id。它用于定位“提交请求”本身;后续查询任务时还要保存查询请求自己的 request id。

Prompt 建议

示例:

生产注意

  • 文生视频耗时通常明显高于文本和图片接口
  • 视频任务成本更高,先做小流量验证
  • 不要用同步 HTTP 等待完整生成结果
  • 保存 task_id,用它做轮询、对账和客服排障
  • 任务成功后尽快转存输出视频
  • 轮询时按最终 status 决定是否补跑,不要因为一次查询超时就重复提交新任务
  • secondssizedurationaspect_ratio 等字段是否可用以具体模型为准
任务轮询和内容获取见 任务与输出