コンテンツにスキップ

画像生成

POST /v1/images/generations

APIキーの取得については、クイックスタートガイドを参照してください。

$YOUR_API_KEY を、前のステップで生成した実際のAPIキーに置き換えてください。
$MODEL_ID も、使用するモデルのIDに置き換えてください。

リクエストボディ


prompt 文字列 必須
この画像生成リクエストに使用するプロンプトテキスト。


model 文字列 必須

画像生成に使用するモデルID。


n 整数 オプション デフォルトは 1

同時に生成する画像の数。モデルによって対応できる数は異なるので、ご注意ください。


size 文字列 オプション デフォルトは 1024x1024

生成する画像の幅と高さのピクセル数で、[512 x 512, 2048 x 2048] の範囲である必要があります。

推奨されるオプションの幅と高さ:

  • 1024x1024 (1:1)
  • 864x1152 (3:4)
  • 1152x864 (4:3)
  • 1280x720 (16:9)
  • 720x1280 (9:16)

レスポンスパラメータ


model 文字列

このリクエストで使用されたモデルID(モデル名-バージョン)。


created 整数

このリクエストが作成されたときのUnixタイムスタンプ(秒)。


data リスト

出力画像情報,Base64。


usage オブジェクト

このリクエストの使用状況情報。


generated_images 整数

モデルが生成した画像の枚数。
output_tokens 整数

モデルが生成した画像に使用されたトークン数。 計算式:長さ*幅/256、四捨五入。
total_tokens 整数

このリクエストで消費された総トークン数。 注:入力はトークン計算されないため、total_tokensoutput_tokens と一致します。

error オブジェクト

このリクエストでエラーが発生した場合の対応するエラー情報。


code 文字列

エラーコードを参照してください。
message 文字列

エラーメッセージ。