概述 · 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": "claude-opus-5",
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": "claude-opus-5",
6  "choices": [...],
7  "usage": {
8    "prompt_tokens": 10,
9    "completion_tokens": 20,
10    "total_tokens": 30
11  }
12}

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

JSON

1{
2  "code": "400",
3  "error": {
4    "message": "Description of the error",
5    "type": "error_type",
6    "param": null,
7    "code": "error_code",
8    "traceId": "request-correlation-id"
9  },
10  "traceId": "request-correlation-id"
11}

请以 HTTP 状态作为判断请求失败的首要依据。字段说明和重试建议请参阅 错误处理。

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 鉴权、供应商路由、供应商密钥注入、计费、统计与归档记录。

异步 Chat

POST /v1/async/chat/completions 提交单条非流式聊天任务（stream 必须为 false）。用 GET /v1/async/chat/completions/{job_id} 轮询至 completed / failed / cancelled / expired。非终态可用 POST /v1/async/chat/completions/{job_id}/cancel 取消。计费与同步 Chat 相同（含企业价格因子）；对账用 GET /v1/billing/requests/{request_id}。

批量任务（Batch）

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

GET /v1/batches/models — 当前账户可提交到 POST /v1/batches 的 LLM（supports_provider_batch 表示还有上游原生 Batch；现网多数为 false）
POST /v1/files（purpose=batch）+ POST /v1/batches — 提交 JSONL；可选 execution：auto（默认）/ provider / platform
GET /v1/batches/{batch_id} — 轮询状态；通过 GET /v1/files/{file_id}/content 下载结果
创建时可传 callback_url（或控制台 批量任务 → Webhook）— 终态 HTTPS POST，见 Webhook

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

账单与账户余额

GET /v1/billing/requests/{request_id} — 使用请求 ID 或受支持的响应、消息、生成任务/媒体 ID 查询单次调用的用量与费用，支持包含斜杠的 ID
GET /v1/billing/balance — 查询当前认证账户的可支付余额（钱包 + Credit）

支持的 ID、示例及查询错误详见 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）。

概述