MiniMax-H3-nsfw API

使用精确模型 ID MiniMax-H3-nsfw。请求中的模型名必须与本页完全一致。

示例输出MiniMax-H3-nsfwPOST /v1/videos5.2s

请求参数：duration=5resolution=2Kratio=16:9输入图片

提示词：One continuous take, no cuts. Keep the woman, the white bikini, the tortoiseshell glasses, the striped towel and the poolside exactly as in the first frame. She pushes up off her forearms and turns slowly onto her side and then square to the lens, settling back on one hip; as she comes round she runs one hand back through her damp hair and lets it fall over one shoulder, then faces the camera front on, chin slightly up, still looking over the top of her glasses with a relaxed smile. The camera holds its low close position and eases back a little as she turns, keeping her framed from shoulders to hips. Warm midday sun stays from the left, bright bounce off the pale deck. Real weight and inertia, natural hair and fabric movement, no text.

该示例为刻意选取的温和素材，不代表该模型 ID 的内容尺度上限。

生成该示例的请求（输入媒体地址已替换）

{
  "model": "MiniMax-H3-nsfw",
  "prompt": "One continuous take, no cuts. Keep the woman, the white bikini, the tortoiseshell glasses, the striped towel and the poolside exactly as in the first frame. She pushes up off her forearms and turns slowly onto her side and then square to the lens, settling back on one hip; as she comes round she runs one hand back through her damp hair and lets it fall over one shoulder, then faces the camera front on, chin slightly up, still looking over the top of her glasses with a relaxed smile. The camera holds its low close position and eases back a little as she turns, keeping her framed from shoulders to hips. Warm midday sun stays from the left, bright bounce off the pale deck. Real weight and inertia, natural hair and fabric movement, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "2K",
  "ratio": "16:9",
  "aspect_ratio": "16:9",
  "image": "https://example.com/input-image.png"
}

认证与入口

使用 Modelflare API Key，通过 https://modelflare.dev/v1 发送请求。网关入口为 POST /v1/videos。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

创建任务

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3-nsfw",
    "content": [{"type": "text", "text": "一只白猫在雨夜霓虹街道上奔跑，电影感跟拍"}],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

任务查询与下载

提交成功后保存任务 ID。使用 GET /v1/videos/{task_id} 轮询，完成后使用 GET /v1/videos/{task_id}/content 下载；结果地址可能过期，应及时转存。

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

请求要点

MiniMax-H3 使用 content[]，以 resolution、duration 和 ratio 控制输出。

请求参数

MiniMax-H3 使用 content[] 多模态数组，创建任务后通过 MiniMax 查询路径轮询。first_frame / last_frame 与 reference_* 是不同工作流。

字段	必填	说明
model	是	MiniMax-H3-nsfw
content[]	是	恰好一个 text，可附带 first_frame、last_frame、reference_image、reference_video 或 reference_audio
resolution	是	768P / 2K
duration	是	4–15 秒
ratio	条件	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
content[].role	条件	图生视频使用 first_frame / last_frame；参考视频使用 reference_*；不要混用两组角色
content[].url	否	必须是可公开访问的 HTTP/HTTPS URL；不支持 Base64
aigc_watermark	否	是否添加水印
callback_url	否	任务状态回调地址

输入与输出限制

输出分辨率为 768P 或 2K，时长 4–15 秒。纯文字请求需要具体 ratio；图生视频最多一个首帧和一个尾帧，参考工作流至少包含参考图片或视频，音频不能单独使用；两组角色不能混用。

官方工作流示例

MiniMax-H3 的媒体 URL 必须公开可访问且不使用 Base64；首尾帧工作流与 reference 工作流不能混用。

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3-nsfw",
    "content": [
      {"type": "text", "text": "让图像主体沿视频动作自然移动"},
      {"type": "reference_image", "role": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "role": "reference_video", "url": "https://example.com/motion.mp4"}
    ],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

错误与失败任务

参数不符合模型契约时，创建接口会返回带 request ID 的 4xx。异步任务也可能在创建成功后进入 failed；轮询响应中的 error_code 和 error_message 才是该任务的最终原因。不要把同一请求改成另一种 JSON 结构重试。

支持范围

本页只覆盖 Modelflare 的模型生成/编辑调用。搜索或地图增强、声音管理、元素库管理等资源型接口不属于本页的公开调用范围，也不需要作为模型请求字段传入。

价格与计费

本模型按视频秒计费。请查看模型价格页查看当前销售价、参考原价和完整规格。

注意

本页只说明 Modelflare 的公开接口；可用字段和限制以本页当前版本为准。

变体

模型 ID	差异
MiniMax-H3-nsfw	本页说明的模型。
MiniMax-H3	基础模型。入口、请求结构和计费单位与本页相同，只需替换模型 ID；详见该模型页，价格与可用性见价格页。