图片

生成图片

从文本提示生成图片。默认返回 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."
    }
  ]
}