兼容 API 接入

Gemini 兼容 API:使用 GenerateContent 请求格式

已使用 Google Gemini contents、parts 与 generationConfig 结构的服务,可以通过无限星河AI的 GenerateContent 兼容端点接入当前可用 Gemini 模型。模型 ID 位于请求路径中,必须使用当前目录返回的原始调用 ID。

普通生成端点为 POST /v1beta/models/{model}:generateContent;流式端点为 POST /v1beta/models/{model}:streamGenerateContent?alt=sse。平台使用 Authorization: Bearer YOUR_API_KEY 鉴权。

Gemini 兼容端点与字段

POST /v1beta/models/{model}:generateContent

普通 GenerateContent 请求

POST /v1beta/models/{model}:streamGenerateContent?alt=sse

SSE 流式生成请求

contents[].parts[]

文本或所选模型支持的多模态内容部件

generationConfig

温度、topP 与最大输出长度等生成设置

systemInstruction

所选模型支持时使用的系统指令

迁移 Gemini 请求

  1. 把请求主机改为当前国内或国际站点,保留 /v1beta/models/{model} 路径形状。
  2. 使用 Bearer Token 发送 Infistar API Key,不在 URL、日志或前端代码中暴露密钥。
  3. 从模型与价格页面或模型列表复制 Gemini 原始模型 ID,并替换路径中的 {model}。
  4. 分别验证文本、多模态与流式请求;只有模型明确支持的输入和参数才能使用。

GenerateContent 最小请求

MODEL_ID 是路径占位符。请替换为当前账户可见且支持 Gemini 端点的模型 ID。

curl "https://coneverse.com/v1beta/models/MODEL_ID:generateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "Hello"}]
    }]
  }'

路径与能力边界

  • Gemini 模型 ID 位于 URL 路径,不要把展示名称、中文名称或大括号原样发送。
  • 图片、音频、视频、工具与安全设置是否可用取决于模型能力,不能从 Gemini 格式统一推导。
  • 流式接口使用 alt=sse;客户端还应正确处理断开、终态和业务超时。