how-tos

MAI Image 2.7 APIの透過背景:PNGとWebPのアセット

Poyo.ai Team
3 min read
Share:

MAI Image 2.7 APIで作る透過PNGとWebPのアセット

MAI Image 2.7 APIは本物のアルファチャンネルを持つ画像を返せるので、商品の切り抜き、ロゴ、アイコン、ステッカーをマスク処理なしでどんな背景にもそのまま配置できます。PoYoではmai-image-2.7とmai-image-2.7-flashのどちらでも、backgroundとoutput_formatの2つのフィールドで指定します。ローンチ当日のテストでは、Flashでの1024x1024の透過PNGは現行レートで2.062クレジット、約$0.0103です。コードに組み込む前にMAI Image 2.7のモデルページで試してみてください。

透過についてMicrosoftが述べていること

Microsoftのローンチ記事は「both models support transparent backgrounds for ready-to-use product images」と述べ、さらにロゴ、アイコン、イラストを用途として挙げています。MicrosoftのFoundryドキュメントは、透過背景をMAI-Image-2.7が以前のMAI画像モデルに対して追加した機能として挙げ、「for assets such as product imagery, logos, icons, and design elements that need to be placed over other content」としています。MAI Image 2.6にはこのオプションはありません。

2つのフィールド

フィールド値デフォルトルール
backgroundopaque、transparentopaquetransparentはアルファチャンネル付きの画像を返す
output_formatpng、jpeg、webppngtransparentにはpngまたはwebpが必要

デフォルトがopaqueとpngなので、透過を得るにはbackgroundを明示的に送る必要があります。PNGならoutput_formatは省略できますが、送っておくとログで意図が明確になります。"background": "transparent"と"output_format": "jpeg"の組み合わせは、JPEGにアルファチャンネルがないため無効です。送信前に失敗させるよう、この組み合わせは自分の側で検証してください。

その他のフィールドは通常どおり動作します。size(デフォルトは1:1、任意のプリセット比率、または最大4,194,304ピクセルのカスタムWIDTHxHEIGHT)、resolution(1Kまたは2K)、任意のcallback_urlです。フィールドのルールの全体はAPIリファレンスにあります。

リクエストボディ

MAI Image 2.7 APIで透過PNG

Flashでの1Kの正方形ステッカーで、フィールド設定は計測した実行と同じです(プロンプトは例です)。

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-flash",
    "input": {
      "prompt": "A cute cartoon sticker of a smiling coffee cup with a thick white outline, centered, no background",
      "size": "1:1",
      "resolution": "1K",
      "background": "transparent",
      "output_format": "png"
    }
  }'

透過WebPのロゴ

PoYoのドキュメントにある例で、フラッグシップを使います。

{
  "model": "mai-image-2.7",
  "input": {
    "prompt": "A flat vector logo of a red fox head, clean edges, no background",
    "background": "transparent",
    "output_format": "webp"
  }
}

WebPもアルファを保持でき、通常PNGより小さなファイルになるので、Webページに向いています。PNGは、印刷ワークフローやPNGを前提とするデザインツールにとってより安全な選択です。

どちらのリクエストもtask_idを返します。statusがfinishedになるまでGET https://api.poyo.ai/api/generate/status/{task_id}をポーリングし、data.files[0].file_urlをダウンロードします。完全なポーリングループはMAI Image 2.7 APIガイドにあります。

実測:ローンチ当日の透過ステッカー

PoYoチームが2026年11月19日にPoYo本番APIで実行しました。

設定値
モデルmai-image-2.7-flash
フィールドsize: "1:1"、resolution: "1K"、background: "transparent"、output_format: "png"
出力1024x1024 PNG、RGBA
背景本物のアルファ:被写体の周囲は完全に透明
現行レートでのコスト2.062クレジット(約$0.0103)
時間約42秒、数秒ごとのポーリングで送信から結果まで

推計:1024x1024は約1,024出力トークンで、100万あたり2,000クレジットなら2.048クレジットです。残りの0.014クレジットは、100万あたり350クレジットで約40プロンプトトークンに一致します。つまり、透過画像は同じサイズの他の画像と同様に課金されました。価格表に透過の追加料金はありません。

コードでアルファチャンネルを確認する

ファイルの拡張子を信用せず、アセットライブラリに入れる前に、ダウンロードした画像に実際に透明なピクセルがあることを確認してください。Pillowを使う場合:

import io
import requests
from PIL import Image

def check_transparency(file_url):
    data = requests.get(file_url, timeout=60).content
    img = Image.open(io.BytesIO(data))
    if img.mode != "RGBA":
        img = img.convert("RGBA")
    alpha = img.getchannel("A")
    lo, hi = alpha.getextrema()
    clear = sum(1 for a in alpha.getdata() if a == 0)
    share = clear / (img.width * img.height)
    print(img.size, img.mode, "alpha range", (lo, hi), f"{share:.0%} fully transparent")
    return lo == 0 and share > 0.05

lo == 0で、完全に透明なピクセルが相応の割合ある結果なら、使える切り抜きです。チェッカーボードを描いた画像ならlo == 255となり、すべてのピクセルが不透明です。しきい値は自分のアセットに合わせて決めてください。画面全体のイラストは、中央に配置したアイコンより余白が少なくなります。

きれいな切り抜きのためのプロンプト

アルファチャンネルはモデルが処理しますが、被写体を切り離しやすいかどうかは依然としてプロンプト次第です。

  • 被写体が単独であると書く。 PoYoのドキュメントの例は「clean edges, no background」で終わります。MicrosoftのFoundryにある透過画像の例は「full body, centered, no shadow」を使っています。
  • シーンを表す言葉を避ける。 「On a table」「in a studio」「with a shadow」は被写体の外にあるものを求めることになります。
  • ステッカーには縁取りを指定する。 太い白い縁取りは明るい背景でも暗い背景でも見やすくなります。
  • テキストは引用符で囲む。 アセットに単語やロゴの文字が含まれる場合は、ドキュメントが画像内テキストについて推奨しているように引用符で囲みます。

透過アセットを大量に作るときのコスト

出力トークンはピクセル数だけで決まるので、透過は不透明の出力と同じコストです。1枚あたりの出力トークンのコスト:

サイズMAI Image 2.7MAI Image 2.7 Flash
1024x1024(1:1、1K)6.96クレジット($0.0348)2.05クレジット($0.0102)
2048x2048(1:1、2K)27.85クレジット($0.1393)8.19クレジット($0.0410)

Flashのステッカー1枚あたり実測2.062クレジットで計算すると、1,000枚で約2,062クレジット、およそ$10.31です。アイコンセットやカタログの切り抜きにはFlashを使い、ブランドロゴやヒーローの商品写真のように1つのアセットを最高品質にしたい場合はMAI Image 2.7を使ってください。料金の記事とFlashと2.7の比較でさらに詳しく解説しています。

よくある透過アセットのジョブ向けの設定

ジョブモデルsize / resolutionoutput_format
チャットやアプリのステッカーを大量にmai-image-2.7-flash1:1、1Kpngまたはwebp
Webサイトのアイコンやイラストmai-image-2.7-flash1:1、1Kwebp
ECサイトの商品の切り抜きmai-image-2.71:1または3:4、2Kpng
印刷やスライド用のブランドロゴmai-image-2.71:1、2Kpng
ヒーローに重ねる横長のバナー要素mai-image-2.7カスタム、例:3072x1344webp

これらはルールではなく出発点です。どの行もドキュメントにあるフィールドしか使っていないので、リクエストの他の部分を変えずにジョブのティアやサイズを変更できます。新しい種類のジョブでは、最初のバッチでアルファチェックを実行してください。

透過結果での編集

スキーマはbackground: "transparent"とimage_urlsの併用も許可しています。例えば商品写真を切り抜きにしたり、既存のステッカーのアルファチャンネルを保ったままスタイルを変えたりできます。この組み合わせはまだ計測していないので、本番で頼る前に自分の画像数枚で試し、上記のアルファチェックを実行してください。

よくある質問

MAI Image 2.7 APIで透過背景を得るには? inputの中で"background": "transparent"と"output_format": "png"(または"webp")を送ります。デフォルトは不透明なPNGです。

MAI Image 2.7 APIは透過JPEGを返せますか? いいえ。JPEGにはアルファチャンネルがないので、transparentにはPNGまたはWebPが必要です。

MAI Image 2.7 Flashは透過背景に対応していますか? はい。mai-image-2.7-flashでのローンチ当日のテストでは、背景が完全に透明な1024x1024のRGBA PNGが返され、現行レートで2.062クレジットです。

MAI Image 2.7 APIで透過背景にすると料金は上がりますか? いいえ。同じサイズの他の画像と同じテキスト、画像入力、出力のトークンレートで課金されます。

MAI Image 2.6で透過PNGを作れますか? いいえ。透過はMAI Image 2.7の新機能です。その他のフィールドの変更点はMAI Image 2.7 API vs MAI Image 2.6 APIをご覧ください。

Share: