Gemini v1beta

第 1 版 · 更新于 2026-11-12 · 阅读约 1 分钟

通过 Runtoken 调用 Gemini 原生 v1beta 接口。

准备工作#

开始前，请准备：

• 在控制台创建的平台 API Key。
• 使用 Gemini v1beta 协议的准确模型 ID。
• 可发送 HTTP 请求的服务端环境，流式示例使用 curl。

接口与鉴权#

通过 x-goog-api-key 请求头携带平台 Key。

网关域名为 https://api.runtoken.net，这个原生接口不使用 /v1 路径前缀。

发送请求#

本例使用 alt=sse 开启流式响应，并在 contents 数组中提交文本内容。

curl -N \
  'https://api.runtoken.net/v1beta/models/YOUR_MODEL_ID:streamGenerateContent?alt=sse' \
  -H 'x-goog-api-key: YOUR_PLATFORM_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "Hello!" }]
    }]
  }'

运行示例前，请替换以下占位值。

以下地址组成保持不变。

处理流式响应#

按 Gemini 协议读取返回数据。curl -N 只负责关闭输出缓冲，不会将 Gemini 事件转换为 OpenAI 响应格式。

推理是无状态的。应用需要保存对话上下文，并在后续请求中提交相关内容。

模型专属输入#

本例只演示文本输入。图像等媒体的输入格式、生成选项及工具支持，需要按所选模型确认。

目前不支持显式缓存和文件资源。接入时不要依赖持久化文件上传或显式缓存对象引用。

下一步#

需要文本向量接口，可阅读向量嵌入；通用的路由与计费行为见接入指南。