MiniMax 视频接口

接口说明

兼容 New API Hailuo 插件

New API 的 Hailuo Video 插件可以直接接入本站。接口地址填写 https://y.junlistudio.com（不加 /v1 或 /v2），密钥使用本站 API Key。model 填写本站模型目录或 /v1/models 返回的实际模型 ID，例如 minimax-h3-optimized。v1、v2 均使用本站模型配置，查询结果保留本站模型 ID。

Hailuo Video 1.2.0 使用本站模型 ID 时会选择 v1 接口，可用于文生视频、首尾帧和主体参考。多模态 content[] 可直接请求本站 v2 接口；该版本插件仅为名称 MiniMax-H3 自动选择 v2，经它使用 v2 需调整插件的接口选择逻辑，model 仍填写本站模型 ID。

POST/v1/video_generationv1 创建：prompt、first_frame_image、last_frame_image、subject_reference

GET/v1/query/video_generation?task_id=TASK_IDv1 查询：Queueing / Processing / Success / Fail；成功返回 file_id

GET/v1/files/retrieve?file_id=FILE_ID文件信息，返回 file.download_url

GET/v1/files/download?file_id=FILE_ID携带 API Key 下载 MP4，也支持 HEAD

POST/v2/video_generationH3 创建：content[]、duration、resolution、ratio

GET/v2/query/video_generation/TASK_IDH3 查询：task.status；成功结果位于 task.content.url

curl 'https://y.junlistudio.com/v2/video_generation' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "minimax-h3-optimized",
  "content": [
    {
      "type": "text",
      "text": "海浪轻拍沙滩，镜头缓慢推进"
    }
  ],
  "duration": 6,
  "resolution": "768P",
  "ratio": "16:9"
}'

创建返回 {"task_id":"任务ID"}。v2 查询状态为 queued / running / succeeded / failed，成功后直接下载 task.content.url，保留完整查询参数。v1 返回 base_resp.status_code，0 表示成功。查询与文件信息需要 Bearer API Key；结果链接自带临时凭证，最长有效 24 小时，过期后查询返回失败。

H3 优化版支持 4–15 整数秒、768P；720P 按原有兼容规则对应 768P。接口兼容不会增加模型能力，480P、2K 或未启用的 Hailuo 模型仍会被拒绝。v1 默认 6 秒，v2 默认 5 秒；分辨率省略时使用模型默认档位。

v2 的 content[] 支持 text、image_url、video_url、audio_url。图片 role 为 first_frame、last_frame 或 reference_image，视频和音频分别为 reference_video、reference_audio；首尾帧与素材参考互斥。图像参考支持公网地址、Data URI 或 Base64；视频、音频遵循模型素材限制。adaptive 根据第一张参考图选择最接近的支持比例；纯视频参考请显式填写 ratio。尾帧需要首帧，纯音频参考不支持。

可传 Idempotency-Key 防止重复创建和扣费。失败沿用本站退款和积分流水规则。暂不支持 callback_url、水印、提示词优化或快速预处理；对应布尔选项可省略或设为 false，开启时会明确报错。未测量的输入时长和 token 用量不会伪造返回。