Gemini 原生接口

平台支持 Gemini 原生 generateContent 路径。模型必须在模型广场中标记为支持 Gemini 接口。

请求

curl \
  "https://agent-team-api.myrimate.cn/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $AGENT_TEAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "用两句话解释向量检索"}]
      }
    ]
  }'

路径规则

POST /v1beta/models/{model}:generateContent

模型名称位于 URL 路径中，而不是请求体的 model 字段。

鉴权

推荐使用 Header：

x-goog-api-key: sk-your-key

兼容客户端也可能把 Key 放在查询参数 ?key= 中，但查询参数更容易进入访问日志和错误报告，不建议手工请求采用这种方式。

OpenAI 兼容与 Gemini 原生

部分 Gemini 模型同时支持 OpenAI 兼容和 Gemini 原生协议。两种协议的请求结构不同：

• OpenAI Chat 使用 /v1/chat/completions 和 messages。
• Gemini 原生使用 /v1beta/models/{model}:generateContent 和 contents。

选择协议前先确认客户端实际发送哪种请求。仅修改 Base URL 不会自动修正客户端生成的请求结构。