建立／編輯圖片

POST/v1/images/generations

根據提示詞生成圖片，或在同一個 JSON 請求中通過 image 提交參考圖進行編輯。

授權

bearerAuth

授權Bearer <token>

使用平台 API Key。

傳遞位置: header

請求主體

application/json

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

model*string

平台模型 ID。

prompt?string

圖片生成或編輯指令。僅在圖層拆分模式下可省略。

長度1 <= length

image?|array<>

參考圖。省略時為文生圖。生成和編輯場景單張圖片不超過 30 MB，參考圖數量見型號差異頁。圖層拆分只接收單圖。

size?string

分辨率檔位或寬x高。可選值和預設值見型號差異頁。

optimize_prompt_options?

output_format?string

圖片文件格式。圖層拆分時僅控制底圖，圖層始終為 PNG。

預設值"jpeg"

可用值

"png"
"jpeg"

background?string

透明模式僅用於單張帶透明通道的輸入圖，輸出為 PNG。

預設值"opaque"

可用值

"opaque"
"transparent"

response_format?string

回傳圖片鏈接或 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

逐張回傳生成結果，僅部分型號支持。

預設值false

tools?array<>

聯網搜索工具，僅部分型號支持。

回應主體

`application/json`

type*string

model?string

實際使用的模型 ID。

created?integer

Unix 時間戳，單位為秒。

範圍0 <= value

image_index*integer

圖片序號，從 0 開始。

範圍0 <= value

url?string

生成圖片的臨時下載地址，請在 24 小時內保存。

格式uri

b64_json?string

生成圖片的 Base64 數據。

size?string

實際輸出尺寸，格式為寬x高。

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 可替換為前一步生成的圖片鏈接。使用 Base64 時，請將 BASE64_BYTES 換成實際圖片數據，並保留與圖片格式一致的 Data URL 前綴。

火山方舟圖片生成 API查看介面欄位、回應和專項指南。

授權

請求主體

回應主體

200application/json

400application/json

401application/json

403application/json

串流回應事件

`application/json`

`application/json`

`application/json`