快速开始 — 30 秒接入 ZetaAPI

从注册到发出第一次调用只需 3 步。本文覆盖注册登录、获取 API Key、在 Cursor / Claude Code / 任意 OpenAI SDK 中完成切换。

更新于 2026-10-05

你将用 30 秒完成什么

拿到一个可调用 Claude / GPT / Gemini 等主流模型的 API Key
在常用工具（Cursor / Claude Code / OpenAI Python SDK）里把上游替换为 ZetaAPI
看到控制台实时显示 token 消耗与费用

第 1 步：注册与充值

访问控制台用 Google / GitHub / 邮箱任一方式登录
首次登录后账户自动创建，无需邮箱验证之外的任何审核
在”充值”页面通过银行卡 / 支付宝 / 微信充值 $1 起（首次充值有引导）

第 2 步：创建 API Key

进入控制台 API Keys 页面：

点击 创建 Key
起一个便于识别的名字（如 cursor-mac、claude-code-work）
复制生成的 Key（格式 sk-xxxxx...，仅此一次明文显示）

⚠️ Key 只会在创建时显示一次完整值。请立即保存到 1Password / macOS Keychain / .env 等安全位置。

第 3 步：切换上游

方式 A：Cursor

Settings → Models → OpenAI API Key：

API Key：填入 sk-xxxxx
Base URL（需开启 Override OpenAI Base URL）：https://api.staging.cosmos-router.com/v1

保存后，对话或 Cmd+K 所有操作都会走 ZetaAPI。详见 Cursor 配置指南。

方式 B：Claude Code

在 ~/.zshrc 或 ~/.bashrc 添加：

export ANTHROPIC_BASE_URL="https://api.staging.cosmos-router.com"
export ANTHROPIC_API_KEY="sk-xxxxx"
export CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1

source 后直接 claude 开始会话。详见 Claude Code 配置指南。

方式 C：任意 OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxx",
    base_url="https://api.staging.cosmos-router.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Node.js 官方 SDK / LangChain / LlamaIndex / 任何支持自定义 base_url 的客户端同理。

方式 D：Claude Desktop

在 Claude Desktop 菜单栏 Developer → Configure Third-Party Inference… 中选择 Gateway，Base URL 填 https://api.staging.cosmos-router.com，API Key 填 sk-xxxxx，保存并重启后即可在 Cowork 和 Code 中使用 Claude 模型。首次使用需要先开启开发者模式，完整步骤见 Claude Desktop 配置指南。

验证接入成功

发出首次调用后回到控制台首页，你应该看到：

今日消耗从 0 变成非零
最近调用出现你刚才的请求（模型、token、耗时、状态码）
若 5 分钟内没有数据更新，说明 Key 或 Base URL 配置错误

⚠️ 用浏览器插件式代理（各类「VPN」扩展）注册的，请注意：那类代理只接管浏览器流量，命令行工具和 SDK 不走它 —— 网站打得开不代表 API 连得上。请开启代理软件的 TUN / 虚拟网卡模式，详见接入自检。

连不上、或不确定哪里配错了，跑一条命令就能定位：

npx --prefer-online zetaapi@latest doctor --api-url=https://api.staging.cosmos-router.com --key=sk-你的Key --base-url=<你填的那个URL>

它会分开告诉你是 DNS / 网络 / 证书 / 代理 / Base URL 写法 / Key / 模型名哪一环出了问题。详见接入自检。

下一步

接入不成功时怎么定位 → 接入自检
了解不同工具的具体配置 → 工具配置指南
理解按量计费 + Prompt Cache → 计费说明
API 端点、错误码、速率限制 → API Reference