画像の作成・編集

POST/v1/images/generations

プロンプトから画像を生成します。同じ JSON リクエストの image に参照画像を渡すと編集できます。

認証

bearerAuth

認証Bearer <token>

プラットフォームの API キーを使用します。

指定位置: header

リクエストボディ

application/json

TypeScript 型定義

TypeScript で request body 型を使用します。

model*string

プラットフォームのモデル ID。

prompt?string

画像の生成・編集指示。レイヤー分解モードでのみ省略できます。

長さ1 <= length

image?|array<>

参照画像。省略するとテキストから生成します。各画像は 30 MB 以下です。枚数制限はモデル差異ページを参照してください。レイヤー分解は単一画像のみ受け付けます。

size?string

解像度プリセットまたは WIDTHxHEIGHT。選択肢と既定値はモデル差異ページを参照してください。

optimize_prompt_options?

output_format?string

画像形式。レイヤー分解ではベース画像のみに適用され、レイヤーは常に PNG です。

デフォルト値"jpeg"

指定可能な値

"png"
"jpeg"

background?string

透過モードはアルファチャンネルを持つ単一入力画像にのみ使用でき、PNG を出力します。

デフォルト値"opaque"

指定可能な値

"opaque"
"transparent"

response_format?string

画像 URL または Base64 データを返します。

デフォルト値"url"

指定可能な値

"url"
"b64_json"

watermark?boolean

AI 生成ウォーターマークを付けるかどうか。

デフォルト値true

layer_decomposition?boolean

画像をベース画像と独立したレイヤーに分解します。一部モデルのみ対応します。

デフォルト値false

sequential_image_generation?string

組画像モード。auto ではモデルが組画像を生成するか判断します。

デフォルト値"disabled"

指定可能な値

"disabled"
"auto"

sequential_image_generation_options?

stream?boolean

生成画像を 1 枚ずつ返します。一部モデルのみ対応します。

デフォルト値false

tools?array<>

ウェブ検索ツール。一部モデルのみ対応します。

レスポンスボディ

`application/json`

type*string

model?string

実際に使用したモデル ID。

created?integer

秒単位の Unix タイムスタンプ。

範囲0 <= value

image_index*integer

0 始まりの画像番号。

範囲0 <= value

url?string

一時的なダウンロード URL。24 時間以内に保存してください。

形式uri

b64_json?string

画像の Base64 データ。

size?string

WIDTHxHEIGHT 形式の実際の出力サイズ。

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "木製デスクに置いた白いマグカップの写真。左側から柔らかい窓の光が差し込む。"
  }'

{
  "created": 1793980674,
  "data": [
    {
      "url": "https://example.com/result.jpeg"
    }
  ]
}

編集例の URL は前の手順で生成した画像の URL に置き換えられます。Base64 を使う場合は BASE64_BYTES を実際の画像データで置き換え、画像形式に合った Data URL プレフィックスを維持してください。

Volcengine 画像生成 APIAPI フィールド、応答、機能別ガイドを確認します。

認証

リクエストボディ

レスポンスボディ

200application/json

400application/json

401application/json

403application/json

ストリーミング応答イベント

`application/json`

`application/json`

`application/json`