对话

OpenAI 协议（GPT）

OpenAI Chat Completions / Responses 兼容。用于 GPT 系列，以及 DeepSeek、GLM 等模型。

接口地址

用途	方法	路径
对话（REST + SSE）	POST	/v1/chat/completions
Codex（Responses）	POST	/v1/responses
模型列表	GET	/v1/models

认证

Authorization: Bearer <API_KEY>
Content-Type: application/json

支持的模型

gpt-*（如 gpt-4o）、deepseek-*、glm-*（如 glm-5.2）等。具体以 GET /v1/models 为准。

请求参数

参数	类型	必填	说明
model	string	必填	模型名，如 gpt-4o
messages	array	必填	对话消息（role/content）
stream	boolean	—	true 走 SSE；建议带 stream_options.include_usage=true 以拿到 usage
temperature / top_p	number	—	采样控制
max_tokens / max_completion_tokens	integer	—	最大输出
tools / tool_choice	—	—	工具调用

流式请求（SSE）

加 "stream": true 与 "stream_options": {"include_usage": true}，用 curl -N 接收 SSE。事件 data: {chunk}，末尾 data: [DONE]；usage 在含 usage 的最终 chunk。

请求示例

非流式

curl -X POST "https://api.cqtai.com/v1/chat/completions" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role":"user","content":"你好，介绍一下你自己"}]
  }'

流式（SSE，带 usage）

curl -N -X POST "https://api.cqtai.com/v1/chat/completions" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "stream": true,
    "stream_options": {"include_usage": true},
    "messages": [{"role":"user","content":"写一首关于夏天的短诗"}]
  }'

响应示例

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "gpt-4o",
  "choices": [
    { "index": 0, "message": { "role": "assistant", "content": "你好！……" }, "finish_reason": "stop" }
  ],
  "usage": { "prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21 }
}

图像生成

图像生成（GPT-Image · 同步）NEW

同一套 OpenAI 协议除对话外，还提供同步生图：一次请求直接返回图片（url 或 b64_json），无 taskId、无需轮询。已在用 OpenAI SDK / images 接口的开发者可直接对接。

接口地址

用途	方法	路径
文生图	POST	/v1/images/generations
图生图（multipart）	POST	/v1/images/edits
变体（multipart）	POST	/v1/images/variations

支持的模型

gpt-image-1 / gpt-image-1.5 / gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst。

请求参数

参数	类型	必填	说明
model	string	必填	gpt-image-1 / gpt-image-1.5 / gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst
prompt	string	必填	图片描述
size	string	—	输出尺寸（官方像素，默认 1024x1024）
response_format	string	—	url（返回我方 CDN 直链，稳定可长期访问，不会短时过期）或 b64_json（内联图片数据，gpt-image-1 常返此项）

⚠ 本同步渠道与异步 sora 渠道（POST /api/cqt/generator/sora）的计费口径不同，同一个模型在两条链路上的单价可能不一样，请以定价页为准。图生图 / 变体走 multipart 的 /v1/images/edits、/v1/images/variations。

请求示例

文生图（同步）

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"
  }'

图生图 / 图片编辑（multipart）

# 图生图走 /v1/images/edits，multipart/form-data 上传参考图（字段 image[]，可多张）
# 可选 mask 蒙版做局部重绘；不要带 Content-Type: application/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"

图片变体（multipart）

# 变体走 /v1/images/variations，无 prompt，基于参考图生成风格相近的变体
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://.../image.png" }
  ]
}

💰 价格见定价页 →