Gemini 文本聊天（原生Gemini格式）

除 OpenAI 兼容格式外，YouQi AI 还提供 Google Gemini 原生接口，兼容 Gemini 官方 API 的请求 / 响应结构，方便直接使用 Google 的 SDK 或已有的 Gemini 集成。本页介绍纯文本对话；图像 / PDF / 音频 / 视频识别见 Gemini 媒体识别。

接口地址与认证

项目	值
Base URL	https://ai.youqi.tech/v1beta
生成内容	POST /v1beta/models/{model}:generateContent
流式生成	POST /v1beta/models/{model}:streamGenerateContent
模型列表	GET /v1beta/models
认证方式	查询参数 ?key=<YOUR_API_KEY> 或请求头 x-goog-api-key: <YOUR_API_KEY>

注意 Base URL 不同

Gemini 原生面的 Base URL 为 https://ai.youqi.tech/v1beta（不是 /v1），且认证通过 ?key= 查询参数或 x-goog-api-key 头传递。使用的 API Key 仍是控制台创建的 sk-... 密钥。

生成内容

请求参数

参数	类型	必填	说明
contents	array	是	对话内容列表，每项含 role（user / model）与 parts
parts[].text	string	是	文本内容（也可为 inline_data 传图像等多模态）
systemInstruction	object	否	系统指令
generationConfig	object	否	生成配置，如 temperature、topP、maxOutputTokens
tools	array	否	函数调用等工具声明

请求示例

curl "https://ai.youqi.tech/v1beta/models/gemini-1.5-pro:generateContent?key=sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      { "role": "user", "parts": [{ "text": "用一句话介绍杭州。" }] }
    ]
  }'

使用请求头传递密钥（等效）：

curl "https://ai.youqi.tech/v1beta/models/gemini-1.5-pro:generateContent" \
  -H "x-goog-api-key: sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "contents": [{ "role": "user", "parts": [{ "text": "Hello" }] }] }'

响应示例

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          { "text": "杭州是一座以西湖闻名、兼具历史底蕴与数字经济活力的城市。" }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 22,
    "totalTokenCount": 30
  }
}

流式生成

将端点方法改为 :streamGenerateContent，服务端会分块返回 JSON：

curl "https://ai.youqi.tech/v1beta/models/gemini-1.5-pro:streamGenerateContent?key=sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "contents": [{ "role": "user", "parts": [{ "text": "写一首关于秋天的短诗" }] }] }'

提示

若你使用 OpenAI SDK，也可直接以聊天接口（/v1/chat/completions）调用 Gemini 模型，网关会自动完成协议转换。原生 /v1beta 接口适合已有 Google SDK 集成或需要 Gemini 特有结构的场景。图像 / PDF / 音频 / 视频识别请求见 Gemini 媒体识别。