创建视频生成任务
视频生成为异步任务:提交任务 → 轮询状态 → 获取结果。本页介绍通用任务格式的创建端点,文生 / 图生 / 首尾帧 / 多参考图 / 视频生视频等输入模式调用同一端点(见下方输入素材与生成模式)。可用模型与价格以 模型广场 实时显示为准。
除通用任务格式外,还支持可灵、即梦、豆包 / Seedance、Sora 等格式——前三者与厂商官方端点结构一致(豆包复用本端点),面向已有对应厂商 API 代码的用户。MiniMax-H3 同样复用本端点,但渠道参数有硬性差异(分辨率只支持 768p / 2K,文生视频必填画幅),见 MiniMax 格式。
端点
POST /v1/video/generations
认证
请求头携带 Bearer 令牌(令牌获取见接入地址与鉴权):
请求体
网关(new-api rc.25)只接受上表字段。width、height、fps、seed、n、response_format、user 等字段传入后会被静默丢弃——不报错、也不生效:画幅请用 size + mode 控制,时长请用 duration。注意渠道差异:豆包(Seedance)渠道的时长要用 seconds(顶层 duration 在该渠道不生效),画幅与分辨率走 metadata,详见豆包 / Seedance 格式。各模型实际支持的取值(时长档位、分辨率等)以模型广场模型详情和实际响应为准。
输入素材与生成模式
同一端点按传入的素材字段自动分流生成模式:
素材约束:图片 png / jpg / jpeg / webp,视频 mp4 / mov / webm,音频 mp3 / wav;URL 必须公网可直达(优先境内 CDN / OSS,境外图床可能被上游拦截);传多个素材时在 prompt 中说明各素材的用途。
素材字段全部经 metadata 整体透传上游,网关不校验取值;顶层传 first_frame_url 等字段会被静默丢弃。各模型支持的输入模式不同(豆包 / 可灵 / MiniMax-H3 等渠道差异见各自格式页),以模型广场模型详情与渠道报错为准。
请求示例
以下场景 3 ~ 5 以 MiniMax-H3 为例(该渠道 metadata.resolution / ratio 为必填,见 MiniMax 格式);其余模型替换 model 并按各自渠道要求传参。
响应
提交成功返回任务对象,记住 task_id 用于查询:
请求校验失败(如 prompt 为空、duration 超出范围)返回 400 与错误说明:
计费按任务完成时的实际用量结算(失败自动退还)。提交后轮询任务状态,见获取视频生成任务状态。
