返回首页 TOP API DOCS 开 发 文 档
文档 / 快速开始
TOP API DOCUMENTATION

快速开始

三步接入 Top API:在控制台创建密钥选对 Base URL、把它填进你的工具。能收到回复就说明线路通了。

图省事?直接看 首页一键安装,复制一条命令就能把 Claude Code 接到 Top API,跳过手动配置。

1. 登录控制台,创建 API 密钥

打开 https://top-api.cc/login 登录,进入「API 密钥」页面,点击创建,复制以 sk- 开头的密钥。

  • 密钥就是你的钱包,不要截图、不要公开、不要提交到代码仓库
  • 一个密钥可同时给多个工具用;担心泄露随时可在控制台删除重建。

2. 按协议选对 Base URL

不同客户端走不同协议,Base URL 的写法不一样,这是新手最常踩的坑。对照下表填:

AnthropicOpenAICodex
Anthropic 协议
https://top-api.cc —— Claude Code / Anthropic SDK,根域名不带 /v1,客户端自动补 /v1/messages
OpenAI 兼容
https://top-api.cc/v1 —— Cursor / Cherry Studio 等 OpenAI 客户端,必须带 /v1
Codex 协议
https://top-api.cc —— Codex CLI,同样只填到根域名
记住一句话:Claude Code / Codex 用根域名,只有 OpenAI SDK 直连才用 /v1。Base URL 多带了 /v1 会被拼成 /v1/v1/messages 直接 404。

3. 填进你的工具

Base URL + 你的 sk- 密钥 + 模型名(首推 claude-opus-4-8)填进客户端即可。按工具看对应的详细配置:

  • Claude 系(claude max 分组)与 GPT 系(gpt-5.6-sol、codex pro[特惠]分组)均可使用,按你的客户端和需求选分组建密钥。
  • 没列出的客户端:任何「OpenAI 兼容」应用都能用 https://top-api.cc/v1 + 密钥 + 模型名接入。

验证

不想装客户端?直接用 curl 发一条 Anthropic 消息,能返回内容就说明密钥和线路都通了:

curl https://top-api.cc/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "你好"}]
  }'
返回一段 JSON、带有 content 字段就成功了。若收到 401/404,多半是密钥写错或 Base URL 多带了 /v1,对照 错误排查 处理。
配置过程中遇到任何问题,都可以加客服微信 gtsj-001,我们可以帮你检查 Base URL、API Key、模型和客户端配置。
需要帮助?客服微信 gtsj-001 · 文档首页