CoreRouter API 文档Gemini 风格接口
部分应用或 SDK 使用 Gemini API 路径。CoreRouter 提供 Gemini-compatible 路由，便于这类客户端直接接入。
接口信息
| 配置项 | 填写内容 |
|---|---|
| Base URL | https://api.corerouter.tech |
| 生成接口 | /v1beta/models/{model}:generateContent |
| 流式接口 | /v1beta/models/{model}:streamGenerateContent |
| 模型列表 | /v1beta/models |
| OpenAI 风格模型列表 | /v1beta/openai/models |
| 认证方式 | x-goog-api-key、?key= 或 Authorization: Bearer ... |
模型名仍然填写 CoreRouter 控制台中的 Model ID。不同 Gemini 客户端可能会自动拼接 models/ 或 API 路径，请按客户端要求填写。
查询 Gemini 模型列表
原生 Gemini 风格客户端可以调用：
bash
curl https://api.corerouter.tech/v1beta/models \
-H "x-goog-api-key: $COREROUTER_API_KEY"
如果客户端虽然使用 Gemini 兼容连接，但只会请求 OpenAI 风格的模型列表，可以改用：
bash
curl https://api.corerouter.tech/v1beta/openai/models \
-H "Authorization: Bearer $COREROUTER_API_KEY"
两个列表接口都只返回当前 API Key 可见的模型，不代表服务端全部模型。
使用 x-goog-api-key
bash
export COREROUTER_API_KEY="sk-xxxxxxxxxxxxxxxx"
curl "https://api.corerouter.tech/v1beta/models/gemini-model-id:generateContent" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $COREROUTER_API_KEY" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{"text": "你好，请介绍一下你自己。"}
]
}
]
}'
使用查询参数 key
bash
curl "https://api.corerouter.tech/v1beta/models/gemini-model-id:generateContent?key=$COREROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"parts": [
{"text": "用三句话介绍 CoreRouter。"}
]
}
]
}'
流式输出
bash
curl "https://api.corerouter.tech/v1beta/models/gemini-model-id:streamGenerateContent" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $COREROUTER_API_KEY" \
-d '{
"contents": [
{
"parts": [
{"text": "请逐条输出三个 API 接入注意事项。"}
]
}
]
}'
常见问题
- 客户端要求 Google API Key：填写 CoreRouter API Key。
- 模型找不到：确认路径里的模型名来自 CoreRouter 控制台。
- 路径重复：如果客户端已经拼接
/v1beta/models/...，Base URL 只填https://api.corerouter.tech。 - 参数不生效：Gemini 风格参数和 OpenAI 风格参数不同，请使用客户端对应的字段名。