快速开始
用 Gemini 协议接入
网关接受 Gemini 原生 generateContent 路径,google-genai 客户端只需把 base_url 指向网关。
Gemini 原生协议走 POST /v1beta/models/{model}:generateContent(以及流式的 :streamGenerateContent)。
curl
curl "https://api.tokrouter.dev/v1beta/models/gemini-3.8-flash:generateContent" \
-H "x-goog-api-key: $TOKROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "用一句话解释什么是 SSE"}]}]
}'google-genai(Python)
import os
from google import genai
from google.genai import types
client = genai.Client(
api_key=os.environ["TOKROUTER_API_KEY"],
http_options=types.HttpOptions(base_url="https://api.tokrouter.dev"),
)
resp = client.models.generate_content(
model="gemini-3.8-flash",
contents="用一句话解释什么是 SSE",
)
print(resp.text)google-genai(TypeScript)
import { GoogleGenAI } from '@google/genai'
const ai = new GoogleGenAI({
apiKey: process.env.TOKROUTER_API_KEY!,
httpOptions: { baseUrl: 'https://api.tokrouter.dev' },
})
const resp = await ai.models.generateContent({
model: 'gemini-3.8-flash',
contents: 'Explain SSE in one sentence',
})
console.log(resp.text)也可以走 OpenAI 协议
不习惯 Gemini 原生协议时,直接用 /v1/chat/completions 调同一个模型即可 —— model 传
gemini-3.8-flash,请求体按 OpenAI 格式写。两条路都在同一把 Key 下计费。
DashScope(阿里云)
阿里云原生路径挂在 /v1 下,并去掉官方的 /api 前缀:
curl https://api.tokrouter.dev/v1/services/aigc/text-generation/generation \
-H "Authorization: Bearer $TOKROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3.8-max",
"input": {"messages": [{"role": "user", "content": "你好"}]},
"parameters": {"result_format": "message"}
}'官方 https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
对应本站的 https://api.tokrouter.dev/v1/services/aigc/text-generation/generation。
具体转发哪家由请求体里的 model 决定,不必逐一改路径。