Gemini 原生接口
有些项目是按 Google 原生 API 写的:用 contents 而不是 messages、parts 而不是 content、usageMetadata 而不是 usage。把这些改写成 OpenAI 客户端是你不该承担的额外工作,所以我们直接提供原生格式。
路径
POST https://hypit.video/v1beta/models/{model}:{action}
注意这里是 /v1beta,不是 /v1。请求体逐字节转发给 Google,响应原样返回。
支持的动作
| 动作 | 行为 |
|---|---|
| generateContent | 缓冲式 JSON 响应 |
| streamGenerateContent | 默认 SSE;?alt=json 返回 Google 的 JSON 帧数组 |
| countTokens | 缓冲式,且不计费 |
其他动作(embedContent、batchEmbedContents、predict、文件上传等)返回 404 unsupported_action。只有 POST 会被路由。
FAQ
需要改客户端吗?
不需要,原生客户端加 ?key= 或 X-Goog-Api-Key 即可访问。
为什么用 query 传 key?
为了让未改动的 Google 客户端能直接使用;其他场景建议用请求头。
流式计费怎么算?
按 token 计费,与上游一致;countTokens 不计费。