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。
推荐方式
图片生成可能耗时较长。页面、移动端、Serverless、队列 worker、批量并发和参考图改图场景，推荐调用 /v1/images/generations/jobs，保存返回的任务 ID，再轮询 /v1/images/generations/jobs/{job_id} 查询结果。
典型用法
- 文生图：传 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 能公网访问，且图片未过期。
- 尺寸报错：检查宽高、像素总量和模型尺寸范围。
- 没有图片字段：保留完整响应，再按真实返回结构解析。
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>"
}
}授权
在请求头中传入：Authorization: Bearer sk-...
请求体
OpenAI Images 兼容的图片生成请求。新接入优先提交到 /v1/images/generations/jobs 创建异步任务；短耗时或兼容旧客户端时也可提交到 /v1/images/generations。gpt-image-2、gpt-image-2-2K 和 gpt-image-2-4K 均支持同步与异步生成；同步请求会在服务内部等待异步任务完成。边聊边出图或图片理解场景通常使用 /v1/chat/completions。
图片模型 ID。gpt-image-2、gpt-image-2-2K 和 gpt-image-2-4K 均支持同步与异步生成。不同模型的尺寸、质量、格式和参考图规则以模型页说明为准。
"qwen-image"
图片生成描述。说明主体、画面环境、风格、构图、文字要求和需要避开的内容；使用参考图时，同时说明每张参考图的用途。
"一张干净的产品海报，白色背景，柔和光线"
生成图片数量。常见范围为 1 到 10，具体上限由模型决定。多张图片会按数量计费。
x >= 11
图片尺寸。常见值包括 auto、1024x1024、1536x1024、1024x1536、2048x2048、2048x1152、2160x3840。基础模型 gpt-image-2 只按 size 最长边选档：不超过 1792px 为 1K，1793px 至 2688px 为 2K，2689px 至 3840px 为 4K；其他图片档位兼容字段不参与 GPT Image 2 选档。gpt-image-2-2K 与 gpt-image-2-4K 的 size 必须为 WIDTHxHEIGHT，宽高均为正数且是 16 的倍数，最长边不超过 3840px，宽高比不超过 3:1，总像素范围为 655,360 至 8,294,400；最大横图为 3840x2160，最大竖图为 2160x3840，最大方图为 2880x2880。其他模型以模型说明为准。
"1024x1024"
生成质量。常见值：auto、standard、hd、high、medium、low。高清或高档位通常耗时更长，价格也可能不同。
"auto"
风格字段。豆包图片 常见值为 vivid、natural；其他模型可能忽略该字段。
"vivid"
返回图片格式。url 表示返回图片地址，b64_json 表示返回 base64。部分新模型固定返回某一种格式，会忽略该字段。
url, b64_json 参考图。可传单个公网图片 URL 或数组。异步任务接口也接受 data:image/png;base64,... 等 Base64 Data URL，或不带前缀的标准 Base64；服务会流式解码并上传到临时图片存储，再使用图片 URL 执行任务。支持 PNG、JPEG、WebP、GIF。默认每张解码后最多 10 MiB，每次最多上传 14 张 Base64 图片、合计 64 MiB，实际限制以服务配置和模型为准。不同请求分别创建任务，同一请求中的重复图片不会合并。gpt-image-2-2K 与 gpt-image-2-4K 最多支持 8 张参考图，传入 9 张或更多会失败。image、image[]、images 三种参考图字段不要同时使用。
["https://example.com/source.png"]
参考图普通字符串数组或 image_url 对象数组，作为 image 的兼容写法。可以传 images: ["https://example.com/a.png", "data:image/png;base64,..."]。异步任务支持 Base64 和公网 URL 混合，按数组顺序处理每张图片，不去重。Base64 输入与 response_format 输出格式无关。不要同时传 image 或 image[]。
公网图片 URL 或异步任务接口支持的 Base64 图片。
[
"https://example.com/source.png",
"data:image/png;base64,<BASE64_IMAGE>"
]
背景模式。透明背景模型会读取该字段，常见值为 transparent、opaque、auto。透明 PNG 搭配 png 输出格式使用。
"transparent"
内容审核强度。常见值为 auto、low，是否生效以模型说明为准。
"auto"
输出图片格式，例如 png、jpeg、webp。不同模型可能使用 output_format 或 format 字段。
"png"
图片格式字段，常见值为 png、jpeg、webp。
"png"
输出压缩质量，范围 0 到 100。jpeg 或 webp 输出会读取该字段；png 输出一般忽略。
0 <= x <= 10080
流式或渐进生成时返回的阶段图片数量。只有阶段图模型会读取该字段。
1
是否添加水印。只有水印模型会读取该字段。
false
终端用户标识，供审计、风控或请求追踪使用。
"user-123"
部分图片模型会读取反向提示词，作为模型扩展参数提交。
"低清晰度、畸形文字"
部分图片模型会读取比例参数，作为模型扩展参数提交。使用 Chat Completions 时，也兼容 Chat 请求顶层 aspect_ratio。
"16:9"
部分图片模型使用的兼容档位或扩展尺寸字段。具体是否生效以及与其他尺寸字段的优先级，以对应模型文档为准。
"2K"
部分模型会读取固定随机种子，作为模型扩展参数提交。
12345