Skip to main content
POST
Text-to-image: generate an image from a text prompt
右側のインタラクティブなPlaygroundで、オンラインテストを行うことができます。Authorization にAPIキーを入力し(形式: Bearer sk-xxx)、model を選択し、prompt を入力し、必要に応じて width / height を設定して送信してください。
ユースケース: このページはテキストからの画像生成専用です。既存の画像を編集したり、2つの画像を合成したりする場合は、画像編集API を使用してください。
⚠️ 3つのパラメーターが400を返しますこのシリーズでは response_format、seed、または negative_prompt は受け付けられません。これらを送信すると 400 Invalid parameters: xxx が返されます。gpt-image / DALL·E から移行する場合は、まず response_format を削除してください。レスポンスは常に data[0].b64_json です。
⚠️ sizeではなくwidth + heightを使用してくださいこのエンドポイントは size を警告なしに無視し、常に1024×1024でレンダリングします。整数の width + height を使用してください(常にセットで指定): 各辺 ≥ 768、幅 × 高さ ≤ 2,359,296(1536×1536の面積)。
すべての画像APIは 同期型 です: 非同期タスクIDはありません。クライアントが切断された場合、結果は失われますがリクエストには課金されます。1024×1024の画像は、Flash で約17秒、2.6 で約30秒かかります。クライアントのタイムアウトは、Flash では少なくとも120秒、2.6 では180秒に設定してください。 詳細は 画像APIの基本とベストプラクティス を参照してください。

コード例

Python (OpenAI SDK)

Python (requests)

cURL

Node.js (fetch)

複数の画像が必要な場合:並列リクエストを送信

text-to-image エンドポイントは1回の呼び出しにつき1枚の画像を返します(n は効果がありません)。そのため、リクエストを並列で実行してください:

パラメーターリファレンス

quality、output_format、background、style、およびその他の OpenAI スタイルのフィールドは暗黙的に無視されます。出力は常にPNGです。

レスポンス形式

レスポンスフィールド
  • b64_json は data:image/png;base64, プレフィックスのないプレーンな base64 です。直接デコードしてPNGを取得してください。
  • url フィールドはなく、revised_prompt もありません。
  • 1024×1024のPNGは約1.5〜1.7 MB(base64では2.1〜2.3 MB)、1536×1536は約4〜5 MBです。クライアントのレスポンスサイズ制限を確認してください。
usage で課金の照合を行わないでください: prompt_tokens は常に画像数 × 1000、output_tokens は常に0となり、これらはプレースホルダーです。このシリーズは画像ごとに課金され、APIYI コンソールの請求内容が正式なものとなります。

承認

Authorization
string
header
必須

API key from the APIYI console

ボディ

application/json
model
enum<string>
デフォルト:MAI-Image-2.6-Flash
必須

Model ID (case-sensitive). 2.6 favors quality, Flash favors speed

利用可能なオプション:
MAI-Image-2.6-Flash,
MAI-Image-2.6
prompt
string
必須

Prompt in any language. Put text that should appear in the image in quotes

例:

"A traditional teahouse storefront with a wooden sign that reads \"Welcome\", red lanterns, warm dusk light, photorealistic"

width
integer
デフォルト:1024

Output width in pixels. Each side ≥ 768, width × height ≤ 2,359,296 (a 1536×1536 area); must be sent together with height; rounded down to a multiple of 16.

必須範囲: x >= 768
例:

1024

height
integer
デフォルト:1024

Output height in pixels, same rules as width

必須範囲: x >= 768
例:

1024

レスポンス

Image generated

created
integer

Creation timestamp

例:

1790999642

data
object[]

Image results; always 1 item for text-to-image

usage
object

Placeholder values, not for billing reconciliation. prompt_tokens is always 1000 × images and output_tokens is always 0. The console bill is authoritative.