guides

MAI Image 2.7 API:MAI Image 2.7とは?料金、上限、Flash

Poyo.ai Team
3 min read
Share:

PoYoのMAI Image 2.7 API

MAI Image 2.7 APIを使うと、Microsoft AIの最新画像モデルをPoYoの1つのRESTエンドポイントから呼び出せます。最終アセットにはmai-image-2.7、より安く速いジョブにはmai-image-2.7-flashを使います。どちらも同じリクエストボディを受け付け、プロンプトから生成するか最大5枚の参照画像を編集でき、透過PNGまたはWebPファイルを返せます。このページでは、MAI Image 2.7とは何か、正確な上限、トークン料金、そしてローンチ当日に計測した結果をまとめます。

MAI Image 2.7とは?

MAI Image 2.7は、Microsoft AI(MAI)の画像生成・編集モデルで、2026年11月17日にMAI Image 2.7 Flashと同時にリリースされました。Microsoftのモデルカードによると、非埋め込みパラメータ200億の拡散ベースのモデルで、テキストからの画像生成と「precise, controllable image-to-image editing」の両方に向けて作られています。MAI Image 2.7 Flashは「an optimized version of MAI Image 2.7」です。

Microsoftはこのモデルが「rebuilt from the ground up for multimodal editing workflows」だとし、編集操作としてオブジェクトの削除、置き換え、属性の変更、インペインティング、テキストの更新、アーティファクトの除去(モーションブラーなど)を挙げています。またMicrosoftによれば、MAI Image 2.7は2026年11月16日時点でArtificial AnalysisのAA-Image-Editing v2.1リーダーボードで1位となり、5,478票で1,215 Eloを獲得しました。

API連携の観点では、このモデルに送る価値のあるリクエストは次の3種類です。

  • 画像の他の部分を変えずに済ませたい編集:商品の色変更、オブジェクトの置き換え、看板やラベルの書き換え。
  • 画像内テキストを含む画像:Microsoftのモデルカードは「improved rendering of text within generated images, including labels, posters, packaging, and signage」と報告しています。
  • 本物のアルファチャンネルが必要なアセット:Microsoftは両モデルが「support transparent backgrounds」としており、PoYoではこれをbackground: "transparent"として提供しています。

MAI Image 2.7 APIの概要

MAI Image 2.7MAI Image 2.7 Flash
PoYoモデルIDmai-image-2.7mai-image-2.7-flash
送信エンドポイントPOST https://api.poyo.ai/api/generate/submit同じ
結果の取得GET /api/generate/status/{task_id}をポーリング、またはcallback_urlを使用同じ
入力モードテキストから画像生成、1枚の画像を編集、2〜5枚の画像を合成同じ
リクエストフィールドprompt、image_urls、size、resolution、background、output_format同じ
Microsoftのリリース2026年11月17日2026年11月17日
ドキュメントMAI Image 2.7 APIリファレンスMAI Image 2.7 Flashリファレンス(スキーマは同じ)

2つのPoYoスキーマの違いはモデルIDだけなので、ティアの切り替えは文字列1つの変更で済みます。どちらが得になるかはティア比較で解説しています。

上限とリクエストフィールド

フィールドPoYoでのルール
prompt必須、1〜32,000文字、空白以外のテキストを含むこと。画像内に入れる正確な文字列は引用符で囲む。
image_urls任意、1〜5個の公開HTTP(S) URLの配列、JPEG・PNG・WebP。1枚なら編集、複数なら合成。参照画像は最大約1メガピクセルで使用される。
size1:1(デフォルト)、4:3、3:4、3:2、2:3、16:9、9:16、またはカスタムWIDTHxHEIGHT
カスタムサイズ両辺が16で割り切れ、各辺768以上、合計4,194,304ピクセル以下。指定どおりのサイズで使用される
resolution1K(デフォルト、約1メガピクセル、1:1は1024x1024)または2K(約4メガピクセル、16:9は2720x1536)
backgroundopaque(デフォルト)またはtransparent。transparentにはpngまたはwebpが必要
output_formatpng(デフォルト)、jpeg、webp
1リクエストあたりの画像数1

image_urlsがありsizeがない場合、出力は1枚目の参照画像のアスペクト比で約1メガピクセルになります。4,194,304ピクセルの上限はMicrosoftのモデルカードと一致しており、モデルカードは同じ「maximum total pixel count」を示したうえで、合計がその範囲内であればどちらかの辺が2048を超えてもよいと記しています。

MAI Image 2.7 APIの料金

PoYoは両モデルを当社の価格表のレートでトークン課金します。1クレジット = $0.005です。

100万トークンあたりPoYoのMAI Image 2.7PoYoのMAI Image 2.7 Flash
テキスト入力1,000クレジット($5.00)350クレジット($1.75)
画像入力1,600クレジット($8.00)500クレジット($2.50)
画像出力6,800クレジット($34.00)2,000クレジット($10.00)

PoYoでは出力トークンはピクセル数に比例し、約1,024ピクセルあたり1トークンです。1024x1024の画像は約1,024出力トークンで、MAI Image 2.7では約6.96クレジット($0.035)、**Flashでは約2.05クレジット($0.0102)**に、プロンプトのテキストトークン分のわずかな料金が加わります。全サイズの計算は料金の詳細にあります。

ローンチ当日に計測した結果

PoYoチームが2026年11月19日にPoYo本番APIで実行しました。時間は数秒ごとにポーリングするクライアントから見た送信から結果までの時間なので、目安として扱ってください。

リクエスト出力現行レートでのコスト時間
mai-image-2.7、16:9、2K、png、「OPEN LATE」と書かれたネオンサインのある雨の夜のカフェ2720x153627.802クレジット(約$0.139)約66秒
mai-image-2.7-flash、同じリクエスト2720x15368.1803クレジット(約$0.041)約42秒
mai-image-2.7-flash、1:1、1K、background: transparent、png1024x1024 RGBA、背景は完全に透明2.062クレジット(約$0.0103)約42秒

カフェの2回の実行では、どちらも看板がプロンプトどおり正確に「OPEN LATE」と表示されました。透過の実行では白やチェッカーボードの背景ではなく本物のアルファチャンネルが返されました。リクエストの全体は透過背景ガイドにあります。

最初のMAI Image 2.7 APIリクエスト

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mai-image-2.7",
    "input": {
      "prompt": "A university campus poster at dusk with the title \"Open Day 2026\", photorealistic, cinematic light",
      "size": "16:9",
      "resolution": "2K"
    }
  }'

レスポンスにはdata.task_idとステータスnot_startedが含まれます。ステータスエンドポイントをfinishedになるまでポーリングし、data.files[0].file_urlから画像を読み取るか、トップレベルのcallback_urlを渡してタスク終了時にPOSTを受け取ります。ボディのcodeフィールドは必ず確認してください。一部のバリデーションエラーはHTTP 200でcode: 400を返します。APIガイドには、上限付きのPythonポーリングループと各入力モードのJSONボディがあります。

MAI Image 2.7を利用できる場所

MicrosoftはMAI Image 2.7をホスト型モデルとして提供しており、ダウンロード可能な重みはありません。Microsoft Foundryではパブリックプレビュー中で、MicrosoftのドキュメントにはMAI-Image-2.7とMAI-Image-2.7-Flash(バージョン2026-11-02)がGlobal Standardデプロイとして記載されています。またMAI Labsでも試せますが、Microsoftはこれを個人的・非商用の利用向けとしています。

PoYoでは、他のすべてのモデルと同じAPIキーで両モデルを呼び出せ、Azureサブスクリプションやデプロイ手順は不要です。PoYoのリクエスト形式もFoundryとは異なります。1つのJSONエンドポイントが編集用のimage_urlsを受け付け(Foundryは別のmultipart編集エンドポイントを使用)、生の幅と高さではなく、アスペクト比と1K/2K、またはカスタムサイズを選びます。

リクエストごとの振り分け

リクエスト呼び出すモデル
最終的なヒーロー画像、精密な編集、テキストの多いポスターやパッケージmai-image-2.7
下書き、プレビュー、サムネイル、大量のカタログやステッカーのジョブmai-image-2.7-flash
最新のWeb情報が必要なプロンプト(時事、実在の場所)enable_web_search付きのmai-image-2.6、MAI Image 2.6を参照

MAI Image 2.7はMAI Image 2.6にあるWeb検索オプションを受け付けません。それ以外の2.6リクエストの内容はそのまま使えます。フィールドの変更点と移行用の差分は2.7と2.6の比較にまとめています。

よくある質問

MAI Image 2.7 APIのモデルIDは? フラッグシップにはmai-image-2.7、Flashにはmai-image-2.7-flashを使います。mai-image-2-7はPoYoのページスラッグにすぎず、モデルIDとしては拒否されます。

MAI Image 2.7 APIの料金は? PoYoでは、MAI Image 2.7はテキスト入力・画像入力・出力の100万トークンあたり$5.00 / $8.00 / $34.00、Flashは$1.75 / $2.50 / $10.00です。1024x1024の画像はMAI Image 2.7で約$0.035、Flashで約$0.0102になります。

MAI Image 2.7 APIは新しい画像を生成できますか、それとも編集のみですか? 両方できます。promptだけのリクエストは新しい画像を生成します。image_urlsに1〜5個のURLを加えると、同じリクエストが編集または複数画像の合成になります。

MAI Image 2.7 APIは透過背景に対応していますか? はい。"background": "transparent"を"output_format": "png"または"webp"と一緒に送ります。ローンチ当日のFlashテストでは、背景が完全に透明な1024x1024のRGBA PNGが返されました。

MAI Image 2.7 APIが返せる最大の画像は? 4,194,304ピクセルです。例えば2048x2048やカスタムの3072x1344です。2Kでは、16:9は2720x1536になります。

MAI Image 2.7 APIのリクエストにはどのくらい時間がかかりますか? 2026年11月19日のテストでは、2K 16:9の画像がMAI Image 2.7で約66秒、Flashで約42秒かかりました。リクエストを開いたまま待つのではなく、期限付きのポーリングかcallback_urlを使ってください。

Share: