快速开始

用 cURL、Python、JavaScript、Go 或 PHP 发出第一条 TokenLab API 请求：设置 API 密钥与接口地址，运行 Chat Completions 示例并验证响应。

获取 API 密钥

创建账号

用邮箱、Gmail 或 GitHub 账号在 tokenlab.sh 注册。

创建并保存 API 密钥

打开当前工作区的 API 密钥，创建密钥后立即保存完整值；完整密钥只显示一次。如果已经保存过完整密钥，使用保存的值即可。列表中显示或复制的前缀不能用于请求认证。

确认工作区余额

到账单充值并查看可用余额。本次请求按所选模型当前价格计费。

把 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+。