RouteMarket 文档
API 手册文本与多模态

Gemini Generate Content

Gemini 原生生成内容接口

本页整理 RouteMarket 的 Gemini Generate Content 兼容接口,包括可识别的端点、结构化参数和请求示例。

兼容性提示:页面由公开协议中的技术字段生成。具体模型、额度和路由能力以 RouteMarket 控制台及实际网关响应为准。

参数参考

参数表 1

能力方法路径
生成内容POST/v1beta/models/{model}:generateContent
流式生成POST/v1beta/models/{model}:streamGenerateContent

参数表 2

字段说明
text-
inlineData-
fileData-
functionCall-
functionResponse-

参数表 3

字段类型说明
candidatesarray-
usageMetadataobject-
modelVersionstring-
responseIdstring-
promptFeedbackobject-

参数表 4

字段说明
content.parts-
finishReason相关值:STOPMAX_TOKENSSAFETY
safetyRatings-

参数表 5

参数说明
generationConfig.temperature-
generationConfig.topP-
generationConfig.topK-
generationConfig.maxOutputTokens-
generationConfig.responseMimeType相关值:application/json
generationConfig.responseSchema-

参数表 6

状态码Gemini 状态处理方式
400INVALID_ARGUMENT检查 contents、参数大小写和 JSON 结构
401UNAUTHENTICATED检查 ?key=$ROUTEMARKET_API_KEY
404NOT_FOUND检查模型名和路径
429RESOURCE_EXHAUSTED降低频率或稍后重试
500INTERNAL重试;如持续出现,联系支持

请求与响应示例

示例 1

?key=$ROUTEMARKET_API_KEY

示例 2

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Gemini API 是 Google Gemini 模型的原生内容生成接口。"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 18,
    "totalTokenCount": 26
  },
  "modelVersion": "gemini-3-pro-preview",
  "responseId": "response_xxx"
}

示例 3

{
  "contents": [{
    "parts": [
      {"text": "描述这张图片"},
      {
        "inlineData": {
          "mimeType": "image/jpeg",
          "data": "<BASE64_IMAGE_DATA>"
        }
      }
    ]
  }]
}

示例 4

{
  "contents": [{
    "parts": [{"text": "把灯调成蓝色"}]
  }],
  "tools": [{
    "functionDeclarations": [{
      "name": "set_light_color",
      "description": "设置灯光颜色",
      "parameters": {
        "type": "object",
        "properties": {
          "color": {"type": "string"}
        },
        "required": ["color"]
      }
    }]
  }]
}

接入说明

  • API 基础地址:https://api.routemarket.ai
  • 推荐密钥环境变量:ROUTEMARKET_API_KEY
  • 请求使用 Authorization: Bearer <API_KEY>
  • 上线前请用实际账号验证端点、模型名、限额与异步任务状态。