创建／编辑图片

POST/v1/images/generations

同步生成或编辑图片。传入 image 时按提示词编辑参考图。

Authorization

bearerAuth

AuthorizationBearer <token>

使用平台 API Key。

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model*string

平台模型 ID。

prompt*string

描述要生成的画面，或要对参考图执行的编辑。

Length1 <= length

image?|array<>

参考图，最多 3 张。单图不超过 10 MB，长短边比例不超过 10:1，宽高各为 1–8000 像素。文生图省略该字段，传 null 或空数组会报错。

n?integer

输出图片数量。

Range1 <= value <= 6

Default1

size?string

输出尺寸，使用宽x高或 auto。省略时由模型选择。总像素数为 512×512 至 2048×2048，宽高比为 1:8 至 8:1。

negative_prompt?string

描述不希望出现在画面中的内容。

seed?integer

随机种子。

Range0 <= value <= 2147483647

prompt_extend?boolean

是否增强提示词。

Defaulttrue

prompt_extend_mode?string

提示词增强模式。agent 仅用于文生图，用于图生图会返回 400。

Default"direct"

Value in

"direct"
"agent"

enable_thinking?boolean

是否开启思考。仅在 prompt_extend 为 true 时生效。

Defaulttrue

watermark?boolean

是否添加水印。

Defaultfalse

response_format?string

响应始终返回图片 URL。传入 b64_json 会被忽略。

Response Body

`application/json`

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": 1793980667,
  "data": [
    {
      "url": "https://example.com/result.png"
    }
  ]
}

图生图示例中的 URL 可替换为前一步生成的图片链接。使用 Base64 时，请将 BASE64_BYTES 换成实际图片数据，并保留与图片格式一致的 Data URL 前缀。

百炼千问图像生成与编辑 API查看 OpenAI 兼容接口的字段与返回格式。

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`