概要
MAI-Image 2.6 は、Microsoft AIの自社開発による画像生成モデルであり、2026年9月4日にリリースされ、Microsoft Foundryでパブリックプレビューとして利用可能です。リリース時点で、Arenaにおいてテキスト画像生成と画像編集の両部門で第2位、Artificial Analysisにおいて画像編集部門で第1位を獲得しました(Microsoftの発表による、2026年9月4日時点)。 APIYI では、Microsoftの公式チャネルを通じて2つのバリアントを提供しています。どちらも同じエンドポイントとパラメータを共有しています:MAI-Image-2.6: 品質と精度を追求して調整されたフラッグシップモデルMAI-Image-2.6-Flash: 高速バリアント。MicrosoftによるとGPT-Image-2-Mediumより2.8倍高速に生成でき、高スループットな本番環境のワークロードに適しています
width + height による自由なキャンバス設定(最大1536×1536の面積まで対応)、そしてサイズに関わらない画像1枚あたりの定額課金。1024×1024の画像生成にかかる時間は、Flash で約17秒、2.6 で約30秒です。テキスト画像生成API
画像編集API
AIエージェントに統合を任せる
このpromptをコピーしてCodex / Claude Code / Cursorに貼り付けてください
エージェントはまずこのページのプレーンテキスト版を取得し(任意のドキュメントURLに.mdを追加)、その後お使いのスタックに応じたコードを記述します。タイムアウト、400を返す3つのパラメータ、sizeの代わりのwidth/height、ファイルアップロード限定の編集など、よくある落とし穴が明記されています。
このプロジェクトにMicrosoft MAI-Image 2.6のText-to-Imageおよび画像編集を統合(またはデバッグ)してください。
コードを書く前にドキュメントを読んでください:このページのプレーンテキスト版として https://docs.apiyi.com/en/api-capabilities/mai-image/overview.md を取得してください。詳細なパラメータについては、Text-to-Imageおよび画像編集のページにも同様に
.mdを追加して取得してください。
- モデル名:フラッグシップの
MAI-Image-2.6、高速版のMAI-Image-2.6-Flash。モデル名は大文字と小文字を区別します。すべて小文字の名前を指定すると503が返され、これは一見…
要件は合計11項目あります。以下のボタンを使用して完全なpromptをコピーしてください。
このpromptが防ぐ落とし穴
このpromptが防ぐ落とし穴
APIYIでMAI-Image 2.6を利用する理由
Microsoft公式チャネル
/v1/images/generationsおよび/v1/images/editsエンドポイントに対応しており、レスポンスの形式はOpenAI Images APIと同様です。画像単位の料金体系
どこからでもアクセス可能
api.apiyi.comにアクセスでき、1つのキーですべてのモデルを利用できます。充実したモデルラインナップ
主な機能
中国語テキストのレンダリング
高精度な編集
カスタムキャンバス
width + heightの組み合わせに対応し、長辺は最大3072(例:3072×768のバナー)、総面積の上限は1536×1536です。2つの速度ティア
サンプル結果
中国語テキストのレンダリング(MAI-Image-2.6-Flash、APIYIへの来訪者を歓迎する中国語の看板を指定したprompt):看板、提灯、対聯、黒板のすべてにおいて判読可能な中国語が表示されています。

MAI-Image-2.6-Flash、指示:「ティーポットを濃いコバルトブルーの釉薬に変更し、その他はすべて同じに保つ」):左が元画像、右が結果です。ティーポットの色のみが変更され、寸法ラベルやその他のオブジェクトは変更されていません。

料金
- サイズに関わらず1画像あたり: 768×768と1536×1536は同額であり、promptの長さは価格に影響しません。
- 画像編集はText-to-Imageと同額: 出力画像数に応じて課金され、参照画像が1枚でも5枚でも同額です。編集エンドポイントでの
n=2は2画像分として課金されます。 - 400エラーで失敗したリクエスト(モデレーションまたは無効なパラメータ)では画像は生成されません。
- レスポンス内の
usageフィールドと照合しないでください:prompt_tokensは常に1000 × 画像数のプレースホルダーです。コンソールの課金情報が正式な情報となります。 - チャージボーナスキャンペーンと併用可能です。
グループと Tokens
このシリーズは**Default グループ**に属しています。新規作成されたすべての token で呼び出すことができ、申請は不要です。
Pay-as-you-go Priority と Per-request の両方をご利用いただけます。プラットフォーム上の token 課金モデルでも同じ token を利用できるよう、Pay-as-you-go Priority を推奨します。レート: 単一キーは 50 RPM 未満に抑えてください。大規模なバッチワークロードの場合は、事前にサポートまでお問い合わせください。技術仕様
エンドポイント
主要パラメータ
width および height(出力サイズ)
n(画像枚数)
- テキストから画像生成:
nは効果がありません。2、4、または10を指定して送信しても1枚の画像のみが返されます(課金も1枚分)。さらに必要な場合は並列リクエストを送信してください。 - 編集:
nは機能します。n=2は2枚の画像を返し、2枚分として課金されます。
ベストプラクティス
ユースケースに応じてバリアントを選択する
MAI-Image-2.6-Flash。ヒーローポスター、複雑な構図、または高い品質基準が求められる場合 → MAI-Image-2.6。パラメータは同一であるため、切り替えはモデル名を変更するだけです。描画したいテキストを引用符で囲む
編集時は「その他はすべてそのまま変更しない」と指定する
キャンバスを変更すると画像が再構成される
width / height を渡すと、モデルはクロップ(切り抜き)やパディングを行うのではなく、シーンを再レイアウトします。部分的な編集の場合はサイズ指定を省略すると、出力は16の倍数にスナップされた元の比率に従います(例: 1344×756の入力 → 1360×768の出力)。複数の画像が必要な場合は並行リクエストを送信する
エラーコードとリトライ
429 のみであり、指数バックオフを用いて最大3回まで試行してください。クライアント側のタイムアウトによって中断されたリクエストも課金対象となる点に留意し、まずはタイムアウト値を長めに設定してください。FAQ
response_format を送信すると 400 が返されるのはなぜですか?
response_format を送信すると 400 が返されるのはなぜですか?
b64_json のみを返し、response_format パラメーターは受け付けません。"b64_json" を指定しても 400 Invalid parameters: response_format が返されます。gpt-image や DALL·E から移行したコードでは明示的に設定されていることがよくあります。これを削除してください。画像は引き続き data[0].b64_json に含まれます。seed や negative_prompt についても同様です。size: 1536x1024 を渡したのに、結果が正方形のままなのはなぜですか?
size: 1536x1024 を渡したのに、結果が正方形のままなのはなぜですか?
size を読み取りません。サイレントに無視され、デフォルトの 1024×1024 でレンダリングされます。代わりに "width": 1536, "height": 1024 を使用してください。画像編集エンドポイントでは size が機能しますが、一貫性を保つため両方で width + height を使用してください。画像の URL を使用して編集できますか?
画像の URL を使用して編集できますか?
multipart/form-data ファイルのアップロードのみを受け付けます。URL、データ URI、または base64 文字列を image として渡すと 400 が返されます。URL しかない場合は、まずサーバー側でダウンロードしてからアップロードしてください。画像合成のために複数の参照画像を送信できますか?
画像合成のために複数の参照画像を送信できますか?
- 方法:
image[]フィールドを繰り返します(curl -F "image[][email protected]" -F "image[][email protected]")。OpenAI SDK を使用する場合は、リストclient.images.edit(image=[f1, f2])を渡します - 画像の参照方法: アップロード順に image 1、image 2、… と番号が付けられます(例:「image 2 のキツネを image 1 のシーンに配置し、image 1 の他の部分はすべてそのまま維持してください」)
image+image2は使用しないでください: 200 が返されますが、2 枚目の画像は破棄され、1 枚目のみが使用されます- 5 枚を超える画像を送信すると 400
at most 5 reference images are accepted for <model>が返されます
マスクインペインティングはサポートされていますか?
マスクインペインティングはサポートされていますか?
mask フィールドを送信すると 400 <model> does not support mask edits が返されます。部分的な変更を行うには、prompt 内でその領域を指定してください(例:「ティーポットのみを青色にし、それ以外はすべて完全にそのまま維持してください」)。テストでは、モデルはこうした制約に忠実に従います。Cherry Studio / LobeChat で使用できますか?
Cherry Studio / LobeChat で使用できますか?
/v1/chat/completions を使用するため、このシリーズでは 404 が返されます。OpenAI Images API をサポートしているツールを使用するか、このドキュメント内のコードサンプルを使用して直接呼び出してください。1 回のリクエストで何枚の画像を生成できますか?
1 回のリクエストで何枚の画像を生成できますか?
n を送信しても、取得および課金されるのは 1 枚の画像のみです。複数枚必要な場合は、並行してリクエストを送信してください。編集エンドポイントでは n が機能します。n=2 は 2 枚の画像を返し、2 枚分として課金されます。usage 内の token 数で課金内容を照合できますか?
usage 内の token 数で課金内容を照合できますか?
usage.prompt_tokens は常に 1000 × 画像数、output_tokens は常に 0 となり、これらはプレースホルダーです。このシリーズは画像ごとに課金され、APIYI コンソールの請求が正式なものとなります。モデレーションはどの程度厳格ですか?ブロックされるとどのようになりますか?
モデレーションはどの程度厳格ですか?ブロックされるとどのようになりますか?
400 content_safety_violation が返されます。prompt レベルのブロックは通常 5〜8 秒以内に返されます。生成後に適用されるブロックもあり、その場合は通常の画像生成とほぼ同じ時間がかかります。同じ prompt を再試行しても解決しないため、表現を変更してください。ストリーミングはサポートされていますか?
ストリーミングはサポートされていますか?
503 no available channels が発生しますか?
503 no available channels が発生しますか?
MAI-Image-2.6 または MAI-Image-2.6-Flash である必要があり、mai-image-2.6-flash では 503 が返されます。関連ドキュメント
- MAI-Image 2.6 Text-to-Image API - Playground付きAPIリファレンス
- MAI-Image 2.6 Image Editing API - 参照画像編集
- 画像APIの要点とベストプラクティス - タイムアウト、切断、圧縮
- チャージボーナスキャンペーン