快速入门
快速开始
用 cURL、Python、JavaScript、Go 或 PHP 发出第一条 TokenLab API 请求:设置 API 密钥与接口地址,运行 Chat Completions 示例并验证响应。
获取 API 密钥
创建账号
用邮箱、Google 或 GitHub 账号在 tokenlab.sh 注册。
创建并保存 API 密钥
打开当前工作区的 API 密钥,创建密钥后立即保存完整值;完整密钥只显示一次。如果已经保存过完整密钥,使用保存的值即可。列表中显示或复制的前缀不能用于请求认证。
确认工作区余额
到账单查看余额。新账号可能获得一次试用额度;没有的话起始余额为 $0,第一次请求前需要充值(单次最低 $5)。请求按所选模型当前价格计费。
把 API 密钥当机密保存。不要写进前端代码,也不要提交到公开仓库。
为当前终端设置密钥
下面的命令不会把密钥写入命令本身,只对当前终端及其子进程生效。部署应用时请使用密钥管理器。
printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEY安装客户端
pip install openai发出第一条请求
大多数新接入,从 POST /v1/chat/completions 的 Chat Completions 开始就行。
curl https://api.tokenlab.sh/v1/chat/completions \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Reply only with OK."}]}'选择一种 SDK,将示例保存为 quickstart.py、quickstart.mjs、main.go 或 quickstart.php,再运行 python quickstart.py、node quickstart.mjs、go run . 或 php quickstart.php。Python、JavaScript 和 Go 使用 OpenAI 官方 SDK;PHP 使用社区维护的 OpenAI PHP 客户端,要求 PHP 8.2+。
只有需要 Responses 特有行为时才使用 POST /v1/responses。Responses 专属字段是否可用,取决于所选模型。
核对结果
成功请求应返回非空回答。打开同一工作区的记录,核对模型、状态和用量。报错时按排错指南处理。换模型和流式响应可继续阅读 SDK 指南。
为什么第一次调用返回 402?
第一次调用能否成功取决于账单中的余额。试用额度活动进行期间,符合条件的新账号可获得一次 $0.25,7 天内最多调用 10 次;第 11 次调用返回 402,提示免费试用次数已用完,即使额度还有剩余。余额为 $0 的账号会收到 HTTP 402,错误码为 insufficient_balance。到账单充值至少 $5(单次充值最低 $5),然后重新发送同一请求即可。不需要更换 API 密钥:余额足够后,已创建的密钥继续可用。
首次测试花费很少:用 deepseek-v4.1-flash 发一次示例请求,费用远低于 $0.01。
如果账户里已有余额,402 的报错会写明这次请求大约需要多少、当前余额多少。TokenLab 在调用开始前按完整的 max_tokens 预扣费用,所以长输入或较大的 max_tokens 可能超过少量余额。在 /v1/chat/completions 和 /v1/messages 上,调小 max_tokens 就能放得下时,报错还会给出建议降到的值;如果仅输入部分的费用就超过余额,报错会提示缩短输入。
API 密钥用满自身的消费上限时,也会返回 402,错误码为 quota_exceeded。到 API 密钥调高或取消上限即可。在代码里处理 402,见错误处理。