CQTAI
对话

Gemini 协议即将上线

Google Gemini generateContent 兼容。文本能力已实现、灰度联调中，暂未对外开放。

⏳ 该模型暂未上线，以下为预览文档。上线后即可调用，请关注公告。

接口地址

用途方法路径
非流式POST/v1beta/models/{model}:generateContent
流式（SSE）POST/v1beta/models/{model}:streamGenerateContent

认证

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

支持的模型

gemini-*（即将上线）

请求参数

参数类型必填说明
contentsarray必填多轮对话（role/parts）
systemInstructionobject—系统指令
generationConfigobject—temperature/topP/maxOutputTokens 等
tools——工具/函数调用

流式请求（SSE）

使用 :streamGenerateContent 端点，SSE 流式返回。

请求示例

非流式

curl -X POST "https://api.cqtai.com/v1beta/models/gemini-1.5-pro:generateContent" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role":"user","parts":[{"text":"你好，介绍一下你自己"}]}]
  }'
图像生成

图像生成（Nano · 同步）NEW

文本对话虽在灰度中，但同一套 Gemini 原生 generateContent 端点的**同步生图已对外可用**：传图像模型 + generationConfig.responseModalities 含 "IMAGE"，一次请求直接返回 base64 图片，无 taskId、无需轮询。对外「Nano 档位」即由这些 Gemini 生图模型承载。提交支持两种格式：默认 JSON（Gemini 原生协议）、以及 multipart/form-data 便捷上传（用文件字段 image 直接上传参考图做图生图，见下方示例）。

接口地址

用途方法路径
同步生图POST/v1beta/models/{model}:generateContent

支持的模型

gemini-2.5-flash-image（Nano，10 积分，1K）/ gemini-3-pro-image-preview（Nano Pro，20 积分，1K/2K/4K）/ gemini-3.1-flash-image-preview（Nano 2，20 积分，1K/2K/4K）。

请求参数

参数类型必填说明
{model}path必填URL 路径中的模型 id（档位映射）：gemini-2.5-flash-image（Nano，10 积分，1K）/ gemini-3-pro-image-preview（Nano Pro，20 积分，1K/2K/4K）/ gemini-3.1-flash-image-preview（Nano 2，20 积分，1K/2K/4K）
contentsarray必填Gemini 原生对话内容数组；每个元素含 role 与 parts[]。文生图通常只需一条 role="user" 的内容。
contents[].rolestring—角色，生图固定用 "user"
contents[].parts[].textstring必填文字提示词，描述要生成的图片
contents[].parts[].inlineDataobject—图生图参考图（内联 base64）：{ "mimeType": "image/png", "data": "<base64>" }；文生图不传。也可改用下方 fileData.fileUri 传直链。
contents[].parts[].fileData.fileUristring—图生图参考图的 https 直链（替代内联 base64）：服务端自动下载并内联后送模型。仅支持 https，最多 4 张参考图；任一下载失败整单报错、不扣费。
generationConfigobject必填生成配置对象，见下方子字段
generationConfig.responseModalitiesstring[]必填输出模态，生图必须含 "IMAGE"（如 ["TEXT","IMAGE"]）；缺失则只返回文本、不出图
generationConfig.candidateCountnumber—生成张数：1~4，默认 1。按张数 ×N 计费、按成功张数结算（失败自动退回）
generationConfig.imageConfig.imageSizestring—分辨率档：1K / 2K / 4K，默认 1K（Nano 仅 1K；Nano Pro / Nano 2 支持 2K/4K）
generationConfig.imageConfig.aspectRatiostring—输出比例：1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 5:4 / 4:5 / 21:9，默认 1:1；以 Google 官方 imageConfig 为准

计费与积分

Nano（gemini-2.5-flash-image）10 积分/张；Nano Pro（gemini-3-pro-image-preview）20 积分/张；Nano 2（gemini-3.1-flash-image-preview）20 积分/张。多图按 candidateCount 张数 ×N 计费，按成功张数结算（失败自动退回）。
鉴权除 Authorization: Bearer <API_KEY> 外，也支持 x-goog-api-key（值为你的 APIKey，二选一，非叠加）。生成多张时按 candidateCount 张数计费、按成功数结算；图生图参考图可内联 base64 或用 fileData.fileUri 传 https 直链。multipart/form-data 提交：字段 prompt（文生图必填 / 图生图为编辑指令）、image（参考图文件，可重复最多 4 张）、n（张数，最多 4，对应 candidateCount）；model 只取自 URL 路径，仅图片模型 + 仅非流式支持，请求体上限 20MB（超限 413）；请求格式（JSON / multipart）与响应格式（base64 / 叠加 ?respFormat=url 返回 CDN 直链）相互正交，计费与 JSON 路径完全一致。

请求示例

文生图（同步）

curl -X POST "https://api.cqtai.com/v1beta/models/gemini-2.5-flash-image:generateContent" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role":"user","parts":[{"text":"a cute cat on a windowsill, soft morning light"}]}],
    "generationConfig": {
      "responseModalities": ["TEXT","IMAGE"],
      "imageConfig": {"imageSize": "1K", "aspectRatio": "1:1"}
    }
  }'

图生图（同步，参考图直链 + 多图）

curl -X POST "https://api.cqtai.com/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role":"user","parts":[
      {"text":"turn this photo into an oil painting"},
      {"fileData":{"mimeType":"image/png","fileUri":"https://example.com/input.png"}}
    ]}],
    "generationConfig": {
      "responseModalities": ["TEXT","IMAGE"],
      "candidateCount": 2,
      "imageConfig": {"imageSize": "2K", "aspectRatio": "16:9"}
    }
  }'

图生图（同步，multipart 上传文件）

# 同一端点按 Content-Type 分流：发 multipart/form-data 直接上传参考图文件
# 字段：prompt（文生图必填 / 图生图为编辑指令）、image（参考图文件，可重复最多 4 张）、n（张数，最多 4）
# model 只取自 URL 路径；仅图片模型 + 仅非流式支持；请求体上限 20MB
# 默认返回 base64；叠加 ?respFormat=url 则返回 CDN 直链
curl -X POST "https://api.cqtai.com/v1beta/models/gemini-2.5-flash-image:generateContent" \
  -H "Authorization: Bearer <API_KEY>" \
  -F "prompt=把这张图改成水彩风格" \
  -F "image=@input.png"

响应示例

{
  "candidates": [
    {
      "content": {
        "parts": [
          { "inlineData": { "mimeType": "image/png", "data": "<base64 PNG，原样透传>" } }
        ]
      },
      "finishReason": "STOP"
    }
  ]
}

计费与积分

按 Token 计费：输入 token × 输入单价 + 输出 token × 输出单价（缓存创建 ×1.25、缓存读取 ×0.1），再乘以你的费率。count_tokens 仅预估、不计费。单价见「介绍」页模型列表。