Skip to main content
POST
Video Generation

授权

Authorization
string
header
必填

HTTP: Bearer Auth

  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key,用于验证账户信息,可在 账户管理>接口密钥 中查看。

请求头

Content-Type
enum<string>
默认值:application/json
必填

请求体的媒介类型,请设置为 application/json 确保请求数据的格式为 JSON.

可用选项:
application/json

请求体

application/json
model
enum<string>
必填

模型名称。可用值: S2V-01.

可用选项:
S2V-01
subject_reference
object[]
必填

主体参考,仅当 modelS2V-01 时可用。目前仅支持单个主体

prompt
string

视频的文本描述,最大 2000 字符.

prompt_optimizer
boolean

是否自动优化 prompt,默认为 true。设为 false 可进行更精确的控制

callback_url
string

接收任务状态更新通知的回调 URL。支持通过 callback_url 参数可以配置回调,以接收任务状态的更新的异步通知。

地址验证:配置后,MiniMax 服务器会向 callback_url 发送一个 POST 请求,请求体中包含 challenge 字段。服务端需要在 3 秒内原样返回该 challenge 值以完成验证 状态更新:验证成功后,每当任务状态变更时,MiniMax 都会向该 URL 推送最新的任务状态。推送的数据结构与调用查询视频生成任务接口的响应体一致

回调返回的"status"包括以下状态:

  • "processing" - 生成中
  • "success" - 成功
  • "failed" - 失败
aigc_watermark
boolean

是否在生成的视频中添加水印,默认为 false

响应

200 - application/json
task_id
string

视频生成任务的 ID,用于后续查询任务状态

base_resp
object