
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.7 | MAI Image 2.7 Flash | |
|---|---|---|
| PoYoモデルID | mai-image-2.7 | mai-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メガピクセルで使用される。 |
size | 1:1(デフォルト)、4:3、3:4、3:2、2:3、16:9、9:16、またはカスタムWIDTHxHEIGHT |
| カスタムサイズ | 両辺が16で割り切れ、各辺768以上、合計4,194,304ピクセル以下。指定どおりのサイズで使用される |
resolution | 1K(デフォルト、約1メガピクセル、1:1は1024x1024)または2K(約4メガピクセル、16:9は2720x1536) |
background | opaque(デフォルト)またはtransparent。transparentにはpngまたはwebpが必要 |
output_format | png(デフォルト)、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.7 | PoYoの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」と書かれたネオンサインのある雨の夜のカフェ | 2720x1536 | 27.802クレジット(約$0.139) | 約66秒 |
mai-image-2.7-flash、同じリクエスト | 2720x1536 | 8.1803クレジット(約$0.041) | 約42秒 |
mai-image-2.7-flash、1:1、1K、background: transparent、png | 1024x1024 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を使ってください。