概述 · Token360

Token360 API 兼容 OpenAI 接口规范，遵循 RESTful 设计约定。

基础 URL

https://api.token360.ai/v1

身份认证

所有请求都需要在 Authorization 请求头中提供 API Key：

Authorization: Bearer sk-your-api-key

请求格式

Content-Type：大多数接口使用 application/json，文件上传使用 multipart/form-data。
请求方法：推理和创建使用 POST，查询使用 GET，删除使用 DELETE。

请求示例

Shell

1curl -X POST https://api.token360.ai/v1/chat/completions \
2  -H "Authorization: Bearer sk-your-api-key" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "model": "glm-5.1",
6    "messages": [{"role": "user", "content": "Hello"}]
7  }'

响应格式

请求成功时，返回包含对应接口数据的 JSON 响应：

JSON

1{
2  "id": "your-chat-completion-id",
3  "object": "chat.completion",
4  "created": 1677652288,
5  "model": "glm-5.1",
6  "choices": [...],
7  "usage": {
8    "prompt_tokens": 10,
9    "completion_tokens": 20,
10    "total_tokens": 30
11  }
12}

请求失败时，返回统一格式的错误响应：

JSON

1{
2  "error": {
3    "message": "Description of the error",
4    "type": "error_type",
5    "param": null,
6    "code": "error_code"
7  }
8}

SDK 支持

Token360 兼容 OpenAI 官方 SDK：

1# Python
2from openai import OpenAI
3client = OpenAI(api_key="sk-...", base_url="https://api.token360.ai/v1")

任何支持自定义 OpenAI base URL 的库或工具都可以与 Token360 配合使用。

原生 LLM 端点

Token360 支持三种 LLM 请求风格：

POST /v1/chat/completions — OpenAI 兼容聊天补全，使用 Token360 的归一化路由与响应处理。
POST /v1/responses — OpenAI Responses API 原生透传，适用于 OpenAI/OpenAI 兼容供应商。当前仅支持无状态调用：Token360 会拒绝 previous_response_id、conversation、background: true 与显式 store: true。
POST /v1/messages — Anthropic Messages API 原生透传，适用于 Anthropic/Claude/Z.AI 兼容供应商。平台鉴权同时支持 Authorization: Bearer sk-... 与 Anthropic 风格的 x-api-key: sk-...。

原生透传端点会返回供应商原生 JSON 或 SSE 事件。Token360 仍会负责 API Key 鉴权、供应商路由、供应商密钥注入、计费、统计与归档记录。

批量任务（Batch）

Token360 提供 OpenAI 兼容 Batch API，用于异步聊天补全：

GET /v1/batches/models — 查询当前账户支持 batch 的模型名
POST /v1/files（purpose=batch）+ POST /v1/batches — 提交 JSONL 输入
GET /v1/batches/{batch_id} — 轮询状态；通过 GET /v1/files/{file_id}/content 下载结果

详见 文档 → 批量任务 与 API 参考 → 批量任务。可使用 OpenAI SDK，base_url=https://api.token360.ai/v1，调用 client.batches.* 与 purpose="batch" 上传文件。

账户余额

GET /v1/billing/balance — 查询当前认证账户的可支付余额（钱包 + Credit）

详见 API 参考 → 账单 → 查询账户余额。

API Key 管理

Token360 在 /v1 下提供 OpenRouter 兼容的 API Key 管理接口：

GET /v1/key — 查询当前请求所使用的 API Key
GET /v1/keys — 列出你的 API Keys
POST /v1/keys — 创建新的 API Key
PATCH /v1/keys/{hash} — 通过 hash 更新 API Key
DELETE /v1/keys/{hash} — 通过 hash 删除 API Key

详见 API 参考 → API Keys。这些接口不使用后端 R<T> 包装，返回 OpenRouter 风格 JSON。

供应商参数透传（`Token360-Native-Params`）

对 POST /v1/videos、POST /v1/images/generations、POST /v1/audio/speech，可在请求头设置 Token360-Native-Params: true，按厂商原生 JSON 组织请求体（而非默认的 OpenAI 风格归一化字段）。

网关仍会完成 API Key 鉴权、model → 供应商模型名 改写，以及 asset:// 校验与映射。完整约定、支持端点与排错说明见 文档 → 参数透传（Token360-Native-Params）。

概述