> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MAI-Image 2.6 画像生成＆編集

> Microsoft MAI-Image 2.6（MAI-Image-2.6 / MAI-Image-2.6-Flash）の完全ガイド：テキストからの画像生成および参照画像編集、最大1536×1536エリアまでのカスタム幅/高さ、強力な中国語テキストレンダリング、サイズに関係なく画像1枚あたり$0.12 / $0.06の一律料金。

## 概要

**MAI-Image 2.6**は、Microsoft AIが独自開発した画像生成モデルであり、2026-09-04にリリースされ、Microsoft Foundryにてパブリックプレビューとして利用可能です。リリース時、**Arenaのテキストからの画像生成および画像編集の両部門で第2位**、**Artificial Analysisの画像編集部門で第1位**を獲得しました（2026-09-04時点、Microsoftの発表による）。

APIYIでは、Microsoftの公式チャネルを通じて2つのバリアントを提供しています。両バリアントとも同じエンドポイントとパラメーターを共有します。

* **`MAI-Image-2.6`**: 品質と精度を重視して調整されたフラグシップモデル
* **`MAI-Image-2.6-Flash`**: 高速バリアント。MicrosoftによるとGPT-Image-2-Mediumより2.8倍高速に生成でき、高スループットな本番ワークロードに適しています

<Note>
  **主な特徴**: **優れた中国語テキストレンダリング**（店舗の看板、対聯、手書き文字が文字単位で正確に出力されます）、**忠実度の高い編集**（指定された箇所のみが変更され、残りはピクセル単位で完全に同一のまま維持されます）、`width` + `height` による自由なキャンバス指定（最大1536×1536の領域まで）、そして**サイズに関係のない画像1枚あたりの定額課金**です。1024×1024の画像生成にかかる時間は、Flashで約17秒、2.6で約30秒です。
</Note>

<Warning>
  **📌 開始前に知っておくべき3つのポイント**

  1. **サポートされているエンドポイントは2つのみです**: `/v1/images/generations`（テキストからの画像生成、JSON）および `/v1/images/edits`（編集、`multipart/form-data`）。**`/v1/chat/completions` と `/v1/responses` はサポートされておらず**、404を返します。
  2. **`response_format`、`seed`、`negative_prompt` は送信しないでください**。3つとも直ちに400を返します。レスポンスは常に `data[0].b64_json`（PNG）です。
  3. **サイズは `size` ではなく `width` + `height` で設定してください**。テキストからの画像生成エンドポイントでは、`size` は警告なしに無視され、常に1024×1024が出力されます。
</Warning>

<Info>
  すべての画像APIは**同期**処理です。非同期タスクIDは存在しません。クライアントが切断された場合、生成結果は失われますが、リクエストは課金されます。このモデルには十分なタイムアウト時間を設定してください。[画像APIの要点とベストプラクティス](/ja/api-capabilities/image-api-best-practices)をご参照ください。
</Info>

<CardGroup cols={2}>
  <Card title="テキストからの画像生成API" icon="wand-sparkles" href="/ja/api-capabilities/mai-image/text-to-image">
    テキストpromptから画像を生成します。インタラクティブなPlaygroundが付属しています。
  </Card>

  <Card title="画像編集API" icon="image" href="/ja/api-capabilities/mai-image/image-edit">
    参照画像と指示をアップロードします。2枚の画像合成にも対応しています。Playgroundが付属しています。
  </Card>
</CardGroup>

## AIエージェントに統合を任せる

<Note>
  Codex / Claude Code / Cursor を使って開発している場合は、以下の prompt をそこにコピーしてください。エージェントはまずこのページのプレーンテキスト版を取得し（任意のドキュメントURLの末尾に `.md` を追加）、お使いの技術スタックに合わせたコードを作成します。タイムアウト、**400 を返す3つのパラメータ**、`size` の代わりに `width`/`height` を使用すること、ファイルアップロード限定の編集など、よくある落とし穴が明記されています。
</Note>

<Prompt description="コーディングエージェントに MAI-Image 2.6 のテキストからの画像生成および画像編集を統合またはデバッグさせます。Codex、Claude Code、Cursor などにコピー＆ペーストしてください。" icon="bot" actions={["copy"]}>
  このプロジェクトで Microsoft MAI-Image 2.6 のテキストからの画像生成および画像編集を統合（またはデバッグ）してください。

  コードを書く前にドキュメントを読んでください：このページのプレーンテキスト版として [https://docs.apiyi.com/en/api-capabilities/mai-image/overview.md](https://docs.apiyi.com/en/api-capabilities/mai-image/overview.md) を取得してください。詳細なパラメータについては、同様にテキストからの画像生成および画像編集のページに `.md` を追加してください。

  要件：

  1. モデル名：フラッグシップ `MAI-Image-2.6`、高速版 `MAI-Image-2.6-Flash`。**モデル名は大文字と小文字が区別されます**。すべて小文字の名前にすると 503 が返され、サービス停止のように見えますが単に名前が間違っているだけです。

  2. エンドポイント：`/v1/images/generations`（JSON）および `/v1/images/edits`（`multipart/form-data`）のみ。**`/v1/chat/completions` や `/v1/responses` は呼び出さないでください**。404 が返されます。

  3. タイムアウト：クライアントのタイムアウトを Flash の場合は 120 秒、2.6 の場合は 180 秒に設定してください。1024×1024 の画像の実測値は約 17 秒 / 30 秒でしたが、ピーク時やサイズが大きい場合はさらに時間がかかります。画像 API は同期式でタスク ID はありません。クライアントが切断された場合、結果は失われますがリクエストには引き続き課金されます。リバースプロキシ、ゲートウェイ、サーバーレスの実行上限時間も引き上げてください。

  4. 禁止パラメータ：**`response_format`、`seed`、または `negative_prompt` は絶対に送信しないでください**。それぞれ 400 `Invalid parameters` を返します。gpt-image / DALL·E から移行したコードでは `response_format="b64_json"` が明示的に設定されていることが多いため、削除してください。`quality`、`output_format`、`background`、および `style` は警告なしに無視されるため、これらも削除してください。

  5. レスポンス処理：レスポンスは常に `data[0].b64_json` で、`data:` プレフィックスのないプレーンな base64 であり、デコードすると PNG になります（1024×1024 で約 1.5〜1.7 MB）。`url` モードはありません。`usage` にはプレースホルダーの値が入っており、照合には使用できません。コンソールの課金明細が正式なものです。

  6. サイズ：`width` + `height`（整数、必ずペアで使用）を使用してください。各辺は 768 以上である必要があり、幅 × 高さは 2,359,296（1536×1536 の面積）を超えてはなりません。16 の倍数でない値は 16 の倍数に切り捨てられます。どちらも送信しない場合、デフォルトは 1024×1024 です。**テキストからの画像生成エンドポイントでは、`size` は警告なしに無視されます。**

  7. 生成枚数：テキストからの画像生成では常に 1 枚の画像が返され、`n` は効果がありません。複数枚必要な場合は並列でリクエストを送信してください。編集エンドポイントでは `n` が機能し、画像ごとに課金されます。

  8. 編集：参照画像は multipart の**ファイルとしてアップロード**する必要があり、フィールド名は `image` です。**URL および base64 JSON 入力はサポートされていません**（400）。2枚の参照画像を使用する場合は、フィールド名 `image` と `image2` を使用してください。OpenAI SDK の `image=[f1, f2]` は `image[]` を2回送信するため拒絶されます。そのため、複数画像の編集には requests / fetch を使用して multipart リクエストをご自身で構築してください。マスクはサポートされていません。アップロード前に圧縮してください：1.5 MB を超えるファイルのみを対象とし、長辺を 2048 px 以下に縮小し、品質 0.9 で再エンコードし、圧縮に失敗した場合は元の画像にフォールバックしてください。

  9. エラー：コンテンツモデレーションは 400 `content_safety_violation` を返します（実在の著名人、流血・ゴア、有名な知的財産キャラクター、ヌードはブロックされます）。prompt を変更してください。リトライしても無駄です。範囲外のサイズはメッセージ内に正確な制約が含まれた 400 `unsupported_request_value` を返します。

  10. キーは `APIYI_API_KEY` 環境変数から読み取り、base\_url は [https://api.apiyi.com/v1](https://api.apiyi.com/v1) を使用してください。決してハードコードしたり git にコミットしたりしないでください。

  11. 完了したら、実際にテキストからの画像生成呼び出しを1回、編集呼び出しを1回実行し、両方の呼び出しの結果とコストを提示してください。
</Prompt>

<Accordion title="この prompt で回避できる落とし穴">
  | 要件 | 回避できる落とし穴 |
  | - | - |
  | `response_format` の削除 | 移行したコードで最もよく見られる明示的なパラメータです。これを送信すると 400 が返され、バッチ全体が失敗します |
  | `size` ではなく `width` / `height` | `size` はテキストからの画像生成では警告なしに無視されます。1536×1024 を要求したつもりでも、1024×1024 の正方形の画像が生成されます |
  | 編集はファイルアップロードのみ | OpenAI 方式で画像の URL や base64 JSON を渡すと 400 が返されます |
  | 2枚の画像には `image` + `image2` | OpenAI SDK の複数画像フォームは `image[]` を送信するため拒絶されます |
  | chat / responses は使用不可 | チャットクライアントはすべてのモデル名に対してチャットリクエストを送信しますが、ここでは 404 が返されます |
  | モデルごとの余裕を持ったタイムアウト設定 | 切断されたリクエストにも課金されます。[画像 API の基本とベストプラクティス](/ja/api-capabilities/image-api-best-practices) を参照してください |
</Accordion>

## APIYI で MAI-Image 2.6 を利用する理由

<CardGroup cols={2}>
  <Card title="Microsoft 公式チャネル" icon="shield-check">
    Microsoft の公式チャネルを通じて提供されます。モデルは Microsoft Foundry 上の同名モデルと同一です。標準の `/v1/images/generations` および `/v1/images/edits` エンドポイントに対応しており、OpenAI Images API と同様の形式でレスポンスが返されます。
  </Card>

  <Card title="画像単位の料金設定" icon="receipt">
    プロバイダーは tokens 単位で課金するため、画像サイズが大きくなるほどコストが高くなります。APIYI では**サイズに関わらず画像1枚あたりの一律定額**を採用しており、768×768 でも 1536×1536 でも同額なため、画像単位で予算を管理できます。
  </Card>

  <Card title="どこからでもアクセス可能" icon="globe">
    **Azure アカウントや海外サーバーは不要です。** データセンター、自宅ネットワーク、海外ノードのどこからでも直接 `api.apiyi.com` にアクセスでき、1つのキーですべてのモデルを利用可能です。
  </Card>

  <Card title="充実したモデルラインナップ" icon="layers">
    さまざまなユースケースに合わせて、[GPT-Image-2](/ja/api-capabilities/gpt-image-2/overview)、[Nano Banana 2](/ja/api-capabilities/nano-banana-2-image/overview)、[Seedream](/ja/api-capabilities/seedream-image/overview)、[FLUX](/ja/api-capabilities/flux/overview) と組み合わせて利用できます。
  </Card>
</CardGroup>

## 主な機能

<CardGroup cols={2}>
  <Card title="中国語テキストのレンダリング" icon="languages">
    中国語の店舗看板、対聯、黒板の手書き文字などが正確な文字で出力されます。ポスター、商品画像、グッズの制作に適しています。
  </Card>

  <Card title="高精度な編集" icon="wand">
    「ティーポットをコバルトブルーにする」といった指示でもティーポットのみが変更され、寸法ラベルやその他のオブジェクトはピクセル単位で同一のまま維持されます。
  </Card>

  <Card title="カスタムキャンバス" icon="maximize">
    任意の`width` + `height`の組み合わせに対応し、長辺は最大3072（例：3072×768のバナー）、総面積の上限は1536×1536です。
  </Card>

  <Card title="2つの速度ティア" icon="zap">
    1024×1024の場合、Flashで約17秒、2.6で約30秒かかります。10件の同時実行数でもレイテンシは安定して維持されます。
  </Card>
</CardGroup>

### サンプル結果

**中国語テキストのレンダリング**（`MAI-Image-2.6-Flash`、APIYIへの来訪者を歓迎する中国語の看板を指定したprompt）：看板、提灯、対聯、黒板のすべてにおいて判読可能な中国語が表示されています。

<Frame>
  <img src="https://mintcdn.com/apiyillc/_zXMTnA1u6gpoDyM/images/mai-image-zh-text-render.jpg?fit=max&auto=format&n=_zXMTnA1u6gpoDyM&q=85&s=7b83a1cb725f1391524c334b7399ea61" alt="MAI-Image-2.6-Flashの中国語テキストレンダリング：中国語の歓迎看板がある伝統的な茶屋" width="768" height="780" data-path="images/mai-image-zh-text-render.jpg" />
</Frame>

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

<Frame>
  <img src="https://mintcdn.com/apiyillc/_zXMTnA1u6gpoDyM/images/mai-image-edit-teaset.jpg?fit=max&auto=format&n=_zXMTnA1u6gpoDyM&q=85&s=c86dc86c5aadf0173e19102433c01f49" alt="MAI-Image-2.6-Flashの編集例：ティーポットの色がクリーム色からコバルトブルーに変更され、その他はすべて未変更" width="1048" height="532" data-path="images/mai-image-edit-teaset.jpg" />
</Frame>

## 料金

| モデル | ポジショニング | APIYI価格 | 課金 |
| - | - | - | - |
| **`MAI-Image-2.6`** | フラグシップ、品質重視 | **\$0.12 / 画像** | 画像1枚ごと、サイズ不問 |
| **`MAI-Image-2.6-Flash`** | 高速、スループット重視 | **\$0.06 / 画像** | 画像1枚ごと、サイズ不問 |

<Note>モデルの価格は変更される場合があります。上記の表は参考情報であり、上部ナビゲーションの**モデル価格**タブが正式な情報となります：[モデル価格](/en/models/index)。</Note>

<Info>
  **課金に関する注意事項**

  * **サイズに関わらず画像1枚あたり**：768×768と1536×1536は同じ料金であり、promptの長さは価格に影響しません。
  * **編集はテキストからの画像生成と同額**：1枚の画像編集および2枚の画像合成はそれぞれ画像1枚として課金されます。編集エンドポイントでの`n=2`は画像2枚分として課金されます。
  * **400エラーで失敗したリクエスト**（モデレーションまたは無効なパラメータ）：画像は生成されません。
  * **レスポンスの`usage`フィールドと照合しないでください**：`prompt_tokens`は常に「画像数 × 1000」のプレースホルダーです。コンソールの課金情報が正式なものとなります。
  * [チャージボーナスプロモーション](/ja/faq/recharge-promotions)と併用可能です。
</Info>

## グループと Tokens

このシリーズは\*\*`Default` グループ\*\*に属しています。新規作成されたすべての token で呼び出すことができ、申請は不要です。

<Info>
  **token 課金モード**: このシリーズでは `Pay-as-you-go Priority` と `Per-request` の両方をご利用いただけます。プラットフォーム上の token 課金モデルでも同じ token を利用できるよう、`Pay-as-you-go Priority` を推奨します。

  **レート**: 単一キーは **50 RPM** 未満に抑えてください。大規模なバッチワークロードの場合は、事前にサポートまでお問い合わせください。
</Info>

## 技術仕様

| 項目 | 仕様 |
| - | - |
| モデルID | `MAI-Image-2.6`、`MAI-Image-2.6-Flash`（**大文字・小文字を区別**） |
| エンドポイント | `/v1/images/generations` (JSON)、`/v1/images/edits` (multipart) |
| サイズパラメータ | `width` + `height`、整数、常にペアで指定 |
| サイズ範囲 | 各辺 ≥ 768、幅 × 高さ ≤ 2,359,296 (= 1536×1536)、16の倍数に切り捨て |
| デフォルトサイズ | 1024×1024 |
| 出力形式 | PNG (RGB)、`b64_json` のみ、1024×1024で約1.5〜1.7 MB |
| リクエストあたりの画像数 | Text-to-imageは常に1、編集エンドポイントでは `n` が利用可能 |
| 参照画像 | 編集エンドポイントでのファイルアップロード、最大2枚（`image` + `image2`） |
| マスクインペインティング | ❌ 非対応 |
| `seed` / `negative_prompt` | ❌ 400を返却 |
| ストリーミング | ❌ 非対応 |
| レイテンシ (1024×1024) | Flash P50 約17秒、2.6 P50 約30秒 |
| 推奨クライアントタイムアウト | Flash ≥ 120秒、2.6 ≥ 180秒 |

## エンドポイント

| 機能 | メソッド | パス | Content-Type |
| - | - | - | - |
| テキストから画像生成 | `POST` | `/v1/images/generations` | `application/json` |
| 画像編集 | `POST` | `/v1/images/edits` | **`multipart/form-data`** |

<Warning>
  **❌ チャットエンドポイントはサポートされていません**

  このシリーズでは、`/v1/chat/completions` および `/v1/responses` は **404 `Requested path is not found`** を返します。Cherry Studio や LobeChat などのチャットクライアントはリスト内のすべてのモデルにチャットリクエストを送信するため、**これらのクライアントでは MAI-Image を選択しないでください**。Images API をサポートするツールを使用するか、独自のコードから呼び出してください。
</Warning>

<Warning>
  **✅ 編集エンドポイントはマルチパートファイルアップロードのみを受け付けます**

  JSON（URL、data URI、または生の base64 形式の `image` を含む）を `/v1/images/edits` に送信すると、400 が返されます：

  ```text theme={null}
  request Content-Type isn't multipart/form-data
  ```

  `-F "image=@photo.jpg"` を使用してローカルファイルを直接アップロードしてください。**画像ホスティングは不要です。** 完全な例については [画像編集 API](/ja/api-capabilities/mai-image/image-edit) を参照してください。
</Warning>

<Tip>
  プライマリドメインは `https://api.apiyi.com`、バックアップドメインは `https://b.apiyi.com` です。
</Tip>

## 主要パラメータ

### `width` および `height`（出力サイズ）

| ルール | 詳細 |
| - | - |
| 常にペアで指定 | 片方のみ送信した場合は400が返されます |
| 最小値 | 各辺は最低768。767を指定すると400が返されます `'width' must be at least 768 pixels` |
| 面積の上限 | 幅 × 高さ ≤ 2,359,296。1600×1600を指定すると400が返されます `exceeds the maximum of 2359296` |
| 端数処理 | 16の倍数でない値は切り捨てられます: 1000×1000 → 992×992、1024×1023 → 1024×1008 |
| アスペクト比 | 制限なし。3072×768（4:1のバナー）も指定可能です |

**一般的なキャンバスサイズ**（すべて面積上限内）:

| 用途 | `width` × `height` |
| - | - |
| 正方形 | 1024×1024 / 1536×1536 |
| 横長 3:2 | 1536×1024 |
| 縦長 2:3 | 1024×1536 |
| 横長 16:9 | 1792×1008 |
| 縦長 9:16 | 1008×1792 |
| バナー 4:1 | 3072×768 |

<Warning>
  **`size` は2つのエンドポイントで挙動が異なります**: テキストから画像生成では**暗黙的に無視され**（常に1024×1024）、編集エンドポイントでは有効になります。混乱を避けるため、**両方のエンドポイントで `width` + `height` を使用してください**。
</Warning>

### `n`（画像枚数）

* **テキストから画像生成**: `n` は効果がありません。2、4、または10を指定して送信しても1枚の画像のみが返されます（課金も1枚分）。さらに必要な場合は並列リクエストを送信してください。
* **編集**: `n` は機能します。`n=2` は2枚の画像を返し、2枚分として課金されます。

## ベストプラクティス

<Steps>
  <Step title="ユースケースに応じてバリアントを選択する">
    バッチ生成やレイテンシを重視する処理 → `MAI-Image-2.6-Flash`。ヒーローポスター、複雑な構図、または高い品質基準が求められる場合 → `MAI-Image-2.6`。パラメータは同一であるため、切り替えはモデル名を変更するだけです。
  </Step>

  <Step title="描画したいテキストを引用符で囲む">
    画像内に表示させたいテキストは引用符で囲み、どこに配置するかを指定します（例: 「Grand Opening」と書かれた看板）。モデルは引用符内のテキストを極めて忠実に再現します。
  </Step>

  <Step title="編集時は「その他はすべてそのまま変更しない」と指定する">
    元の画像を可能な限り維持するために、「Make the teapot cobalt blue, keep everything else exactly the same（ティーポットをコバルトブルーにし、その他はすべて完全に元のままにしてください）」のように指示を記述します。
  </Step>

  <Step title="キャンバスを変更すると画像が再構成される">
    元の画像と異なるアスペクト比の `width` / `height` を渡すと、モデルはクロップ（切り抜き）やパディングを行うのではなく、**シーンを再レイアウト**します。部分的な編集の場合はサイズ指定を省略すると、出力は16の倍数にスナップされた元の比率に従います（例: 1344×756の入力 → 1360×768の出力）。
  </Step>

  <Step title="複数の画像が必要な場合は並行リクエストを送信する">
    テキストからの画像生成（Text-to-image）では1回の呼び出しにつき1枚の画像が返されるため、4枚の画像が必要な場合は4つの並行リクエストを送信してください。テストでは、同時実行数が10件の場合でも単一リクエストと同等のレイテンシでした。
  </Step>
</Steps>

## エラーコードとリトライ

| HTTP | コード / メッセージ | 意味 | 対処方法 |
| - | - | - | - |
| `400` | `unsupported_request_value` | サイズが範囲外、不正な型、または`width`と`height`が同時に送信されていない | メッセージ内の制約に従って修正してください。リトライはしないでください |
| `400` | `invalid_request`: `Invalid parameters: xxx` | `response_format` / `seed` / `negative_prompt`が送信された | 当該フィールドを削除してください |
| `400` | `invalid_request`: `Prompt must be …` | `prompt`が空または不足している | promptを追加してください |
| `400` | `invalid_request`: `File must be attached in a form field with a name starting with 'image'` | ファイルフィールドの重複（`image[]`×2）、または編集エンドポイントでの`mask`の指定 | `image` + `image2`を使用してください。マスクはサポートされていません |
| `400` | `content_safety_violation` | コンテンツモデレーションによりブロックされた | promptを変更してください。リトライしても解決しません |
| `400` | `request Content-Type isn't multipart/form-data` | 編集エンドポイントにJSONが送信された | multipartファイルアップロードに切り替えてください |
| `404` | `Requested path is not found` | chat / responsesに送信された | Images APIを使用してください |
| `500` | `image is required` | 編集リクエストに画像ファイルフィールドがない | ファイルフィールド名が`image`になっていることを確認してください |
| `503` | `no available channels` | モデル名の大文字・小文字の誤り（例: すべて小文字） | `MAI-Image-2.6` / `MAI-Image-2.6-Flash`を使用してください |

<Info>
  **クライアント向けのアドバイス**: 上記の4xx / 500エラーは確定的なものであるため、リトライしても意味がありません。代わりにアラート通知を行ってください。リトライする価値があるのはネットワークタイムアウトと`429`のみであり、指数バックオフを用いて最大3回までに留めてください。**クライアント側のタイムアウトにより破棄されたリクエストも課金対象となる**点に注意し、まずはタイムアウト値を長めに設定してください。
</Info>

## FAQ

<AccordionGroup>
  <Accordion title="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` についても同様です。
  </Accordion>

  <Accordion title="size: 1536x1024 を渡したのに、結果が正方形のままなのはなぜですか？">
    テキストからの画像生成エンドポイントは **`size` を読み取りません**。暗黙的に無視され、デフォルトの 1024×1024 でレンダリングされます。代わりに `"width": 1536, "height": 1024` を使用してください。

    編集エンドポイントでは `size` は機能しますが、一貫性を保つため両方で `width` + `height` を使用してください。
  </Accordion>

  <Accordion title="画像 URL を使用して編集できますか？">
    **できません。** 編集エンドポイントは `multipart/form-data` ファイルのアップロードのみを受け付けます。URL、data URI、または base64 文字列を `image` として渡すと 400 が返されます。

    URL しかない場合は、まずサーバー側でダウンロードしてからアップロードしてください。

    ```python theme={null}
    import requests
    img = requests.get("https://example.com/photo.jpg", timeout=30).content
    files = {"image": ("photo.jpg", img, "image/jpeg")}
    ```
  </Accordion>

  <Accordion title="2 枚の参照画像を送信するにはどうすればよいですか？ OpenAI SDK が動作しないのはなぜですか？">
    2 枚目の画像のフィールド名を **`image2`** にしてください。

    ```bash theme={null}
    curl -X POST "https://api.apiyi.com/v1/images/edits" \
      -H "Authorization: Bearer sk-your-api-key" \
      -F "model=MAI-Image-2.6" \
      -F "prompt=Place the person from image 2 into the scene in image 1" \
      -F "image=@scene.jpg" \
      -F "image2=@person.jpg"
    ```

    OpenAI SDK の `client.images.edit(image=[f1, f2])` は、両方のファイルを `image[]` として送信します。このシリーズは重複したファイルフィールドを受け付けず、400 を返します。SDK を使用した単一画像の編集は問題なく動作します。
  </Accordion>

  <Accordion title="マスクインペインティングはサポートされていますか？">
    **サポートされていません。** `mask` フィールドを指定すると 400 が返されます。部分的な変更を行うには、prompt 内で領域を指定してください（例: 「Only make the teapot blue, keep everything else exactly the same」など）。弊社のテストでは、モデルはこのような制約に忠実に従います。
  </Accordion>

  <Accordion title="Cherry Studio / LobeChat で使用できますか？">
    **推奨されません。** これらのチャットクライアントは `/v1/chat/completions` を使用するため、このシリーズでは 404 が返されます。OpenAI の Images API をサポートしているツールを使用するか、本ドキュメントのコードサンプルを使って直接呼び出してください。
  </Accordion>

  <Accordion title="1 リクエストあたり何枚の画像を生成できますか？">
    テキストからの画像生成では**常に 1 枚返されます**。送信する `n` の値に関わらず、受け取りおよび課金は 1 枚分となります。さらに必要な場合は、並行リクエストを送信してください。

    編集エンドポイントでは `n` が機能します。`n=2` は 2 枚の画像を返し、2 枚分として課金されます。
  </Accordion>

  <Accordion title="usage の token 数で課金を照合できますか？">
    **できません。** `usage.prompt_tokens` は常に「1000 × 画像数」であり、`output_tokens` は常に 0 です。これらはプレースホルダーです。このシリーズは画像ごとに課金され、APIYI コンソールの請求明細が正式なものとなります。
  </Accordion>

  <Accordion title="モデレーションはどれくらい厳格ですか？ ブロックされるとどうなりますか？">
    このシリーズは Microsoft の公式コンテンツセーフティポリシーを採用しており、**かなり厳格**です。実在の有名人、流血・残虐表現、著名な IP キャラクター（ディズニーなど）、ヌードはブロックされます。

    ブロックされると `400 content_safety_violation` が返され、メッセージに具体的な理由が示されます。prompt レベルのブロックは通常 5〜8 秒以内に返されます。生成後に適用される一部のブロックは、通常の画像生成と同程度の時間がかかります。同じ prompt で再試行しても解決しないため、表現を書き換えてください。
  </Accordion>

  <Accordion title="ストリーミングはサポートされていますか？">
    **サポートされていません。** 通常の同期リクエストとして呼び出し、完全なレスポンスをお待ちください。
  </Accordion>

  <Accordion title="503 no available channels が返されますか？">
    最も一般的な原因は、**モデル名の大文字・小文字の誤り**です。モデル名は正確に `MAI-Image-2.6` または `MAI-Image-2.6-Flash` である必要があり、`mai-image-2.6-flash` を指定すると 503 が返されます。
  </Accordion>
</AccordionGroup>

## 関連ドキュメント

* [MAI-Image 2.6 Text-to-Image API](/ja/api-capabilities/mai-image/text-to-image) - Playground付きAPIリファレンス
* [MAI-Image 2.6 画像編集API](/ja/api-capabilities/mai-image/image-edit) - 参照画像編集と2画像合成
* [画像APIの要点とベストプラクティス](/ja/api-capabilities/image-api-best-practices) - タイムアウト、切断、圧縮
* [チャージボーナスプロモーション](/ja/faq/recharge-promotions)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.