身份验证
Tokenlio API 使用 Bearer Token 形式的 API 密钥来对所有请求进行身份验证。
鉴权标头
在向任何 API 端点发送 HTTP 请求时，请务必附带 Authorization 请求头：
http
Authorization: Bearer tk-your-api-key-here环境变量配置
严禁将 API 密钥硬编码在代码或提交至代码仓库中。推荐使用环境变量统一管理：
Linux / macOS
bash
export TOKENLIO_API_KEY="tk-your-api-key-here"Windows (PowerShell)
powershell
$env:TOKENLIO_API_KEY="tk-your-api-key-here".env 文件
env
TOKENLIO_API_KEY=tk-your-api-key-here代码调用示例
python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["TOKENLIO_API_KEY"],
base_url="https://api.tokenlio.ai/v1"
)常见鉴权错误
| 状态码 | 错误码 | 原因与排查 |
|---|---|---|
401 Unauthorized | invalid_api_key | 密钥无效、已被停用或格式错误（需以 tk- 开头） |
401 Unauthorized | missing_api_key | 请求头中未携带 Authorization 字段 |
403 Forbidden | workspace_suspended | 空间欠费或账户状态异常 |