图像生成
OpenAI Images 格式的文生图与图片编辑接口。不同渠道支持的模型(DALL·E 3、GPT-Image、Seedream 等)参数略有差异,以下为通用字段。
生成图片
POST /v1/images/generations请求REQUEST
POST
https://test.kailin.com.cn/v1/images/generations返回 url 为临时地址,请及时转存;b64_json 模式返回体积较大,渲染会稍慢。
响应RESPONSE
填写参数并发送请求,响应会显示在这里
请求
curl https://test.kailin.com.cn/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的令牌" \
-d '{
"model": "dall-e-3",
"prompt": "赛博朋克风格的城市夜景,霓虹灯,雨后倒影",
"n": 1,
"size": "1024x1792"
}'
请求体参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 否 | 默认 dall-e-2;可用 dall-e-3、gpt-image-1 等 |
prompt | string | 是 | 画面描述,DALL·E 3 最长 4000 字符 |
n | integer | 否 | 生成张数 1–10(DALL·E 3 仅支持 1) |
size | string | 否 | 分辨率:1024x1024 / 1792x1024 / 1024x1792(DALL·E 3);256/512/1024x1024(DALL·E 2);auto/1024x1536/1536x1024(GPT-Image) |
quality | string | 否 | standard / hd(DALL·E 3);low/medium/high/auto(GPT-Image) |
response_format | string | 否 | url(默认)或 b64_json(GPT-Image 固定返回 b64) |
style | string | 否 | DALL·E 3 专属:vivid / natural |
seed | integer | 否 | 随机种子 |
响应
{
"created": 1730000000,
"data": [
{
"url": "https://oss.example.com/img/abc.png",
"revised_prompt": "赛博朋克风格的城市夜景……"
}
]
}
response_format: "b64_json" 时 data[].b64_json 为 Base64 图片数据。url 结果为上游临时地址,有效期有限,请及时转存。
编辑图片
POST /v1/images/edits以 multipart/form-data 上传原图,按提示词修改(GPT-Image / DALL·E 2 支持):
curl https://test.kailin.com.cn/v1/images/edits \
-H "Authorization: Bearer sk-你的令牌" \
-F "model=gpt-image-1" \
-F "prompt=把背景换成黄昏的海边" \
-F "image=@/path/to/input.png"
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
image | file | 是 | 原图(png/jpeg/webp,GPT-Image 可传多张 image[]) |
prompt | string | 是 | 编辑指令 |
mask | file | 否 | 透明区域为可编辑区域的蒙版(DALL·E 2) |
model | string | 否 | gpt-image-1 / dall-e-2 |
n / size / quality | - | 否 | 同生成接口 |
旧版接口
POST /v1/images/variations(以原图生成变体,DALL·E 2)与 POST /v1/edits(旧路径)均已透传,参数同上,仅在兼容旧代码时使用。
提示
Nano Banana(Gemini 图像)等模型通过 OpenAI 格式调用时,model 填对应名称即可,未识别的参数会被透传给上游。