跳到主要内容

图像生成

OpenAI Images 格式的文生图与图片编辑接口。不同渠道支持的模型(DALL·E 3、GPT-Image、Seedream 等)参数略有差异,以下为通用字段。

生成图片​

POST /v1/images/generations
请求REQUEST
POSThttps://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"
}'

请求体参数​

参数类型必填说明
modelstring否默认 dall-e-2;可用 dall-e-3、gpt-image-1 等
promptstring是画面描述,DALL·E 3 最长 4000 字符
ninteger否生成张数 1–10(DALL·E 3 仅支持 1)
sizestring否分辨率:1024x1024 / 1792x1024 / 1024x1792(DALL·E 3);256/512/1024x1024(DALL·E 2);auto/1024x1536/1536x1024(GPT-Image)
qualitystring否standard / hd(DALL·E 3);low/medium/high/auto(GPT-Image)
response_formatstring否url(默认)或 b64_json(GPT-Image 固定返回 b64)
stylestring否DALL·E 3 专属:vivid / natural
seedinteger否随机种子

响应​

{
"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"
字段类型必填说明
imagefile是原图(png/jpeg/webp,GPT-Image 可传多张 image[])
promptstring是编辑指令
maskfile否透明区域为可编辑区域的蒙版(DALL·E 2)
modelstring否gpt-image-1 / dall-e-2
n / size / quality-否同生成接口

旧版接口​

POST /v1/images/variations(以原图生成变体,DALL·E 2)与 POST /v1/edits(旧路径)均已透传,参数同上,仅在兼容旧代码时使用。

提示

Nano Banana(Gemini 图像)等模型通过 OpenAI 格式调用时,model 填对应名称即可,未识别的参数会被透传给上游。