MiniMax H3-Image:画像生成APIで確認できること、重み公開と編集で未確認のこと
取得済みの公式文書から、テキスト画像生成のパラメータ、出力制限、再試行に伴う課金を整理します。公開日、重みのライセンス、参照画像を使った編集方法は、この資料だけでは確認できません。
·

minimax h3 image を調べる際は、モデルの発表、重みの公開、画像編集、APIの利用条件を分けて確認する必要があります。取得済みのMiniMax公式文書にはH3-Imageのテキスト画像生成APIが記載されていますが、重みの公開条件や編集機能、ローカル実行の要件まで裏づけるものではありません。
本稿が参照するのは、取得済みの公式Text-to-Image文書です。APIの動作検証は行っていません。資料の取得日は2026年11月16日で、ページの更新日は不明です。企画で挙げられた「11月11日発表」と重み公開の位置づけは、発表記事およびモデルカード本文との照合ができていないため、確定情報として扱いません。
テキスト画像生成で明記されている仕様
エンドポイントは POST https://api.minimax.io/v1/images/generations で、Bearer APIキーによる認証を使います。対応モデルは MiniMax-H3-Image と MiniMax-H3-Image-Highspeed。パラメータと制限は共通です。Highspeedという名称だけで、具体的な速度差や画質差を判断することはできません。
| 項目 | 文書にある仕様 | 利用時の注意点 |
|---|---|---|
| プロンプト | 必須。前後の空白を除き、最大32,000 Unicode文字 | プロンプト拡張を無効にすると、読み取られるのは先頭約4,096トークン。文字数上限とは別の制約 |
| 生成枚数 | n は1〜10、既定値は1 | 枚数、寸法、返却形式の組み合わせによっては無効になる |
| 幅と高さの指定 | 面積655,360〜20,000,000ピクセル、縦横比1:3〜3:1。境界値を含む | WIDTHxHEIGHT 指定時は aspect_ratio と area を併用できない。auto でも不可 |
| 面積区分 | area は 1K、2K、4K。既定値は 4K | 長辺の固定値ではなく、目標面積の区分 |
| 出力と返却 | PNG、JPEG、WebP。URLまたはBase64で返却 | ストリーミングはURLのみ。URLの永続的な利用は保証されない |
詳細は公式のパラメータ説明に記載されています。たとえば 2K と 16:9 の組み合わせは 2720×1536 と説明されています。実際の寸法は区分名から推測せず、各画像の data[].size で確認します。
Base64返却には、リクエスト全体の出力面積にも上限があります。PNGは20,000,000ピクセル、JPEG/WebPは80,000,000ピクセルです。n が10以下でも、それだけで有効なリクエストになるとは限りません。
タイムアウトと一部失敗は、実装上の重要な条件
公式文書では、サーバーの待機時間は最大600秒、クライアントのタイムアウトは少なくとも600秒とするよう案内されています。このエンドポイントは冪等ではありません。クライアント側でタイムアウトや切断が起きても生成は続き、成功した画像には課金されます。再試行すると、再び生成と課金が発生します。OpenAI SDKを使う場合は、既定の自動再試行を止めるため max_retries=0 を指定するとされています。
つまり、応答を受け取れなかったことと、サーバーが処理しなかったことは別です。タイムアウト直後の再送を、追加費用のない操作として扱うべきではありません。
HTTP 200も全画像の成功を意味しません。1枚以上成功すれば200が返る場合があり、失敗した項目には error だけが入ります。data[].error を画像ごとに確認する必要があります。課金対象は成功画像のみとされていますが、取得済み本文には実際の料金計算に必要な単価はありません。使用量のフィールドを料金表の代わりにはできません。
参照画像・編集・重み公開には別の裏づけが必要
取得済みのページはテキスト画像生成を扱っており、参照画像のアップロード、マスク編集、部分修正の手順は確認できません。これはモデルがそれらに非対応だという証明ではなく、この資料では利用方法を確定できないという意味です。
重みの公開についても、APIが使えることと重みをダウンロードできることは別です。重みを取得できても、商用利用が無条件に許可されるとは限りません。ローカル実行には実行コード、ハードウェア要件、精度設定の確認が必要で、APIの出力寸法から必要VRAMを推定することはできません。
完全な発表記事として仕上げるには、公式発表、モデルカード、ライセンス本文を読み、公開日、重みの提供方法、商用利用条件、実行要件を確認する必要があります。参照画像と編集には対応するAPI文書も必要です。現状の資料で進められるのはテキスト画像生成APIの導入検討までであり、ローカル実行や商用利用許諾、編集機能の提供を確定する段階ではありません。