简介
本服务是 Google Gemini API 的 HTTP 代理,客户端可像调用官方 API 一样,将请求发往本地址,由代理转发至 Gemini 官方接口。支持 generateContent 与 Interactions 两大 API。
认证
请在请求头中携带 Google API Key:
x-goog-api-key: YOUR_GEMINI_API_KEY
也支持 Authorization: Bearer YOUR_KEY 或查询参数 ?key=YOUR_KEY。
generateContent API
POST
/v1beta/models/{model}:generateContent
POST
/v1beta/models/{model}:streamGenerateContent
curl -X POST "https://gemini.fvv.lol/v1beta/models/gemini-2.5-flash:generateContent" \
-H "x-goog-api-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"How does AI work?"}]}]}'
Interactions API
POST
/v1beta/interactions
GET
/v1beta/interactions/{id}
DELETE
/v1beta/interactions/{id}
POST
/v1beta/interactions/{id}/cancel
curl -X POST "https://gemini.fvv.lol/v1beta/interactions" \
-H "x-goog-api-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-H "Api-Revision: 2026-05-20" \
-d '{"model":"gemini-2.5-flash","input":"Tell me a joke."}'
流式响应
- generateContent:使用
:streamGenerateContent端点,或加?alt=sse - Interactions:请求体设置
"stream": true