玄枢API

Gemini v1beta API

Gemini 原生 Models、模型详情与 model action 兼容端点。

最后验证日期: 2026-07-23

连接与鉴权

统一 OpenAI 兼容 Base URL: https://www.xuanshuapi.com/v1

OpenAI 兼容接口使用 Authorization: Bearer <YOUR_API_KEY>；Claude Messages 也支持 x-api-key: <YOUR_API_KEY>；Gemini v1beta 使用 x-goog-api-key: <YOUR_API_KEY>。

Gemini v1beta API

使用 /v1beta/models 查询模型，并通过 /v1beta/models/{model}:{action} 调用受支持 action。

可用 action 与模型能力以 Models 返回和当前配置为准。

请求体与调用

Gemini 原生调用把模型放在路径中，contents 放在 JSON 请求体中。

curl "https://www.xuanshuapi.com/v1beta/models/MODEL_FROM_MODELS:generateContent" \
  -H "x-goog-api-key: <YOUR_API_KEY>" -H "content-type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Reply with OK"}]}]}'

响应与流式行为

generateContent 返回 candidates；streamGenerateContent 以流式 action 返回增量结果。

HTTP 200
{"candidates":[{"content":{"role":"model","parts":[{"text":"OK"}]},"finishReason":"STOP"}]}

关键参数

参数	说明
model	替换路径中的 MODEL_FROM_MODELS。
contents	角色与 parts 内容。
generationConfig	仅设置模型支持的生成参数。

典型故障

400 检查 action 与请求体；404 检查模型路径；401/403 检查 x-goog-api-key 与权限。

HTTP 400  # unsupported action or invalid body
HTTP 401/403  # x-goog-api-key or permission
HTTP 404  # model path not available
HTTP 429/5xx  # bounded retry candidate

下一步

可用模型、倍率、配额及部分高级能力动态依赖当前 Key 与控制台配置。