概述 · 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 配合使用。

批量任务（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" 上传文件。

供应商参数透传（`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）。

概述