curl --request POST \
  --url https://kaienapi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image",
  "prompt": "一张干净的产品海报"
}
'

{
  "created": 123,
  "data": [
    {}
  ],
  "usage": {}
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

生成图片

OpenAI Images 兼容的同步图片生成接口。新接入优先使用 POST /v1/images/generations/jobs 创建异步任务；同步接口主要用于短耗时请求、兼容旧客户端或必须直接等待结果的场景。

GPT Image 2 同步兼容

gpt-image-2、gpt-image-2-2K 和 gpt-image-2-4K 均支持本同步接口。服务会在内部创建异步任务并等待完成；客户端超时较短、批量并发或需要可靠轮询时，请改用 POST /v1/images/generations/jobs。

请求格式

使用 application/json。基础请求包含 model 和 prompt。

典型用法

文生图：传 prompt、尺寸、质量和输出格式。
透明素材：background=transparent，输出格式选择 PNG。
网络 URL 参考图改图：将公网图片地址放入 JSON 的 image 字段。
多图参考：image 传 URL 数组，顺序按页面含义或用户排序保持一致。

URL 参考图推荐

需要用 OSS/CDN 图片 URL 做参考图创作、换装、合成或改图时，推荐使用异步任务接口 /v1/images/generations/jobs。同步接口也兼容同样的 JSON image 数组，但客户端需要一直等待结果。大图建议先通过 OSS/CDN 图片处理 resize 到合适分辨率后提交。

OpenAI 兼容格式

图片模型使用 model、prompt、size、quality、format、image 等字段提交。部分模型不支持 n 批量生成；需要多张结果时可发起多次异步任务。

读取结果

响应可能返回图片 URL 或 b64_json。接入时按所用接口分别解析；需要长期访问或统一域名时，再保存到对象存储。

错误定位

长时间等待或客户端超时：改用 /v1/images/generations/jobs 异步任务。
参考图无法读取：确认 URL 能公网访问，且图片未过期。
尺寸报错：检查宽高、像素总量和模型尺寸范围。
没有图片字段：保留完整响应，再按真实返回结构解析。

POST

images

generations

curl --request POST \
  --url https://kaienapi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image",
  "prompt": "一张干净的产品海报"
}
'

{
  "created": 123,
  "data": [
    {}
  ],
  "usage": {}
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

在请求头中传入：Authorization: Bearer sk-...

Body

application/json

OpenAI Images 兼容的图片生成请求。新接入优先提交到 /v1/images/generations/jobs 创建异步任务；短耗时或兼容旧客户端时也可提交到 /v1/images/generations。gpt-image-2、gpt-image-2-2K 和 gpt-image-2-4K 均支持同步与异步生成；同步请求会在服务内部等待异步任务完成。边聊边出图或图片理解场景通常使用 /v1/chat/completions。

model

string

required

图片模型 ID。gpt-image-2、gpt-image-2-2K 和 gpt-image-2-4K 均支持同步与异步生成。不同模型的尺寸、质量、格式和参考图规则以模型页说明为准。

Example:

"qwen-image"

prompt

string

required

图片生成描述。说明主体、画面环境、风格、构图、文字要求和需要避开的内容；使用参考图时，同时说明每张参考图的用途。

Example:

"一张干净的产品海报，白色背景，柔和光线"

integer

生成图片数量。常见范围为 1 到 10，具体上限由模型决定。多张图片会按数量计费。

Required range: x >= 1

Example:

1

size

string

图片尺寸。常见值包括 auto、1024x1024、1536x1024、1024x1536、2048x2048、2048x1152、2160x3840。gpt-image-2-2K 与 gpt-image-2-4K 的 size 必须为 WIDTHxHEIGHT，宽高均为正数且是 16 的倍数，最长边不超过 3840px，宽高比不超过 3:1，总像素范围为 655,360 至 8,294,400；最大横图为 3840x2160，最大竖图为 2160x3840，最大方图为 2880x2880。其他模型以模型说明为准。

Example:

"1024x1024"

quality

string

生成质量。常见值：auto、standard、hd、high、medium、low。高清或高档位通常耗时更长，价格也可能不同。

Example:

"auto"

style

string

风格字段。豆包图片常见值为 vivid、natural；其他模型可能忽略该字段。

Example:

"vivid"

response_format

enum<string>

返回图片格式。url 表示返回图片地址，b64_json 表示返回 base64。部分新模型固定返回某一种格式，会忽略该字段。

Available options:

url,

b64_json

image

参考图 URL。可传单个公网图片地址或 URL 数组。gpt-image-2-2K 与 gpt-image-2-4K 最多支持 8 张参考图，传入 9 张或更多会失败。需要用网络 URL 做参考图创作、换装、合成或改图时，推荐使用 /v1/images/generations/jobs 的 image 数组，例如 qwen-image-edit 的 OSS/CDN 图片模式。

Example:

["https://example.com/source.png"]

background

string

背景模式。透明背景模型会读取该字段，常见值为 transparent、opaque、auto。透明 PNG 搭配 png 输出格式使用。

Example:

"transparent"

moderation

string

内容审核强度。常见值为 auto、low，是否生效以模型说明为准。

Example:

"auto"

output_format

string

输出图片格式，例如 png、jpeg、webp。不同模型可能使用 output_format 或 format 字段。

Example:

"png"

format

string

图片格式字段，常见值为 png、jpeg、webp。

Example:

"png"

output_compression

integer

输出压缩质量，范围 0 到 100。jpeg 或 webp 输出会读取该字段；png 输出一般忽略。

Required range: 0 <= x <= 100

Example:

80

partial_images

integer

流式或渐进生成时返回的阶段图片数量。只有阶段图模型会读取该字段。

Example:

1

watermark

boolean

是否添加水印。只有水印模型会读取该字段。

Example:

false

user

string

终端用户标识，供审计、风控或请求追踪使用。

Example:

"user-123"

negative_prompt

string

部分图片模型会读取反向提示词，作为模型扩展参数提交。

Example:

"低清晰度、畸形文字"

aspect_ratio

string

部分图片模型会读取比例参数，作为模型扩展参数提交。使用 Chat Completions 时，也兼容 Chat 请求顶层 aspect_ratio。

Example:

"16:9"

image_size

string

部分模型使用 image_size 而不是 size，作为模型扩展参数提交。使用 Chat Completions 时，也兼容 Chat 请求顶层 image_size 或 resolution。

Example:

"1024x1024"

seed

integer

部分模型会读取固定随机种子，作为模型扩展参数提交。

Example:

12345

Response

图片结果

created

integer

data

object[]

usage

object

图片编辑兼容别名创建异步图片生成任务

开始使用

图片和视频

AI 工具接入

API Reference

生成图片

GPT Image 2 同步兼容

请求格式

推荐方式

典型用法

URL 参考图推荐

OpenAI 兼容格式

读取结果

错误定位

Authorizations

Body

Response