Skip to main content
Google 的 gemini-cli(以及构建在它之上的 CLI / IDE 扩展家族)讲 Gemini Native 协议 —— 用 query 参数鉴权(?key=...),打到 /v1beta/models/{model}:generateContent。ByteSpike 在 llm.bytespike.ai/v1beta 原样提供该协议。

前置条件

  • 一个 ByteSpike 账号 + 一把绑到 gemini-default 分组的 key (或任何能服务 Gemini 模型的分组)。详见 注册账号
  • 装好 Gemini CLI:

配置

Gemini CLI 一般读 GEMINI_API_KEY,并允许通过环境变量或 flag 覆盖 base URL。
如果你用的官方 Google CLI 没有暴露 base-URL flag,按其文档设变量 (部分版本读 GOOGLE_API_BASE_URL);或者在包装脚本里用下一节的 raw curl 形式。

验证

期望得到 200 响应,里面有 candidates[0].content.parts[0].text 字段,外加标准的 X-Quota-Remaining-Credits 响应头。

切换模型

模型名写在 URL 路径里:
key 绑定的分组里任意 model id 都能用。完整请求结构见 /v1beta 参考

流式

把方法后缀换一下:
SSE 流和 Google 原生格式一致 —— data: {chunk}\n\n 块,以最后一个 [DONE] 标记结尾。

SDK

Google 官方 Generative AI SDK 和大多数第三方 Gemini 客户端都允许在 构造时覆盖 baseUrl

走 Gemini 栈的图像 + 视频模型

Veo(Google 的视频模型)出在 Gemini API 这套接口下,但 long-running 结构走的是 ByteSpike 的异步 tasks API:
详见 POST /tasks/submitVeo 3.1 模型页

排错

下一步

/v1beta 参考

完整请求 / 响应 / 流式协议。

Gemini 模型

模型、能力、价格。

Claude Code CLI

Anthropic 原生那一侧的对等品。

Cursor IDE

编辑器层的 Gemini 集成。