文档快速开始

快速开始

说明注册账号、充值、发行 API 密钥这三个步骤,以及第一次调用 API。

按照本页的步骤,从注册账号一直做到第一次调用 API。步骤有三个:注册、充值、发行密钥。

注册免费,但调用 API 需要余额(充值 1,000 日元起)。注册赠送:[ ]

选择用法

用法接入地址在哪里读
OpenAI 的 SDKhttps://token.echohub.io/v1本页
Anthropic 的 SDKhttps://token.echohub.io(不加 /v1)本页
Claude Codehttps://token.echohub.io(不加 /v1)Claude Code
Codex CLIhttps://token.echohub.io/v1Codex CLI
Cursor、Cline、Dify 等支持 OpenAI 格式的工具https://token.echohub.io/v1Cursor、Cline、Dify
把现有的 SDK 代码切换到 Echo与各 SDK 相同本页的「切换现有代码」

两种格式都用同一把 API 密钥。其他 SDK 和工具的接入地址,见 API 参考的「各 SDK 和工具的接入地址」。

1. 注册账号

会员网站 Echo AI Hub 公开后才能注册账号。2026-09-28 时,会员网站还没有公开,所以还不能注册和登录。

公开后的步骤如下。

  1. 打开控制台(https://token.echohub.io/console ),会跳转到 Echo AI Hub 的登录页面
  2. 在 Echo AI Hub 的页面上注册或登录。账号在两个网站通用
  3. 注册或登录完成后,会回到 Echo Token Station 的控制台(发行 API 密钥、查看使用情况的管理页面)

控制台只有日文。下面的步骤里,控制台上的名称用日文写,括号里是中文说明。

刚注册完时,控制台会显示「API の利用を準備しています」(正在准备 API 的使用)。准备好后,页面会自动切换。

2. 充值

  1. 在控制台的菜单里打开「残高とチャージ」(余额与充值),点「チャージする」(充值)
  2. 选择金额,点「お支払いへ進む」(前往付款),会跳转到 Stripe 的付款页面。用信用卡支付
  3. 支付完成后,会回到控制台的「残高とチャージ」。到余额更新可能需要几秒到 1 分钟左右。更新后页面会自动刷新

金额、有效期和使用顺序见价格与充值。

3. 发行 API 密钥

  1. 在控制台的菜单里打开「APIキー」(API 密钥),点「キーを発行」(发行密钥)
  2. 在「名前」(名称)里填一个能看出用途的名称(例:生产服务器)。要限制能用的金额时,也填上「利用上限(円)」(使用上限(日元))
  3. 点「発行する」(发行),会显示密钥。点「キーをコピー」(复制密钥)保存好。密钥是以 sk- 开头的字符串

发行密钥的页面上,还会显示一段已经填好这把密钥的第一次调用的代码。

注意:不要把密钥给别人看。也不要写进公开的代码仓库或在浏览器里运行的代码。泄露时,请在控制台停用这把密钥。

第一次调用

把密钥放进环境变量

环境变量是设置在电脑或服务器上的、带名字的值。这样就不用把密钥直接写进代码。本文档使用 ECHO_API_KEY 这个名字。

bash
# macOS・Linux
export ECHO_API_KEY="sk-..."
PowerShell
# Windows(PowerShell)
$env:ECHO_API_KEY = "sk-..."

安装 SDK 并调用

在下面的标签里选择语言和 SDK。选中的标签在本文档的其他页面也会保持。模型 ID(指定要调用哪个模型的字符串)只是示例。OpenAI 格式的示例用 deepseek-flash,Anthropic 格式的示例用 claude-sonnet-5。能用的模型 ID 可以在模型一览查看。

用 OpenAI 格式调用。

bash
curl "https://token.echohub.io/v1/chat/completions" \
  -H "Authorization: Bearer $ECHO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "messages": [
      {"role": "user", "content": "日本の首都はどこですか?"}
    ]
  }'

成功时的响应

显示出回答的文字就是成功了。用 curl 时,会返回下面这样的 JSON(ID、时间和 token 数是示例)。

JSON
{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1790000000,
  "model": "deepseek-flash",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "日本の首都は東京です。"},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 16, "completion_tokens": 9, "total_tokens": 25}
}

控制台的「呼び出し履歴」(调用记录)里会显示这次调用的时间、模型、token 数和金额。可能需要几秒才会出现。

出错时,请在错误与处理查 HTTP 状态码和错误正文。密钥没错却返回 401 时,请检查接入地址里的 /v1。

切换现有代码

使用 OpenAI 或 Anthropic SDK 的代码,要改三处:接入地址、API 密钥和模型 ID。

要改的地方OpenAI 的 SDKAnthropic 的 SDK
接入地址base_url(TypeScript 是 baseURL)设为 https://token.echohub.io/v1base_url(TypeScript 是 baseURL)设为 https://token.echohub.io
API 密钥Echo 的 API 密钥Echo 的 API 密钥
模型 IDEcho 的模型 IDEcho 的模型 ID

以下是 Python 的 OpenAI SDK 要改的地方。

diff
 client = OpenAI(
-    api_key=os.environ["OPENAI_API_KEY"],
+    base_url="https://token.echohub.io/v1",
+    api_key=os.environ["ECHO_API_KEY"],
 )

也可以不改代码,用环境变量切换。OpenAI 的 SDK 读取 OPENAI_BASE_URL 和 OPENAI_API_KEY,Anthropic 的 SDK 读取 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。

bash
# OpenAI の SDK
export OPENAI_BASE_URL="https://token.echohub.io/v1"
export OPENAI_API_KEY="$ECHO_API_KEY"

# Anthropic の SDK
export ANTHROPIC_BASE_URL="https://token.echohub.io"
export ANTHROPIC_API_KEY="$ECHO_API_KEY"

用 AI 编程工具开始

让 Claude Code、Cursor 等工具帮你设置时,把下面这段文字原样交给它。

文本
请把这个项目设置成使用 Echo Token Station 的 API。
- OpenAI 格式的接入地址:https://token.echohub.io/v1
- Anthropic 格式的接入地址:https://token.echohub.io(Anthropic 的 SDK 会加上 /v1/messages。只有使用 @ai-sdk/anthropic 时要指定 https://token.echohub.io/v1)
- API 密钥从环境变量 ECHO_API_KEY 读取。不要把密钥写进代码或代码仓库
- 使用的模型 ID:deepseek-flash(示例。能用的模型见 https://token.echohub.io/models )
- 文档目录:https://token.echohub.io/llms.txt

接下来读

页面内容
各工具的设置Claude Code、Codex CLI、Cursor、Cline、Dify、LangChain
API 密钥与使用情况密钥的显示、停用和删除,使用上限,使用情况和调用记录的看法
API 参考端点、流式输出、主要参数
错误与处理错误正文的格式,以及各种情况的处理方法

信息来源

内容来源确认日期
接入地址和 /v1 的有无、没有 /v1 时的 404(2026-10-11 重新确认)、各 SDK 的调用(OpenAI SDK:Python 2.54.0、Node.js 7.23.0;Anthropic SDK:Python 1.8.0、Node.js 0.128.0)Echo 验证环境中的实测。使用与正式环境相同的中转设置,并用返回测试响应的服务器代替上游 API2026-09-27
OpenAI SDK 的 base_url、baseURL,环境变量 OPENAI_BASE_URL、OPENAI_API_KEYhttps://github.com/openai/openai-python 、https://github.com/openai/openai-node2026-09-27
Anthropic SDK 的 base_url、baseURL,会加上 /v1/messages,环境变量 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEYhttps://github.com/anthropics/anthropic-sdk-python 、https://github.com/anthropics/anthropic-sdk-typescript2026-09-27
@ai-sdk/anthropic 的接入地址要带 /v1Echo 验证环境中的实测2026-09-27
注册、发行密钥的流程,页面上的名称,余额更新的延迟,刚注册时的「API の利用を準備しています」Echo Token Station 的控制台(2026-09-28 时的页面)2026-09-28
充值的流程(选择金额的画面、跳转到 Stripe 的付款页面、支付后回到的页面)Echo 验证环境中的实测。用测试服务器代替会员网站 Echo AI Hub 和 Stripe2026-10-01