快速开始
说明注册账号、充值、发行 API 密钥这三个步骤,以及第一次调用 API。
按照本页的步骤,从注册账号一直做到第一次调用 API。步骤有三个:注册、充值、发行密钥。
注册免费,但调用 API 需要余额(充值 1,000 日元起)。注册赠送:[ ]
选择用法
| 用法 | 接入地址 | 在哪里读 |
|---|---|---|
| OpenAI 的 SDK | https://token.echohub.io/v1 | 本页 |
| Anthropic 的 SDK | https://token.echohub.io(不加 /v1) | 本页 |
| Claude Code | https://token.echohub.io(不加 /v1) | Claude Code |
| Codex CLI | https://token.echohub.io/v1 | Codex CLI |
| Cursor、Cline、Dify 等支持 OpenAI 格式的工具 | https://token.echohub.io/v1 | Cursor、Cline、Dify |
| 把现有的 SDK 代码切换到 Echo | 与各 SDK 相同 | 本页的「切换现有代码」 |
两种格式都用同一把 API 密钥。其他 SDK 和工具的接入地址,见 API 参考的「各 SDK 和工具的接入地址」。
1. 注册账号
会员网站 Echo AI Hub 公开后才能注册账号。2026-09-28 时,会员网站还没有公开,所以还不能注册和登录。
公开后的步骤如下。
- 打开控制台(https://token.echohub.io/console ),会跳转到 Echo AI Hub 的登录页面
- 在 Echo AI Hub 的页面上注册或登录。账号在两个网站通用
- 注册或登录完成后,会回到 Echo Token Station 的控制台(发行 API 密钥、查看使用情况的管理页面)
控制台只有日文。下面的步骤里,控制台上的名称用日文写,括号里是中文说明。
刚注册完时,控制台会显示「API の利用を準備しています」(正在准备 API 的使用)。准备好后,页面会自动切换。
2. 充值
- 在控制台的菜单里打开「残高とチャージ」(余额与充值),点「チャージする」(充值)
- 选择金额,点「お支払いへ進む」(前往付款),会跳转到 Stripe 的付款页面。用信用卡支付
- 支付完成后,会回到控制台的「残高とチャージ」。到余额更新可能需要几秒到 1 分钟左右。更新后页面会自动刷新
金额、有效期和使用顺序见价格与充值。
3. 发行 API 密钥
- 在控制台的菜单里打开「APIキー」(API 密钥),点「キーを発行」(发行密钥)
- 在「名前」(名称)里填一个能看出用途的名称(例:生产服务器)。要限制能用的金额时,也填上「利用上限(円)」(使用上限(日元))
- 点「発行する」(发行),会显示密钥。点「キーをコピー」(复制密钥)保存好。密钥是以
sk-开头的字符串
发行密钥的页面上,还会显示一段已经填好这把密钥的第一次调用的代码。
注意:不要把密钥给别人看。也不要写进公开的代码仓库或在浏览器里运行的代码。泄露时,请在控制台停用这把密钥。
第一次调用
把密钥放进环境变量
环境变量是设置在电脑或服务器上的、带名字的值。这样就不用把密钥直接写进代码。本文档使用 ECHO_API_KEY 这个名字。
# macOS・Linux
export ECHO_API_KEY="sk-..."# Windows(PowerShell)
$env:ECHO_API_KEY = "sk-..."安装 SDK 并调用
在下面的标签里选择语言和 SDK。选中的标签在本文档的其他页面也会保持。模型 ID(指定要调用哪个模型的字符串)只是示例。OpenAI 格式的示例用 deepseek-flash,Anthropic 格式的示例用 claude-sonnet-5。能用的模型 ID 可以在模型一览查看。
用 OpenAI 格式调用。
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": "日本の首都はどこですか?"}
]
}'# 创建并启用虚拟环境
python3 -m venv .venv && source .venv/bin/activate
pip install openaiimport os
from openai import OpenAI
client = OpenAI(
base_url="https://token.echohub.io/v1",
api_key=os.environ["ECHO_API_KEY"],
)
completion = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role": "user", "content": "日本の首都はどこですか?"}],
)
print(completion.choices[0].message.content)npm install openaiimport OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://token.echohub.io/v1",
apiKey: process.env.ECHO_API_KEY,
});
const completion = await client.chat.completions.create({
model: "deepseek-flash",
messages: [{ role: "user", content: "日本の首都はどこですか?" }],
});
console.log(completion.choices[0].message.content);保存为 index.ts,用 npx tsx index.ts 运行。
# 创建并启用虚拟环境
python3 -m venv .venv && source .venv/bin/activate
pip install anthropicimport os
import anthropic
client = anthropic.Anthropic(
base_url="https://token.echohub.io",
api_key=os.environ["ECHO_API_KEY"],
)
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "日本の首都はどこですか?"}],
)
print(message.content[0].text)Anthropic 的 SDK 会自动在接入地址后面加上 /v1/messages。base_url 不加 /v1。
npm install @anthropic-ai/sdkimport Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
baseURL: "https://token.echohub.io",
apiKey: process.env.ECHO_API_KEY,
});
const message = await client.messages.create({
model: "claude-sonnet-5",
max_tokens: 1024,
messages: [{ role: "user", content: "日本の首都はどこですか?" }],
});
const block = message.content[0];
if (block.type === "text") {
console.log(block.text);
}Anthropic 的 SDK 会自动在接入地址后面加上 /v1/messages。baseURL 不加 /v1。保存为 index.ts,用 npx tsx index.ts 运行。
成功时的响应
显示出回答的文字就是成功了。用 curl 时,会返回下面这样的 JSON(ID、时间和 token 数是示例)。
{
"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 的 SDK | Anthropic 的 SDK |
|---|---|---|
| 接入地址 | base_url(TypeScript 是 baseURL)设为 https://token.echohub.io/v1 | base_url(TypeScript 是 baseURL)设为 https://token.echohub.io |
| API 密钥 | Echo 的 API 密钥 | Echo 的 API 密钥 |
| 模型 ID | Echo 的模型 ID | Echo 的模型 ID |
以下是 Python 的 OpenAI SDK 要改的地方。
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。
# 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 验证环境中的实测。使用与正式环境相同的中转设置,并用返回测试响应的服务器代替上游 API | 2026-09-27 |
OpenAI SDK 的 base_url、baseURL,环境变量 OPENAI_BASE_URL、OPENAI_API_KEY | https://github.com/openai/openai-python 、https://github.com/openai/openai-node | 2026-09-27 |
Anthropic SDK 的 base_url、baseURL,会加上 /v1/messages,环境变量 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY | https://github.com/anthropics/anthropic-sdk-python 、https://github.com/anthropics/anthropic-sdk-typescript | 2026-09-27 |
@ai-sdk/anthropic 的接入地址要带 /v1 | Echo 验证环境中的实测 | 2026-09-27 |
| 注册、发行密钥的流程,页面上的名称,余额更新的延迟,刚注册时的「API の利用を準備しています」 | Echo Token Station 的控制台(2026-09-28 时的页面) | 2026-09-28 |
| 充值的流程(选择金额的画面、跳转到 Stripe 的付款页面、支付后回到的页面) | Echo 验证环境中的实测。用测试服务器代替会员网站 Echo AI Hub 和 Stripe | 2026-10-01 |