Skip to content

文生视频

接口概览

  • 接口路径:POST /task/minimax/v1/video_generation
  • 业务分类:视频模型(Video)/海螺视频
  • 认证方式:Bearer Token
  • 服务地址:https://api.gpt.ge

请求参数

请求体(application/json):

  • model(string,必填):模型名称,可选:MiniMax-Hailuo-2.3MiniMax-Hailuo-02T2V-01-DirectorT2V-01
  • prompt(string,必填):视频文本描述,最长 2000 字符。对于 MiniMax-Hailuo-2.3MiniMax-Hailuo-02*-Director 系列,支持在 prompt 中使用方括号指令进行运镜控制(例如 [推进][上升][固定] 等),可组合或顺序使用以控制镜头。
  • prompt_optimizer(boolean,可选,默认 true):是否自动优化 prompt,设为 false 可获得更精确控制。
  • fast_pretreatment(boolean,可选,默认 false):是否缩短 prompt_optimizer 的优化耗时(仅对部分模型生效)。
  • duration(integer,必填):视频时长(秒),支持 610,默认 6;可用值与模型/分辨率有关。
  • resolution(string,必填):视频分辨率,具体可用选项视模型而定(示例:720P768P1080P)。
  • callback_url(string,可选):任务状态回调地址。配置后服务器会先发送带 challenge 的验证请求,验证通过后会在任务状态变更时推送与查询接口一致的结果,回调 status 可能为 processingsuccessfailed

请求示例

bash
curl -X POST "https://api.gpt.ge/task/minimax/v1/video_generation" \
  -H "Authorization: Bearer $YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"MiniMax-Hailuo-02",
    "prompt":"女子拿起一本书[上升],然后阅读[固定]。",
    "duration":6,
    "resolution":"1080P"
  }'

成功响应示例

json
{
  "task_id": "106916112212032",
  "base_resp": {"status_code": 0, "status_msg": "success"}
}

返回字段说明

  • task_id(string):任务 ID,用于后续查询任务结果。
  • base_resp.status_code(integer):内部状态码,0 表示成功。
  • base_resp.status_msg(string):简要结果说明。

说明

  • 请务必传入 modelpromptdurationresolution 等必填字段。
  • 如需接收异步回调,请确保 callback_url 能正确响应验证请求(返回 challenge)。