API 文档

ApiBoop 提供 OpenAI 兼容接口与 Anthropic 兼容接口。将 base_url 指向本站,并使用控制台创建的 API Key。

完全零基础?看零基础手把手指南 — 15 分钟从装工具到写出第一个软件。

接口地址

https://apiboop.com/api/v1

cc-switch 一键配置

已安装 cc-switch（AI 编程工具配置管理器）?点击下方按钮一键导入 ApiBoop 供应商配置(GLM 系列为通用线路,三个 CLI 中均可通过切换模型使用)。导入后按对应 CLI 指南选择模型。

第 1 步 · 选择你的工具

第 2 步 · 选择默认模型(导入后立即可用,随时可换)

claude-sonnet-5-5推荐claude-haiku-5-5快速claude-opus-5-5高性能glm-5.3-flash快速

一键导入到 claude-sonnet-5-5

不用 cc-switch?复制这段配置到指定文件即可:

# %USERPROFILE%\.claude\settings.json  (macOS/Linux: ~/.claude/settings.json)
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apiboop.com",
    "ANTHROPIC_AUTH_TOKEN": "am-xxxx",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

导入包含 Base URL、API Key 与所选模型,CLI 无需任何手工配置。需要 cc-switch 桌面版: 下载 / 了解 cc-switch

从零到第一次 AI 调用,只要五步,全程复制粘贴。

第 1 步 · 创建账号与 API Key

第 2 步 · 选择一个模型

第一次建议用最便宜的 glm-5.3-flash(通用线路,复制粘贴即用)。想用 Claude Code / Codex / Gemini CLI?直接看第 4 步的一键配置,不用手写任何配置。

第 3 步 · 发出第一条请求

把下面的命令整段复制到终端(Windows 用 PowerShell)回车。把 am-xxxx 换成你的 Key。

第 4 步 · 让 AI 编程工具用上它(一键或复制配置)

装了 cc-switch 的点上面按钮即可;否则把对应配置原样复制到指定文件。之后打开 CLI 就能干活。

第 5 步 · 查看用量和余额

每次调用都会记录在控制台 → Usage(模型、tokens、消耗);首页可见钱包余额与试用额度。

成功标志:返回一段 JSON,里面有 reply 文本和 usage 计数。报错?对照错误码表(下方 Errors)排查。

POST /v1/chat/completions（OpenAI 兼容）

完整支持 tools / tool_calls / tool 消息、reasoning（completion_tokens_details.reasoning_tokens）、cached input（prompt_tokens_details.cached_tokens）与 SSE 流式。

curl https://apiboop.com/api/v1/chat/completions \
  -H "Authorization: Bearer am-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3-flash",
    "messages": [{"role": "user", "content": "你好,做个自我介绍"}],
    "stream": false
  }'

POST /v1/messages（Anthropic 兼容）

完整 Anthropic Messages 协议：tools（tool_use / tool_result）、extended thinking 与 adaptive thinking、cache_control 缓存断点、图片、stop_reason 映射与完整 SSE 事件序（message_start → content_block_* → message_delta → message_stop）。Claude Code 可直接使用（见下）。

curl https://apiboop.com/api/v1/messages \
  -H "x-api-key: am-xxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3-flash",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好,做个自我介绍"}]
  }'

POST /v1/responses（OpenAI Responses API）

完整支持 function tools、function_call / function_call_output 回合、reasoning effort → thinking、以及 Responses SSE 事件流（response.created → output_item.* → output_text.delta → response.completed）。无状态（store:false）：previous_response_id / conversation / background 传入会得到明确错误。

POST /v1beta/models/{model}:generateContent（Gemini 原生协议）

Gemini 原生 GenerateContent + alt=sse 流式，支持 functionDeclarations / functionCall / functionResponse 回合与 thinkingConfig。认证用 x-goog-api-key 头或 ?key= 参数。Gemini CLI 与 Google GenAI SDK 可直接使用。

curl "https://apiboop.com/api/v1beta/models/gemini-3.8-flash:streamGenerateContent?alt=sse&key=am-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "Hello"}]}]
  }'

GET /v1/models · GET /v1beta/models

分别以 OpenAI / Gemini 格式列出你的 Key 可用的模型。

CLI 客户端接入

Claude Code（Anthropic 协议线路）:

# ~/.claude/settings.json
{ "env": {
    "ANTHROPIC_BASE_URL": "https://apiboop.com",
    "ANTHROPIC_AUTH_TOKEN": "am-xxxx",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5" } }

Codex CLI（OpenAI Responses 线路）:

# ~/.codex/config.toml
model = "gpt-6.1-sol"
model_provider = "apiboop"
[model_providers.apiboop]
name = "ApiBoop"
base_url = "https://apiboop.com/v1"
env_key = "APIBOOP_API_KEY"
wire_api = "responses"
{t("docs.cliCodexNote")}

Gemini CLI（Gemini 原生线路）:

{t("docs.cliGeminiNote")}
export GOOGLE_GEMINI_BASE_URL=https://apiboop.com
export GEMINI_API_KEY=am-xxxx
gemini -m gemini-3.8-flash -p "..."

通用 OpenAI SDK / 其它客户端: 通用 OpenAI SDK / 其它客户端：base_url 设为 https://apiboop.com/v1，模型名按价格页选择；GLM 与 Gemini 线路对所有客户端开放，Claude Code 与 Codex 线路由上游凭据限制为对应 CLI 使用。

Errors

错误码:402 余额不足,403 模型不可用,429 限流,502 上游错误。

支持与反馈: support@apiboop.com