API 参考
TokAPI 网关的接口、认证与示例。
Base URL
https://api.tokapi.ai身份认证
将你的 TokAPI 密钥作为 Bearer token 发送：
Authorization: Bearer sk-lazytech-...也接受 x-api-key: sk-lazytech-... 请求头。公开接口无需认证。
公开接口
无需认证。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /v1/ping | 健康检查。 |
| GET | /v1/models | 列出完整模型目录。 |
| GET | /v1/models/{model} | 获取单个模型。 |
兼容 OpenAI 的接口
需要 Bearer 密钥。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/responses | 创建响应（Responses 接口）。 |
| GET | /v1/responses/{response_id} | 获取响应。 |
| POST | /v1/chat/completions | Chat Completions 接口。 |
| POST | /v1/conversations | 创建会话。 |
| GET | /v1/conversations/{conversation_id} | 获取会话。 |
| POST | /v1/conversations/{conversation_id} | 更新会话。 |
| DELETE | /v1/conversations/{conversation_id} | 删除会话。 |
兼容 Claude 的接口
需要 Bearer 密钥。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/messages | Anthropic Messages 接口。 |
| POST | /v1/messages/count_tokens | 为消息请求统计 tokens。 |
文件
需要 Bearer 密钥。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/files | 上传文件（multipart）。 |
| PUT | /v1/files/{path} | 上传/替换文件（流式请求体）。 |
用量
需要 Bearer 密钥。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /v1/usage | 以百分比形式返回额度用量。参见用量 API。 |
示例 —— POST /v1/responses
curl https://api.tokapi.ai/v1/responses \
-H "Authorization: Bearer sk-lazytech-..." \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"input": "用一句话概括相对论。"
}'示例 —— POST /v1/messages
curl https://api.tokapi.ai/v1/messages \
-H "Authorization: Bearer sk-lazytech-..." \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-8",
"max_tokens": 1024,
"messages": [{ "role": "user", "content": "你好，Claude！" }]
}'在任意接口上设置 "stream": true 即可接收 Server-Sent Events。
错误码
| 状态码 | 含义 |
|---|---|
| 400 | 请求体或模型无效。 |
| 401 | 缺少或无效的 API key。 |
| 402 | 额度或时间窗口已耗尽。 |
| 403 | 密钥被禁用、已过期或无权限。 |
| 404 | 资源不存在。 |
| 429 | 触发限流。 |
| 500 | 服务器错误。 |
| 502 | 上游服务商失败。 |
| 503 | 功能或容量不可用。 |