建立圖片

可依模型功能控制回傳數量、尺寸、品質、風格與回傳格式。

POST/v1/images/generations

根據文字提示生成一張或多張圖片。你可以透過提示詞描述主體、場景、構圖、視角、藝術風格和整體氛圍，再使用模型支援的尺寸、品質及回傳格式控制結果。

模型可用範圍以及 n、quality、size、style 等參數的實際約束取決於所選模型。請使用目前 API Key 可見且支援圖片生成的模型 ID。

授權

bearerAuth

授權Bearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

傳遞位置: header

請求主體

application/json

圖片生成請求參數。

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

model?string

要使用的圖片生成模型 ID。請選擇目前 API Key 可見且支援圖片生成的模型；不同模型支援的參數和限制可能不同。

長度1 <= length

prompt*string

期望生成圖片的文字描述。建議明確主體、關鍵視覺元素、構圖、視角、藝術風格和氛圍。

DALL·E 2 最多接受 1,000 個字元，DALL·E 3 最多接受 4,000 個字元；其他模型的限制以其實際能力為準。若生成失敗，請同時檢查提示詞是否符合內容政策。

長度1 <= length

n?integer|null

要生成的圖片數量，取值範圍為 1 到 10。DALL·E 3 僅支援 n=1，其他模型是否支援多圖回傳取決於其實際能力。

範圍1 <= value <= 10

預設值1

quality?string

圖片品質。hd 可生成更細緻和一致的圖片，且僅適用於 DALL·E 3；其他模型可能使用不同取值。

預設值"standard"

可用值

"standard"
"hd"

response_format?string|null

圖片回傳格式。url 回傳暫時圖片網址，此網址在生成後 60 分鐘內有效；b64_json 回傳 Base64 編碼圖片資料。

預設值"url"

可用值

"url"
"b64_json"
null

size?string|null

圖片尺寸。DALL·E 2 支援 256x256、512x512、1024x1024，DALL·E 3 支援 1024x1024、1792x1024、1024x1792。

預設值"1024x1024"

可用值

"256x256"
"512x512"
"1024x1024"
"1792x1024"
"1024x1792"
null

style?string|null

圖片風格。vivid 偏向超現實和戲劇化效果，natural 偏向自然真實的表現。此參數僅適用於 DALL·E 3。

預設值"vivid"

可用值

"vivid"
"natural"
null

user?string

代表終端使用者的唯一識別碼，可用於監控和偵測濫用行為。

長度1 <= length

回應主體

`application/json`

curl -X POST "https://example.com/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "一隻可愛的小海獺在清澈的水中嬉戲，柔和自然光，細節清晰",    "n": 1,    "size": "1024x1024"  }'

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "revised_prompt": "一隻可愛的小海獺在清澈的水中嬉戲，它有圓圓的眼睛和毛茸茸的皮毛。"
    }
  ]
}

授權

請求主體

回應主體

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`