テキストから画像生成
/v1/images/generationsテキストのプロンプトから画像を1枚生成します。
リクエストパラメータ
モデルID。安定版モデルIDの使用を推奨します。固定バージョンを再現する必要がある場合は、スナップショットモデルIDを指定できます。
生成したい画像を説明するプロンプト。1〜4,000文字で指定してください。
画像に含めたくない要素を指定するプロンプト。最大4,000文字。サンプルでは、モデルカードで推奨されているネガティブプロンプトを使用しています。
画像サイズを「幅x高さ」で指定します。デフォルトは1024x1024です。幅・高さはそれぞれ256〜2048ピクセルの範囲で、16の倍数にしてください。総画素数は2,097,152ピクセル以下にしてください。
生成する画像の枚数。指定できる値は1のみです。
乱数シード。生成過程のランダム性の制御と結果の再現に使用します。範囲は0–2^53−1です。指定しない場合はシステムがランダムに生成します。
推論ステップ数。範囲は1–100です。
ガイダンススケール。範囲は0–10で、明示的に0を指定した場合も有効です。
urlのみ対応しています。b64_jsonには対応していません。
生成画像の透かし設定。enabledには真偽値を指定します。省略すると、画像に透かしが表示されます。{"enabled": false}を指定すると透かしは非表示になります。
戻り値
生成に成功すると、画像URLを含むJSONを返します。1回のリクエストで生成する画像はPNG形式で1枚です。ストリーミング出力には対応していません。
レスポンス内の作成タイムスタンプ。
生成された画像の結果リスト。
生成された画像のURL。
実際の画像生成の使用量。
実際に生成された画像の枚数。
実際の画像の幅(ピクセル)。
実際の画像の高さ(ピクセル)。
エラーコード
リクエストボディが有効なJSONではない、フィールドの型または値が不正、非対応のパラメータが含まれている、またはモデル / バージョンが見つかりません。フィールド名とパラメータの範囲を確認してください。スナップショットモデルではversionを別途指定しないでください。
認証の失敗、またはプラットフォームの安全審査によるブロック。
画像結果のアセットが存在しません。生成リクエストを再送信してください。繰り返し発生する場合は、リクエストの識別子を保持し、サービス提供者にお問い合わせください。
同時実行数またはリクエスト頻度が上限を超えました。
上流の結果の構造、モデルバージョン、または使用量の検証に失敗しました。タスクとトレースの識別子を保持し、サービス提供者にお問い合わせください。