マーケットサポート← アプリに戻る

MiniMax H3

MiniMax H3 モデルは統一された非同期ジョブ API で呼び出します。POST /api/generate でタスクを開始し、完了するまで GET /api/generate/{taskId} をポーリングします。このファミリーは 3 個のエンドポイントを提供します。

概要

すべてのエンドポイントは同じ外枠を共有し、変わるのは model と input フィールドだけです。モデルマーケットの playground から任意に実行できます。

認証

/api-keys で API キーを作成し、Bearer トークンとして送信します。ログイン中のブラウザからのリクエストはセッション cookie 経由でも動作します。

Authorization: Bearer <YOUR_API_KEY>

タスクの作成

POST
POST https://api.lithovas.com/api/generate

ボディ：{ "model": "<slug>", "input": { … } }

レスポンス：{ "taskId": "<id>", "state": "waiting" }

結果の照会

GET
GET https://api.lithovas.com/api/generate/<taskId>

レスポンス：{ "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

非同期
タスク作成の 200 は、タスクが受理されたことを意味するだけで、完了ではありません。state が success または fail になるまでこのエンドポイントをポーリングしてください。失敗したタスクは課金されません。

エンドポイント

モデルタスクmodel slug
MiniMax H3Text to Videominimax-h3/text-to-video
MiniMax H3Image to Videominimax-h3/image-to-video
MiniMax H3Video to Videominimax-h3/reference-to-video

MiniMax H3 · Text to Video

POSTText to Videominimax-h3/text-to-video
input フィールド
promptstring必須

Text prompt describing the desired video.

durationinteger任意

Output video duration in seconds.

aspect_ratioenum<string>任意

Output video aspect ratio.

resolutionenum<string>任意

Output video resolution tier currently exposed on the relay.

seedinteger任意

Random seed for reproducible generation.

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3/text-to-video",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "seed": 42
  }
}'

MiniMax H3 · Image to Video

POSTImage to Videominimax-h3/image-to-video
input フィールド
promptstring必須

Text prompt describing the desired motion and style.

image_urlsarray<string>必須

One or more input image URLs used to drive the video.

durationinteger任意

Output video duration in seconds.

aspect_ratioenum<string>任意

Output video aspect ratio.

resolutionenum<string>任意

Output video resolution tier currently exposed on the relay.

seedinteger任意

Random seed for reproducible generation.

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3/image-to-video",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "seed": 42
  }
}'

MiniMax H3 · Video to Video

POSTVideo to Videominimax-h3/reference-to-video
input フィールド
promptstring必須

Prompt describing the target video, style, motion, and atmosphere.

reference_imagearray<string>必須

Reference image URLs for subject and style consistency.

videos_listarray<string>任意

Optional reference video URLs for motion and camera guidance.

audios_listarray<string>任意

Optional reference audio URLs for voice, music, or ambience guidance.

durationinteger任意

Output video duration in seconds.

aspect_ratioenum<string>任意

Output video aspect ratio.

resolutionenum<string>任意

Output video resolution tier currently exposed on the relay.

seedinteger任意

Random seed for reproducible generation.

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3/reference-to-video",
  "input": {
    "prompt": "Restyle the source footage with richer lighting, cleaner motion, and a cinematic grade.",
    "reference_image": [
      "https://example.com/input.jpg"
    ],
    "videos_list": [
      "https://example.com/reference.mp4"
    ],
    "audios_list": [
      "https://example.com/reference.mp3"
    ],
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "seed": 42
  }
}'