跳转到主要内容
POST
统一视频生成接口

统一视频生成接口

这是面向多供应商的视频任务入口。请求先进入统一任务协议,再由分发层选择实际渠道执行。
  • 一个入口同时支持文生视频和图生视频。
  • 异步处理模式,提交成功后返回公开视频任务 ID。
  • 支持通过 metadata 透传供应商专有参数。
  • 可与 /v1/video/generations/{task_id}/v1/videos/{task_id} 组成完整任务链路。

方法与路径

请求示例

响应示例

认证

Body

model
string
必填
计费和分发使用的模型名,例如 kling-v1sora-2veo-3。最终是否可用取决于当前 Token 所属分组和渠道配置。
prompt
string
文本提示词。纯文生视频时通常必填;如果只做基于图片的轻改动,仍建议提供明确描述。
image
string
图生视频输入图片 URL 或 Base64。与 imagesinput_reference 一起表示存在视觉参考输入。
images
array<string>
多图参考输入。常用于兼容需要多参考图的上游。
input_reference
string | array<string>
额外参考素材。部分上游会把它当作首帧、参考图或素材集合。
duration
integer
目标时长,单位为秒。部分渠道也接受 seconds,若两者同时提供,具体优先级由适配器决定。
seconds
string
OpenAI 视频兼容风格的时长字段。常见值如 51015
size
string
尺寸或比例提示,例如 1280x720720x128016:9。是否识别由具体渠道决定。
metadata
object
供应商专有扩展参数,例如 stylenegative_promptcamera_controlaspectRatioquality

Response

id
string
平台公开任务 ID。后续可直接用于查询和代理下载。
task_id
string
兼容旧接口保留的任务 ID 字段,通常与 id 相同。
object
string
固定为 video
status
string
提交后的初始状态,常见值为 queuedin_progress
progress
integer
任务进度百分比。刚提交时通常为 0

使用场景

文生视频

图生视频

注意事项

这个路由是统一任务入口,不保证所有渠道都接受同一组参数。未在适配器中识别的字段可能被忽略,也可能只对某些模型生效。

相关接口