CQTAI
GPT-Image · 图片

同步调用（GPT-Image）NEW

📌 这是什么：用 OpenAI Images 协议同步生图：一次请求直接返回图片（url 或 b64_json），无需轮询。
💡 什么时候用：想同步拿结果（不轮询），或已在用 OpenAI SDK / images 接口时用。
⚡ 同步调用：该同步接口采用 OpenAI Images 协议，与异步 sora 渠道（POST /api/cqt/generator/sora）并行提供，一次请求直接返回图片，无 taskId / 无需轮询。⚠ 计费口径与异步 sora 渠道不同：此同步渠道 gpt-image-1 / 1.5 / 2 均 6 积分/张；异步 sora 渠道为 4 / 6 / 12。本页共 3 个端点：文生图 POST /v1/images/generations（JSON，见下）、图生图（图片编辑）POST /v1/images/edits、图片变体 POST /v1/images/variations（后两者走 multipart，端点详情见页面下方分节）。

接口地址

用途方法路径
同步调用POST/v1/images/generations
🔗 协议：OpenAI Images 协议 · 文生图 · 一次请求直接返回结果，无 taskId、无需轮询

请求参数

参数类型必填说明
modelstring必填gpt-image-1 / gpt-image-1.5 / gpt-image-2（均 6 积分/张）
promptstring必填图片描述
sizestring—输出尺寸（官方像素，默认 1024x1024）
response_formatstring—url（返回我方 CDN 直链，稳定可长期访问，不会短时过期）或 b64_json（内联图片数据，gpt-image-1 常返此项）

请求示例

curl -X POST https://api.cqtai.com/v1/images/generations \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a red panda astronaut, studio lighting",
    "size": "1024x1024"
  }'
# -> { "created": 1710000000, "data": [{ "url": "https://.../image.png" }] }

响应示例

{
  "created": 1710000000,
  "data": [
    { "url": "https://.../image.png" }
  ]
}

图生图（图片编辑）

基于一张或多张参考图 + 文字提示重绘 / 编辑生成新图（可选 mask 局部重绘）。走 multipart/form-data，参考图以文件字段 image[] 上传。计费同 6 积分/张（gpt-image-1 / 1.5 / 2）。

POST/v1/images/editsmultipart/form-data
参数类型必填说明
modelstring必填gpt-image-1 / gpt-image-1.5 / gpt-image-2（均 6 积分/张）
image[]file必填参考图文件（可传多张，字段名重复 image[]）。png / jpg / webp
promptstring必填编辑 / 重绘描述
maskfile—可选。局部重绘蒙版（透明区域为待重绘区域），尺寸需与参考图一致
sizestring—输出尺寸（官方像素，默认 1024x1024）
response_formatstring—url（我方 CDN 直链）或 b64_json（内联图片数据）
curl -X POST https://api.cqtai.com/v1/images/edits \
  -H 'Authorization: Bearer <API_KEY>' \
  -F model=gpt-image-2 \
  -F image[]=@input.png \
  -F prompt='add a red hat on the cat' \
  -F size=1024x1024
# -> { "created": 1710000000, "data": [{ "url": "https://.../edited.png" }] }

图片变体

不带提示词，基于一张参考图生成风格相近的变体图。走 multipart/form-data，参考图以文件字段 image[] 上传。计费同 6 积分/张（gpt-image-1 / 1.5 / 2）。

POST/v1/images/variationsmultipart/form-data
参数类型必填说明
modelstring必填gpt-image-1 / gpt-image-1.5 / gpt-image-2（均 6 积分/张）
image[]file必填参考图文件（单张）。png / jpg / webp
sizestring—输出尺寸（官方像素，默认 1024x1024）
response_formatstring—url（我方 CDN 直链）或 b64_json（内联图片数据）
curl -X POST https://api.cqtai.com/v1/images/variations \
  -H 'Authorization: Bearer <API_KEY>' \
  -F model=gpt-image-2 \
  -F image[]=@input.png \
  -F size=1024x1024
# -> { "created": 1710000000, "data": [{ "url": "https://.../variation.png" }] }

计费与积分

gpt-image-1 / gpt-image-1.5 / gpt-image-2 均 6 积分/张（此同步渠道口径，与异步 sora 渠道 4/6/12 不同）（× 你的用户费率）。任务失败自动退回。