Gemini 兼容层

Gemini 协议兼容 API

提供 Google Gemini GenerateContent 请求/响应格式的兼容入口，适合已有 Gemini SDK 或 HTTP 调用迁移到 NexusFlow。这里不是 Google 原生 Gemini 模型托管，路径里的 model 必须填写 NexusFlow 模型 ID，例如 qwen-turbo。

接口地址

POSThttps://nexusflow.hk/v1beta/models/{model}:generateContent同步生成

POSThttps://nexusflow.hk/v1beta/models/{model}:streamGenerateContent流式生成

请求参数

参数	必选	说明
`model`	*	路径参数，必须使用 NexusFlow 模型 ID，例如 qwen-turbo；不要填写 Google 原生模型名
`key`	*	API Key，推荐放在 query string：?key=sk-air-...；也兼容 Authorization: Bearer
`contents`	*	对话内容数组，每项包含 role（user/model）和 parts（text 数组）
`generationConfig.temperature`	-	采样温度 [0, 2]，默认 1.0
`generationConfig.maxOutputTokens`	-	最大输出 token 数
`generationConfig.topP`	-	Top-P 采样
`generationConfig.topK`	-	Top-K 采样
`generationConfig.stopSequences`	-	停止序列数组
`tools`	-	工具/函数定义数组（Function Calling）

请求示例

curl "https://nexusflow.hk/v1beta/models/qwen-turbo:generateContent?key=$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "解释什么是机器学习"}]}
    ]
  }'

响应格式

{
  "candidates": [{
    "content": {
      "parts": [{"text": "机器学习是人工智能的一个分支..."}],
      "role": "model"
    },
    "finishReason": "STOP"
  }],
  "usageMetadata": {
    "promptTokenCount": 12,
    "candidatesTokenCount": 256,
    "totalTokenCount": 268
  }
}

说明：Gemini 兼容层会将请求自动转换为平台内部格式，路由到对应模型后再将响应转回 Gemini 格式。这不是 Google 官方 Gemini 后端，也不保证 Google 原生模型名可用；模型能力以 NexusFlow 模型列表为准。如无 Gemini SDK 依赖，建议直接使用 /v1/chat/completions（OpenAI 格式）以获得更完整的功能支持。