圖片

生成圖片

從文字提示生成圖片。預設回傳 OpenAI 相容的同步 JSON(可直接搭配 client.images.generate());傳 stream: true 則改回傳 SSE 事件串流。也支援以 inputImages / input_references 做圖生圖(i2i)。

POST/api/v1/images/generations

驗證

Authorization必填

string · header

在 Authorization 標頭以 Bearer token 傳入 API 金鑰。

Body

model必填

string

要使用的圖片生成模型,供應商前綴格式,例如 "openai/gpt-image-2"。

minLength: 1

Example: "openai/gpt-image-2"

prompt必填

string

想生成的圖片的文字描述。

minLength: 1

Example: "a red cat on a sofa"

n

integer

要生成的圖片數量,1–10。

1–10

Example: 1

size

string

圖片尺寸——明確像素("2048x2048")或層級("2K"、"4K")。原樣轉發給供應商;支援的尺寸依模型而定。

Example: "1024x1024"

stream

boolean

選擇回應形狀:省略或 false = OpenAI 相容同步 JSON(預設),true = SSE 事件串流。

input_references

string[]

圖生圖(i2i)的來源圖片(data: 或 https: URL),最多 8 張。與 inputImages 是同一欄位的別名(相容業界慣用欄位名);兩者都會先經過內容審查。該模型路由不支援 i2i 時回 400(不是 warnings)。

≤ 8 images

aspect_ratio

enum<string>

生成圖片的長寬比。部分模型的路由原生支援——各模型實際支援的參數請查 GET /api/v1/images/models 回應中的 supported_parameters;不支援的路由會忽略此欄位並在回應的 warnings[] 中註明(請求仍會成功)。

1:11:21:41:82:12:33:23:44:14:34:55:48:19:1616:99:19.519.5:99:2020:99:2121:9auto

Example: "16:9"

resolution

enum<string>

解析度層級;實際像素由供應商換算。部分模型的路由原生支援——各模型實際支援的參數請查 GET /api/v1/images/models 回應中的 supported_parameters;不支援的路由會忽略此欄位並在回應的 warnings[] 中註明(請求仍會成功)。

5121K2K4K

Example: "2K"

quality

enum<string>

渲染品質。部分模型的路由原生支援——各模型實際支援的參數請查 GET /api/v1/images/models 回應中的 supported_parameters;不支援的路由會忽略此欄位並在回應的 warnings[] 中註明(請求仍會成功)。

autolowmediumhigh

background

enum<string>

背景處理;transparent 需搭配支援 alpha 的 output_format(png/webp)。部分模型的路由原生支援——各模型實際支援的參數請查 GET /api/v1/images/models 回應中的 supported_parameters;不支援的路由會忽略此欄位並在回應的 warnings[] 中註明(請求仍會成功)。

autotransparentopaque

output_format

enum<string>

回傳圖片的編碼格式。部分模型的路由原生支援——各模型實際支援的參數請查 GET /api/v1/images/models 回應中的 supported_parameters;不支援的路由會忽略此欄位並在回應的 warnings[] 中註明(請求仍會成功)。

pngjpegwebpsvg

Example: "png"

output_compression

integer

webp/jpeg 的壓縮等級(0–100);png 忽略。部分模型的路由原生支援——各模型實際支援的參數請查 GET /api/v1/images/models 回應中的 supported_parameters;不支援的路由會忽略此欄位並在回應的 warnings[] 中註明(請求仍會成功)。

0–100

Example: 100

seed

integer

確定性取樣種子;相同種子+參數應得到相同結果,但並非所有供應商都保證。部分模型的路由原生支援——各模型實際支援的參數請查 GET /api/v1/images/models 回應中的 supported_parameters;不支援的路由會忽略此欄位並在回應的 warnings[] 中註明(請求仍會成功)。

深度指南 →

POST /api/v1/images/generations

1
2
3
4
5
6
7
8
curl https://bazaarlink.ai/api/v1/images/generations \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "a red cat on a sofa",
    "size": "1024x1024"
  }'

回應範例

成功。預設(或 stream: false)回傳如下同步 JSON;stream: true 時回傳 SSE 事件串流(事件協定見深度指南)。若有參數被該路由忽略,會出現在頂層 warnings[](僅提示,不影響結果)。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "created": 1753500000,
  "data": [
    {
      "url": "https://bazaarlink.ai/api/v1/images/proxy/eyJhbGciOi..."
    }
  ],
  "warnings": [
    {
      "param": "aspect_ratio",
      "action": "dropped",
      "reason": "'aspect_ratio' is not yet mapped for this model's upstream and was ignored; the image was still generated using the model's default."
    }
  ]
}