Image link valid for 72 hours
MiniMax H3 Image API 料金
隠れた費用のない透明な料金体系。使った分だけお支払い。
| モデル | プラン | ゴールド価格現在の価格 | プラチナ価格 | ダイヤモンド価格 | 公式価格 | 割引率 |
|---|---|---|---|---|---|---|
minimax-h3-image表示価格は概算です。実際の料金はトークン使用量に基づきます。 | 1K/2K | 0.1891Credits/枚~$0.0189/枚 | 0.1797Credits/枚~$0.018/枚 | 0.1702Credits/枚~$0.017/枚 | 0.2364Credits/枚~$0.0236/枚 | 20% |
| 4K | 0.628Credits/枚~$0.0628/枚 | 0.5966Credits/枚~$0.0597/枚 | 0.5652Credits/枚~$0.0565/枚 | 0.785Credits/枚~$0.0785/枚 | 20% |
* 実際の費用は最終出力に基づきます。
* トークン課金です。表は 1 枚のテキストから画像生成の見積もりで、画像出力とプロンプト拡張の約 2,000 テキスト入力トークンを含みます。参照画像には画像入力トークンが加算されます。実際の請求額は各タスクの cost フィールドで確認できます。
MiniMax H3 Image API：最大 4K のテキストから画像生成と画像編集
プロンプトから画像を生成するか、最大 16 枚の参照画像を使って編集します。1K、2K、4K から選び、アスペクト比は 1:3 から 3:1 の範囲で自由に指定できます。最大 2,000 万ピクセルまでのピクセル数を直接指定することもできます。1 回のリクエストで最大 10 枚を返し、内蔵のプロンプト拡張が短いプロンプトを自動で詳しく書き広げます。
MiniMax H3 Image API の使用例：テキストから画像と画像編集
APIMart では 1 回の POST リクエストで MiniMax H3 Image を呼び出せます。生成は非同期です。タスクを送信し、タスクのエンドポイントをポーリングして画像 URL を取得します。
- 1
MiniMax H3 Image API リクエストの認証
APIMart のキーを環境変数 APIMART_API_KEY に保存し、すべてのリクエストで Authorization: Bearer <key> として送ります。
- 2
MiniMax H3 Image タスクを送信
model minimax-h3-image、プロンプト、size、resolution を指定して POST /v1/images/generations を呼び出します。参照画像で編集する場合は image_urls を追加します。タスク ID は data[0].task_id にあります。
- 3
生成した画像を取得
status が completed になるまで GET /v1/tasks/{task_id} を 3〜5 秒ごとにポーリングし、data.result.images[0].url から画像 URL を読み取ります。結果は 72 時間保存されるため、早めにダウンロードしてください。
すべてのパラメータ、サイズのルール、レスポンスのフィールドはMiniMax H3 Image API ドキュメントをご覧ください。
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "夕暮れの海辺にある居心地のよいカフェ、フォトリアルな描写、暖かい色調",
"size": "16:9",
"resolution": "2K"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "minimax-h3-image",
"prompt": "夕暮れの海辺にある居心地のよいカフェ、フォトリアルな描写、暖かい色調",
"size": "16:9",
"resolution": "2K"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "2 枚目の画像のジャケットを 1 枚目の画像の人物に着せ、背景は変えないでください",
"image_urls": [
"https://example.com/person.jpg",
"https://example.com/jacket.png"
],
"resolution": "2K"
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"MiniMax H3 Image API のパラメータ
| パラメータ | 型 | 必須 | 既定値 | 説明 |
|---|---|---|---|---|
model | string | 必須 | 既定値: minimax-h3-image | minimax-h3-image を指定します。 |
prompt | string | 必須 | 既定値: — | 画像の説明。前後の空白を除いて 1〜32,000 文字です。 |
size | string | 任意 | 既定値: auto | auto、16:9 のようなアスペクト比（1:3 から 3:1）、または 2048x1152 のようなピクセル数（合計 655,360〜20,000,000 ピクセル）。 |
aspect_ratio | string | 任意 | 既定値: — | アスペクト比を渡すもう 1 つの方法です（例：16:9）。指定すると size より優先されます。 |
resolution | string | 任意 | 既定値: 4K | 1K、2K、4K のいずれか。size をピクセル数で指定した場合は使えません。 |
n | integer | 任意 | 既定値: 1 | 画像の枚数。1 から 10 まで。 |
image_urls | string[] | 任意 | 既定値: — | 最大 16 枚の参照画像。URL または Base64 data URI で指定します。追加すると編集に切り替わります。 |
prompt_optimizer | boolean | 任意 | 既定値: true | 生成の前にプロンプトを書き広げます。false が有効なのは、サイズを明示したテキストから画像の生成だけです。 |
output_format | string | 任意 | 既定値: jpeg | jpeg、png、webp のいずれか。 |
output_compression | integer | 任意 | 既定値: 95 | 圧縮品質。0 から 100 まで。png では無視されます。 |
watermark | boolean | 任意 | 既定値: false | AI 生成であることを示す可視の透かしを画像に入れます。 |
