支持 OpenAI Chat Completions、Responses 与 Anthropic Messages 接入。
文档目录
TokenCraft · API Documentation
企业 AI API
接入文档
面向使用 TokenCraft 的开发团队，按真实接入顺序说明如何创建 API Key、选择协议与模型、完成首次调用，并在控制台核对用量与排查问题。
正式 Model ID、渠道路由和当前价格统一以模型广场为准。
在控制台按 API Key、模型、时间和请求标识核对调用。
01 · Groups
如何选择分组
创建 API Key 时，使用国产模型请选择 default 分组。完整 Model ID、当前价格和可用状态以模型广场为准。
| 分组名称 | 适合场景 | 主要可选模型 | 特点与注意事项 |
|---|---|---|---|
国产模型常用default | 中文业务、知识库问答、日常开发 | DeepSeek系列模型、Kimi系列模型、GLM（智谱）系列模型、Minimax系列模型。 | 使用国产模型时优先选择；系统的自动分组当前也从该组开始路由。 |
快速选择：国产模型选 default。
02 · Quickstart
快速接入
先用控制台生成的 Key 和模型广场中的正式 Model ID 完成一次最小调用，再接入业务系统。
复制接口地址
OpenAI 兼容 SDK 使用 https://api.tokencraft.cc/v1；Claude 原生 Messages 请求使用 /v1/messages。
03 · API Key
API Key 与安全
不同环境、项目和自动化工具使用独立 Key，后续才能准确定位成本并单独停用。
Create
创建时设置用途
填写可识别的名称，并按需设置过期时间和可用额度。Key 额度是访问上限，不是独立钱包；实际消费仍从账户余额扣除。
Store
完整 Key 只保存一次
创建后立即存入服务端密钥管理或环境变量。不要写入前端代码、公开仓库、客户端安装包或日志。
Rotate
泄露时先停用再轮换
发现异常调用时立即在 API Keys 页面停用旧 Key、创建新 Key，并检查使用日志中的时间和模型。
Least access
生产与测试隔离
为生产、测试和个人 Agent 分别建 Key。只向需要调用的服务提供，不在群聊或工单中发送完整值。
请求头：OpenAI 兼容接口使用 Authorization: Bearer YOUR_API_KEY；Anthropic Messages 同时兼容 x-api-key: YOUR_API_KEY。
04 · API
协议与端点
优先选择当前 SDK 原生支持的协议。所有生产请求都发往 TokenCraft API 域名，不要把 API 路径发到控制台域名。
| 协议 | 端点 | 适用场景 |
|---|---|---|
| OpenAI Chat | /v1/chat/completions | OpenAI SDK、常见业务系统与多数 Agent 工具 |
| OpenAI Responses | /v1/responses | 支持 Responses API 的新客户端与工具 |
| Anthropic Messages | /v1/messages | Claude Code 与使用 Anthropic 原生消息格式的程序 |
| Models | /v1/models | 查询当前 Key 可访问的模型 ID |
curl https://api.tokencraft.cc/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [{"role":"user","content":"你好"}],
"stream": false
}'from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.tokencraft.cc/v1",
)
response = client.chat.completions.create(
model="MODEL_ID",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
baseURL: "https://api.tokencraft.cc/v1",
});
const response = await client.chat.completions.create({
model: "MODEL_ID",
messages: [{ role: "user", content: "你好" }],
});
console.log(response.choices[0].message.content);curl https://api.tokencraft.cc/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "MODEL_ID",
"max_tokens": 1024,
"messages": [{"role":"user","content":"你好"}]
}'05 · Models & pricing
模型、路由与价格
模型广场是公开 Model ID、渠道差异和当前价格的唯一展示入口；调用前请根据当前 Key 的分组和可用范围进行核对。
Model ID
它也是路由与计费标识
请求中的 model 必须填写模型卡片展示的完整 ID。名称相近不代表价格或链路相同。
Same model
同模型可有多条公开路线
当同一底层模型来自不同渠道且价格差异明显时，平台会用不同的公开 Model ID 分开展示和计费。
Availability
显示不等于当前 Key 已开通
模型广场说明站点提供的路线；你的 Key 实际可用范围，以 GET /v1/models 返回和控制台配置为准。
Price
调用前确认输入输出价
价格、倍率、上下文限制和促销可能调整。正式调用前请查看对应模型卡片，不以文档示例作为结算依据。
06 · Tools
开发工具配置
核心参数只有三个：API Key、接口地址、正式 Model ID。修改本机配置前，先确认终端或项目中是否已有同名环境变量。
Node.js · OpenAI 兼容
在项目目录安装官方 OpenAI SDK，再通过服务端环境变量提供凭据。
npm install openai
export OPENAI_API_KEY="YOUR_API_KEY" export OPENAI_BASE_URL="https://api.tokencraft.cc/v1" export MODEL_ID="MODEL_ID"
Codex · OpenAI 兼容
安装 Codex CLI，并在启动它的终端设置 TokenCraft Key、Base URL 和 Model ID。字段随客户端版本可能变化，请以本机版本帮助信息为准。
npm install -g @openai/codex
export OPENAI_API_KEY="YOUR_API_KEY" export OPENAI_BASE_URL="https://api.tokencraft.cc/v1" export MODEL_ID="MODEL_ID" codex
Claude Code · Anthropic 原生
Claude Code 的 Base URL 使用域名根地址，不附加 /v1；模型填写已开通的 Anthropic 路线 ID。
npm install -g @anthropic-ai/claude-code
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_BASE_URL="https://api.tokencraft.cc" export ANTHROPIC_MODEL="MODEL_ID" claude
OpenClaw / Hermes · 自定义 Provider
在工具的 Provider 配置中选择 OpenAI-compatible，填入下面三项。不同版本的配置文件路径和字段名可能不同。
base_url: https://api.tokencraft.cc/v1 api_key: YOUR_API_KEY model: MODEL_ID
07 · Console
用量、余额与账单
控制台记录账户实际状态。用量可能存在短暂同步延迟，核对时保持模型、Key 和时间范围一致。
08 · Troubleshooting
错误码与排查
先检查请求格式、Key、余额与模型权限。仍无法解决时，请保留请求时间和响应头中的请求 ID。
| 状态码 | 常见原因 | 建议处理 |
|---|---|---|
400 | 请求体、协议字段或模型参数不正确 | 对照对应协议示例，确认 JSON、消息结构与 Model ID |
401 | API Key 缺失、无效或已停用 | 检查请求头；必要时创建新 Key 并轮换 |
403 | 当前账户或 Key 没有该操作权限 | 确认账户状态与 Key 配置，联系管理员 |
404 | 端点错误、模型不存在或未开通 | 确认请求发往 API 域名，并核对模型广场与 /v1/models |
429 | 余额/Key 额度不足，或触发平台、上游限流 | 检查钱包、Key 额度与调用频率，降低并发后重试 |
5xx | 平台或上游服务异常 | 有限次退避重试；持续失败时携带请求 ID 联系支持 |
联系支持时请提供：请求时间、完整 Model ID、Key 名称（不要发送完整 Key）、HTTP 状态码，以及响应头 X-Oneapi-Request-Id；若存在，也一并提供 X-Upstream-Request-Id。
09 · Updates
文档更新
协议、端点、计费口径或控制台路径有变化时，会在这里记录影响接入的更新。
统一 TokenCraft 正式品牌和 API 域名为 api.tokencraft.cc。