Skip to main content
POST
创建视频生成任务
通用视频生成接口采用异步任务模式:你先调用创建接口获得 task_id,再通过查询接口轮询任务状态,任务成功后从响应中获取视频地址。

功能特性

  • 统一协议接入多个视频模型,通过 model 指定平台模型标识
  • 支持文生视频、图生视频(首帧 / 尾帧 / 参考图 / 参考视频 / 参考音频)
  • 支持负向提示词、分辨率、宽高比、时长、水印与随机种子等生成参数
  • 媒体输入支持公网 URL 与 base64 data URI
  • 支持 callback_url 结果回调(仅 seedance 渠道生效;为空时由网关注入默认回调)

认证方式

在请求头中携带 Authorization 字段,格式为 Bearer YOUR_API_KEY

支持的视频模型

模型广场中可用的视频模型,请参考 模型列表

快速示例

创建成功后返回任务 ID:

下一步

请求头

Authorization
string
必填

API Key token (Bearer sk-xxx)

Content-Type
string

请求体

application/json
model
string
必填

平台模型标识

negative_prompt
string

负向提示词

generate_audio
boolean

是否生成音频,部分模型不支持

callback_url
string

结果回调地址(仅 seedance 渠道生效;空则由网关注入默认回调)

prompt
string

文本提示词

medias
object[]

参考媒体输入列表(首帧/尾帧/参考图/参考视频/参考音频;URL 或 base64 data URI)

duration
integer

生成时长(秒)

resolution
string

分辨率档位,如 480p/720p/1080p/4k(视模型支持情况)

ratio
string

宽高比,如 16:9/9:16/1:1/adaptive

watermark
boolean

是否带水印

seed
integer<int64>

随机种子

响应

200 - application/json

通用视频生成任务创建响应

task_id
string

任务ID(客户端凭此查询)

status
string

任务状态:queued / running