方法 1
EvoLink API で連携
用途：プロダクトのバックエンド、一括処理、自動化ワークフロー
サーバーから EvoLink の統合画像 API を呼び出し、モデル ID、パラメータ、キュー、callback、結果保存を制御します。
- 1実際のブリーフを Playground で試し、品質とコストを確認
- 2コンソールで EvoLink API キーを作成
- 3上のルートカードからタスクに合うモデル ID を選択
- 4タスクを送信し、ポーリングまたは HTTPS callback で結果を取得
MiniMax H3 Image API
EvoLinkのMiniMax H3 Image APIで、テキストからの画像生成と最大16枚の参照画像による編集を利用できます。1K・2K・4K出力とトークン費用を確認し、1つのAPIキーでアプリに導入できます。
MiniMax画像生成利用可能
画像出力 1K トークンあたり $0.0038 から
テキストから画像生成画像編集マルチ参照入力ピクセル指定サイズプロンプト最適化バッチ生成
本番ルート公開中
モデルの特長
最大 20 MP の出力、柔軟なサイズ指定、プロンプト最適化を内蔵
ユースケース
高解像度のマーケティングビジュアル、複数の参照画像を使った編集、バッチでのバリエーション生成
入力
テキストプロンプト（参照画像は任意、最大 16 枚）
出力
1 リクエストで最大 10 枚、JPEG・PNG・WebP
API を組み込む前に MiniMax H3 Image を試す
本格的に組み込む前に、MiniMax H3 Image の出力品質を確認し、1 リクエストのトークンコストを見積もり、サンプルを生成できます。
画像タスクを作成
使用モデル minimax-h3-image画像の生成と編集に対応。最終料金は実際のトークン使用量で決まります。
参照画像
参照画像はリクエストの入力トークン数に加算されます。
0/16 ファイル
サイズ
アスペクト比はプロンプトと参照画像からモデルが決めます。ピクセル面積は解像度で決まります。
解像度
目標ピクセル面積：1K 約 1.05 MP、2K 約 4.19 MP、4K 約 16.78 MP。1K と 2K の画像出力料金は同じで、4K は出力トークンが約 4 倍になります。
料金目安 ~$0.0261.7503 クレジット
auto @ 2K · プロンプト最適化: オン · 参照画像: 0 · 枚数: 1
最終料金は実際のトークン使用量に基づきます。
準備完了
生成された画像はここに表示されます。
履歴
生成結果は24時間保存されます。必要なものはお早めにダウンロードしてください。
画像生成タスクはここに表示されます。
MiniMax H3 Image APIの料金と画像1枚あたりのコスト
テキストからの生成、参照画像による編集、4K出力の見積もりを比較できます。画像出力、参照画像入力、テキスト入力はそれぞれ別のトークン単価で計算され、最終料金は実際の使用量に基づきます。
初回テスト費用
MiniMax H3 Image - 2K - 1:1 - 1 枚 - プロンプト最適化オフクレジット~1.0855
1 枚生成、プロンプト最適化オフ、参照画像なし
概算費用~$0.016
$10 分のクレジットで約 598 回テストできます。
Playground でこの見積もりを再現するには、サイズで比率 1:1、解像度で 2K を選び、プロンプト最適化をオフにして、参照画像なしでプロンプト「Cat」から 1 枚生成します。プロンプトが長い場合や、プロンプト最適化・参照画像を使う場合は入力コストが増えます。最終料金は実際の使用量で決まります。
MiniMax H3 Image のテスト予算ガイド
想定するテスト回数に合わせて金額を選んでください。$10
約 598 回のテスト
初回検証向け。
$50
約 3132 回のテスト
プロンプト改善向け。
$100
約 6264 回のテスト
本番導入前のテスト向け。
MiniMax H3 Image のコスト例
テキストから画像生成（最適化オン）2K - 1 枚 - プロンプト最適化オン
~$0.026/枚
~1.7109 cr/枚テキストから画像生成（最適化オフ）2K - 1 枚 - プロンプト最適化オフ
~$0.016/枚
~1.0853 cr/枚4K でテキストから画像生成4K - 1 枚 - プロンプト最適化オン
~$0.074/枚
~4.9668 cr/枚参照画像を使った編集2K - 1 枚 - 参照画像 1 枚
~$0.041/枚
~2.7615 cr/枚各見積もりは現在の単価で画像 1 枚を生成する場合の目安で、プロンプト本文のトークンは含みません。最終料金は実際のトークン使用量で決まります。
MiniMax H3 Image の料金
単価は 1K トークンあたりです。計算機はリクエスト全体を見積もり、最終料金は実際の使用量で決まります。
MiniMax H3 Imageトークン課金
minimax-h3-image1 枚あたりの固定料金はありません。費用は出力サイズ、プロンプト最適化、参照画像、生成枚数で決まります。
| 項目 | 課金の対象 | 単価 |
|---|---|---|
| 画像出力 | 生成画像 1 枚ごとのトークン：1K・2K は約 4,200、4K は約 16,800。2K を超えるピクセル指定は 幅 × 高さ ÷ 1,024 で数えます。 | $0.0038/1K tokens0.2584 cr/1K tokens |
| 画像入力 | 編集時の参照画像：参照画像 1 枚につき約 10,300 トークン。生成画像 1 枚ごとに 1 回ずつ数えます。 | $0.0015/1K tokens0.102 cr/1K tokens |
| テキスト入力 | プロンプト本文に加え、プロンプト最適化がオンのときは生成画像 1 枚ごとに約 4,000 トークン。 | $0.0023/1K tokens0.1564 cr/1K tokens |
画像出力
生成画像 1 枚ごとのトークン：1K・2K は約 4,200、4K は約 16,800。2K を超えるピクセル指定は 幅 × 高さ ÷ 1,024 で数えます。
$0.0038/1K tokens0.2584 cr/1K tokens
画像入力
編集時の参照画像：参照画像 1 枚につき約 10,300 トークン。生成画像 1 枚ごとに 1 回ずつ数えます。
$0.0015/1K tokens0.102 cr/1K tokens
テキスト入力
プロンプト本文に加え、プロンプト最適化がオンのときは生成画像 1 枚ごとに約 4,000 トークン。
$0.0023/1K tokens0.1564 cr/1K tokens
EVOLINK · 料金見積もりminimax-h3-image
× 1 · リアルタイムこれは送信時に仮押さえされる見積もり額です。最終料金は実際のトークン使用量で決まります。
料金の見積もり
~$0.0261.7109 cr
$10 あたり
≈ 379 枚
自動 · 2K · プロンプト最適化: オン
トークン数（1 枚あたり × 枚数）
画像出力4,200 × 1 = 4,200
画像入力0 × 1 = 0
テキスト入力4,000 × 1 = 4,000
サイズ
アスペクト比はプロンプトと参照画像からモデルが決めます。この場合も、出力の面積は解像度で決まります。
解像度
生成枚数
1
参照画像
0
プロンプト最適化
size が auto のとき、またはリクエストに参照画像があるときは、プロンプト最適化は常にオンです。
プロンプト
0 / 32,000 文字
課金に関する注意
- 1Kと2Kは画像出力トークン数が同じため、画像出力部分の料金は同じです。リクエストの合計にはテキストと参照画像の入力料金も含まれます。
- 4K の画像出力トークンは 2K の約 4 倍です。
- テキスト入力と参照画像の入力は生成画像 1 枚ごとに 1 回ずつ課金されるため、見積もり全体が生成枚数（n）に比例します。
- 表示される金額は送信時に仮押さえされる見積もり額です。最終料金はタスクの実際の使用量で決まり、差額は返金または追加請求されます。
- 失敗したタスクは全額返金されます。リクエストした画像の一部だけが成功した場合は、納品された画像の分だけ課金されます。
MiniMax H3 Image APIでできること
MiniMax H3 ImageはMiniMaxの画像生成・編集モデルです。EvoLinkの統一APIから、商品シーン、キャンペーン素材、コンセプト探索に利用でき、最大16枚の参照画像と1枚あたり最大2000万画素に対応します。本番で使う前に、制作要件に沿って結果を確認してください。
モデル ID は minimax-h3-image の 1 つだけで、2 つのモードに対応します。プロンプトを送ればテキストから画像を生成し、image_urls を加えれば参照画像を使った編集になります。リクエストは非同期タスクとして実行され、トークン単位で課金されます。
モード: テキストからの画像生成と画像編集 · 課金: トークン課金：画像出力、参照画像の入力、テキスト入力 · 結果の受け取り: 非同期タスク。結果リンクの有効期間は 24 時間
入力
テキストプロンプト + 参照画像（最大 16 枚）
出力
1〜10 枚 · JPEG / PNG / WebP
サイズ
自動 / 比率 / ピクセル指定、最大 20 MP
解像度
1K / 2K / 4K（デフォルト 2K）
モデル ID
minimax-h3-image
MiniMax H3 Image のモデル ID とモード
MiniMax H3 Image
minimax-h3-imagePOST /v1/images/generations で、テキストからの画像生成と画像編集を 1 つのモデル ID で扱います。プロンプトを送れば生成、image_urls に 1〜16 枚の参照画像を加えれば編集です。レスポンスで返るのは完成画像ではなくタスク ID です。
MiniMax H3 Image の機能と設定項目
MiniMax H3 Image のテキストからの画像生成
最大 32,000 文字のプロンプトを送ると、1〜10 枚の画像が返ります。size を auto のままにすると、モデルがプロンプトからアスペクト比を決めます。
MiniMax H3 Image の参照画像を使った編集
image_urls に 1〜16 件の画像 URL を追加し、プロンプトで変更内容を説明します。プロンプト内では各画像を「image 1」「image 2」のように指定します。編集も同じモデル ID で処理され、参照画像 1 枚ごとに画像入力トークンが加算されます。
MiniMax H3 Image のサイズ指定：auto、比率、ピクセル指定
auto ではモデルがアスペクト比を選びます。比率 X:Y は 1〜300 の整数で指定し、1:3〜3:1 の範囲に収める必要があります。ピクセル指定 WxH は合計 655,360〜20,000,000 ピクセルで、拡大縮小や丸めは行われません。
MiniMax H3 Image の解像度ティア：1K、2K、4K
resolutionはautoまたは縦横比指定時の出力面積を決め、既定値は2Kです。ピクセル数を直接指定した場合は無視されます。1Kと2Kの画像出力料金は同じで、4Kは約4倍の出力トークンを使います。合計にはテキストと参照画像の入力料金も加わります。
MiniMax H3 Image のプロンプト最適化
デフォルトでオンです。モデルがプロンプトを詳細な内容に書き直し、実際に使われたプロンプトを画像ごとに返します。オフにできるのは、比率またはピクセル指定でテキストから画像を生成する場合だけです。サイズが auto のときや参照画像があるときは、常にオンになります。
MiniMax H3 Image の n によるバッチ生成
n を 1〜10 に設定すると、1 回のリクエストで複数の画像を生成できます。テキスト入力と参照画像の入力は生成画像 1 枚ごとに 1 回ずつ課金されるため、費用は n に比例します。
MiniMax H3 Image の主要リクエストパラメータ
POST /v1/images/generations の出力とコストを左右するフィールドです。生成は非同期のため、返されるタスク ID をポーリングするかコールバックを利用してください。画像リンクの有効期間は 24 時間なので、結果は早めに保存してください。完全なスキーマとコード例は API タブにあります。
| パラメータ | 型 | 役割 |
|---|---|---|
| model | string · 必須 | 常に 'minimax-h3-image' を指定します。テキストからの画像生成と画像編集で同じ ID を使います。 |
| prompt | string · 必須 | 生成したい内容、または参照画像の編集方法。最大 32,000 文字。prompt_extend がオフの場合、有効なのは先頭の約 4,096 トークンまでです。 |
| size | string · デフォルト auto | 'auto'、比率 X:Y（1〜300 の整数、1:3〜3:1 の範囲）、または合計 655,360〜20,000,000 ピクセルのピクセル指定 WxH。範囲外の値は 400 を返し、拡大縮小や丸めは行われません。 |
| resolution | string · 1K / 2K / 4K | auto と比率指定のときの出力面積。デフォルトは 2K。ピクセル指定では無視されます。1K と 2K は画像出力トークン数が同じで、4K は約 4 倍です。 |
| prompt_extend | boolean · デフォルト true | プロンプト最適化。false を指定できるのは、比率またはピクセル指定でテキストから画像を生成する場合だけです。size が auto のとき、または image_urls があるときは 400 を返します。 |
| n | integer · 1–10 | 1 リクエストあたりの生成枚数。デフォルトは 1。テキスト入力と参照画像の入力は生成画像 1 枚ごとに 1 回ずつ課金されます。 |
| image_urls | array · 最大 16 枚 | 編集用の参照画像。形式は jpg、jpeg、png、webp、heic、heif。各辺 128〜8192 px、長辺は短辺の 4 倍まで、1 枚あたり最大 64 MB。1 枚ごとに画像入力トークンが加算されます。 |
| output_format | string · jpeg / png / webp | 結果のファイル形式。デフォルトは jpeg。透明背景には対応していません。 |
| callback_url | string · 任意 | タスク結果を受け取る HTTPS の webhook。ポーリングの代わりに使えます。 |
MiniMax H3 Image を使う 2 つの方法：EvoLink API または Agent
プロダクトへの組み込みや一括処理には EvoLink API、素早い制作・開発には Codex、Claude、Gemini からの Agent 呼び出しを利用できます。どちらも同じ API キー、残高、モデルルート、タスク履歴を共有します。
方法 2
Agent から呼び出す
用途：Codex、Claude、Gemini での制作・開発タスク
生成目的、素材、合格条件を Agent に渡すと、ルート選択、リクエスト作成、タスク追跡、結果取得まで任せられます。各手順を自分で実装する必要はありません。
- 1EVOLINK_API_KEY をローカル環境変数に設定し、コードや Prompt には書かない
- 2出力目的、参照素材、主要パラメータを説明
- 3Agent に MiniMax H3 Image のルートを呼ばせ、task ID を保存
- 4最終状態まで確認し、結果をダウンロードして失敗理由を報告させる
MiniMax H3 Image でできること
商品シーンとキャンペーン素材
キャンペーンのキービジュアル、バナー、商品シーンを 4K ティアで生成できます。掲載枠に決まったサイズが必要な場合は、最大約 20 MP までのピクセル指定も使えます。
商品・場面・スタイルの参照画像を使った編集
商品写真、背景、スタイル見本など、最大 16 枚の参照画像を 1 回のリクエストで組み合わせられます。それぞれを image 1、image 2 のように呼んで、使い方をモデルに指示します。
複数候補を生成して比較
n を使って同じプロンプトから最大 10 枚をリクエストし、作り込む価値のあるものを選びます。一部の画像がブロックされても、タスクは残りの画像を返し、その分だけ課金されます。
ピクセル寸法が固定された画像
スライド背景用の 1920x1080 のように、決まった枠に収める必要がある場合は WxH を指定します。許容範囲内のサイズは、拡大縮小も丸めもなく指定どおりに生成されます。
複数の掲載形式に合わせた素材
1 つのプロンプトを 1:1、4:5、16:9、9:16 などの比率で使い回せば、フィード、ストーリー、バナーの各掲載枠をカバーできます。1:3〜3:1 の範囲なら任意の整数比も指定できます。
短い制作要件を詳しいプロンプトへ
1 行のアイデアから始めて、プロンプト最適化に内容を膨らませてもらえます。実際に使われたプロンプトが画像ごとに返るので、確認し、編集して再利用できます。
MiniMax H3 Image API のコード例とエラー処理
最短の実行フローとして、タスクを作成し、返された task ID を保存して、ポーリングまたは HTTPS callback を待つ方法を示します。全パラメータとレスポンスは API タブで確認できます。
cURL
curl -X POST https://api.evolink.ai/v1/images/generations \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "A colorful sunset over the ocean, painterly style",
"size": "16:9",
"resolution": "2K",
"n": 1,
"callback_url": "https://your-domain.com/webhooks/image-task-completed"
}'
# Save the returned task ID, then query:
curl https://api.evolink.ai/v1/tasks/{task_id} \
-H "Authorization: Bearer $EVOLINK_API_KEY"このリクエストではプロンプト最適化をオフにできません
size が auto のとき、または image_urls があるときに prompt_extend: false を指定すると 400 が返ります。テキストからの画像生成では比率かピクセル指定を使うか、プロンプト最適化をオンのままにしてください。リクエストは課金が発生する前に拒否されます。
サイズが範囲外です
ピクセル指定は合計 655,360〜20,000,000 ピクセルである必要があります。また、どのサイズも 1:3〜3:1 の範囲に収め、比率の各項は 1〜300 にしてください。範囲外のサイズは 400 を返し、自動で拡大縮小や丸めが行われることはありません。
参照画像が多すぎる、または非対応です
image_urls の URL が 16 件を超えると 400 が返ります。また、各画像は jpg、jpeg、png、webp、heic、heif のいずれかで、各辺 128〜8192 px、長辺と短辺の比は 4:1 まで、サイズは 64 MB 以下である必要があります。
パラメータ検証エラー
上のパラメータカードと照らし合わせて、値の範囲、許可されるオプション、素材数、ファイル形式が選択したルートの要件を満たすか確認してください。
認証または残高の問題
Authorization Bearer Token を確認し、コンソールで残高とタスク課金を確認してください。
コンテンツまたは素材が拒否された
肖像権、ブランド素材、判読可能な文字、センシティブな内容、入力素材の適法性を確認してください。
タスク失敗またはタイムアウト
最終状態が失敗となった MiniMax H3 Image タスクは課金されません。task ID を保存し、検証・審査・実行のどこで失敗したか確認してから再試行してください。
Callback を受信できない
callback_url には公開 HTTPS URL が必要です。localhost やプライベートネットワークは使えません。ポーリング用に task ID も保存してください。
MiniMax H3 Image と EvoLink の他の画像モデルの比較
| 項目 | MiniMax H3 Image | GPT Image 2.6 Flare | Nano Banana 2.1 | Seedream 5.0 Pro | Grok Imagine Image 2.0 |
|---|---|---|---|---|---|
| 課金 | トークン課金：画像出力、画像入力、テキスト入力 | トークン課金 | 解像度別の 1 枚単位。参照画像と検索は別項目 | 出力ティア別の 1 枚単位。入力画像も 1 枚ごとに課金 | 品質と解像度別の 1 枚単位 |
| 出力解像度 | 1K / 2K / 4K、または最大 20 MP のピクセル指定 | 1K / 2K / 4K | 1K / 2K / 4K | 1K / 1.5K / 2K | 1K / 2K |
| サイズ指定 | auto、1:3〜3:1 の任意の比率、またはピクセル指定 | auto、15 種類の比率、またはピクセル指定 | auto または 14 種類の比率 | auto、比率、またはピクセル指定 | auto または 13 種類の比率プリセット |
| 参照画像 | 最大 16 枚 | 最大 16 枚 | 最大 14 枚 | 最大 10 枚 | 最大 3 枚 |
課金
MiniMax H3 Imageトークン課金：画像出力、画像入力、テキスト入力
GPT Image 2.6 Flareトークン課金
Nano Banana 2.1解像度別の 1 枚単位。参照画像と検索は別項目
Seedream 5.0 Pro出力ティア別の 1 枚単位。入力画像も 1 枚ごとに課金
Grok Imagine Image 2.0品質と解像度別の 1 枚単位
出力解像度
MiniMax H3 Image1K / 2K / 4K、または最大 20 MP のピクセル指定
GPT Image 2.6 Flare1K / 2K / 4K
Nano Banana 2.11K / 2K / 4K
Seedream 5.0 Pro1K / 1.5K / 2K
Grok Imagine Image 2.01K / 2K
サイズ指定
MiniMax H3 Imageauto、1:3〜3:1 の任意の比率、またはピクセル指定
GPT Image 2.6 Flareauto、15 種類の比率、またはピクセル指定
Nano Banana 2.1auto または 14 種類の比率
Seedream 5.0 Proauto、比率、またはピクセル指定
Grok Imagine Image 2.0auto または 13 種類の比率プリセット
参照画像
MiniMax H3 Image最大 16 枚
GPT Image 2.6 Flare最大 16 枚
Nano Banana 2.1最大 14 枚
Seedream 5.0 Pro最大 10 枚
Grok Imagine Image 2.0最大 3 枚
MiniMax H3 Image 組み込みの要点
エンドポイントもモデル ID も 1 つ
model に minimax-h3-image を指定して POST /v1/images/generations を送信します。テキストからの画像生成も編集も同じルートを使い、image_urls を加えるとリクエストが編集になります。
非同期タスクのライフサイクル
作成リクエストはタスク ID を返します。タスクが completed または failed になるまで GET /v1/tasks/{task_id} をポーリングするか、HTTPS の callback_url を渡します。結果リンクの有効期間は 24 時間なので、必要なファイルは保存してください。
トークン課金
単価は 3 種類です。画像出力、参照画像の入力、そしてプロンプトとプロンプト最適化を含むテキスト入力です。タスク開始時に見積もり額が仮押さえされ、最終料金は実際の使用量で決まります。失敗したタスクは全額返金されます。
EvoLink 経由で MiniMax H3 Image を使う理由
生成前にコストを見積もれる
Playground と料金計算機は、サイズ、解像度、プロンプト最適化の設定、参照画像、n からリクエストの費用を見積もります。この見積もり額はタスク開始時に仮押さえされ、最終料金はモデルが報告する使用量で決まります。
実際の使用量が見積もりより少ない、または多い場合は、差額が返金または追加請求されます。そのため、各タスクの記録にはリクエストが実際に使った分が残ります。
生成も編集も 1 つのモデル ID
minimax-h3-image は、テキストからの画像生成と参照画像を使った編集を同じエンドポイントで処理します。テキストだけのプロトタイプから編集ワークフローへ移るときも、リクエストに image_urls を加えるだけで、別のルートやモデル ID を組み込む必要はありません。
1 つの API キーで画像・動画・音声・LLM モデルまで
minimax-h3-image を呼び出す API キーで、MiniMax の動画モデル、Nano Banana 2.1 や Seedream 5.0 Pro などの他の画像モデル、EvoLink 上のテキストモデルも呼び出せます。残高もタスク履歴も 1 つです。
画像の制作では、パイプラインを 1 か所にまとめられます。ここで静止画を生成して動画モデルの開始フレームに使ったり、同じ要件を別の画像モデルで試したりするのに、新しいアカウントを開く必要はありません。
監査できるタスクステータス
すべてのタスクは pending、processing、completed、failed のいずれかを返し、失敗したタスクは全額返金されます。リクエストした画像の一部だけが成功した場合、タスクはその画像で完了し、その分だけ課金されます。
タスクをポーリングするかコールバックを使って最終状態を確認し、タスク ID を保管しておけば、各課金をリクエストと照合できます。
MiniMax モデルファミリー
EvoLink で使える MiniMax の動画モデルです。MiniMax H3 Image と同じアカウントと API キーで利用できます。
MiniMax H3 Max Turbo
MiniMax の動画モデル。5〜15 秒のテキストから動画と、開始フレームからの動画生成（終了フレームは任意）に対応。480p または 768p。
APIを見る
MiniMax H3 Max
MiniMax の動画モデル。テキストから動画、開始フレームからの画像から動画、画像・動画・音声を入力できる参照ルートに対応。480p または 768p、5〜15 秒。
APIを見る
MiniMax H3 Image 以外の EvoLink の画像モデル
MiniMax H3 Image APIのよくある質問
MiniMax H3 Image API のモデル ID は何ですか？
モデル ID は minimax-h3-image で、すべて小文字、ハイフン区切りです。テキストからの画像生成でも画像編集でも、POST /v1/images/generations の model に指定します。minimax-h3-image-to-video は MiniMax H3 の動画ルートで、これとは別のモデルです。
MiniMax H3 Image はどのように課金されますか？
トークン単位で、単価は 3 種類あります。画像出力、参照画像の入力、そしてプロンプトとプロンプト最適化を含むテキスト入力です。タスク開始時に見積もり額が仮押さえされ、最終料金はモデルが報告する使用量で決まり、差額は返金または追加請求されます。テキスト入力と参照画像の入力は生成画像 1 枚ごとに 1 回ずつ数えるため、費用は n に比例します。現在の単価はこのページの料金セクションにあります。
MiniMax H3 Imageの1Kと2Kで画像出力料金が同じなのはなぜですか？
両方とも画像1枚あたりの出力トークン数が同じため、画像出力料金は同じです。合計にはプロンプト処理と参照画像の入力料金も含まれます。4Kは約4倍の画像出力トークンを使います。2K面積を超えるピクセル数の直接指定では、出力トークンを幅 × 高さ ÷ 1024で計算します。
プロンプト最適化はどんなときにオフにできますか？
prompt_extend はデフォルトでオンです。false にできるのは、比率またはピクセル指定でテキストから画像を生成する場合だけです。size が auto のとき、または image_urls があるときに false を指定すると、課金が発生する前に 400 エラーで拒否されます。アスペクト比の自動決定と編集は、どちらも最適化のステップに依存しているためです。オフにした場合、プロンプトのうち有効なのは先頭の約 4,096 トークンまでです。
画像サイズの上限はどれくらいですか？ピクセルを自由に指定できますか？
出力は最大 20,000,000 ピクセル（約 20 MP）です。ピクセルを指定するには、size に WxH を渡します。合計 655,360〜20,000,000 ピクセル、アスペクト比 1:3〜3:1 の範囲で指定でき、16 の倍数である必要はなく、サイズが拡大縮小されたり丸められたりすることもありません。auto または比率指定の場合は、resolution で 1K、2K、4K を選びます。たとえば 16:9 は 2K で 2720×1536、4K で 5472×3072 になります。
参照画像は何枚まで送れますか？どんな制限がありますか？
image_urls に 1 リクエストあたり最大 16 枚です。対応形式は jpg、jpeg、png、webp、heic、heif で、各辺は 128〜8192 px、長辺は短辺の 4 倍まで、1 ファイルあたり最大 64 MB です。プロンプトでは image 1、image 2 のように指定します。編集内容はプロンプトで説明する方式で、マスクを使ったインペインティングと透明背景には対応していません。
リクエストした画像の一部が失敗した場合はどうなりますか？
複数枚のうち 1 枚がコンテンツ安全チェックでブロックされた場合などでも、タスクは成功した画像で完了し、その画像の分だけ課金されます。そのため、結果の枚数が n より少なくなることがあります。タスク全体が失敗した場合は全額返金されます。
結果はどうやって受け取りますか？リンクの有効期間は？
生成は非同期です。作成リクエストがタスク ID を返すので、ステータスが completed になるまで GET /v1/tasks/{task_id} をポーリングするか、callback_url を設定して HTTPS エンドポイントで結果を受け取ります。結果リンクの有効期間は 24 時間なので、残したい画像はダウンロードして保存してください。
MiniMax H3 Imageの4K出力は常に幅4096ピクセルですか？
4Kは4096 × 4096ピクセルを目標とする出力面積の区分で、幅が固定されるわけではありません。寸法は縦横比によって変わり、文書の16:9の例は5472 × 3072です。EvoLinkではautoまたは縦横比指定の既定値は2Kで、ピクセル寸法を直接指定すると解像度区分より優先されます。
MiniMax H3 Image APIとH3の画像から動画生成は同じですか？
いいえ。minimax-h3-imageは静止画の生成と参照画像による編集に対応します。minimax-h3-image-to-videoは動画を生成する別ルートで、入力と課金も別です。MiniMax直接APIのモデル名や既定値も異なる場合があるため、このページに記載したEvoLinkのモデルIDとリクエスト設定を使用してください。