TokenCraft API Documentation
企业 AI API 接入技术文档
本文档面向 TokenCraft 企业客户和开发团队，说明如何获取 API Key、选择 OpenAI 兼容或 Anthropic 原生接口、完成首次调用、接入常用开发工具、查看用量账单，并在调用异常时进行定位。
Quickstart
快速接入
快速接入部分按照真实操作顺序组织。每一步均配有控制台截图标注，客户可以直接对照界面完成配置。
1创建 API Key
进入企业控制台后，打开「API Keys」页面并创建新的 API Key。建议不同项目、环境或工具分别创建独立 Key，避免多业务混用。
- 备注应包含项目、环境和用途，例如 prod-api-main、codex-dev。
- 如需控制单个 Key 的消耗，可设置日额度上限。
- 完整 Key 仅在创建成功后显示一次，请妥善保存。
2复制 Key 与接口地址
API Key 创建完成后，复制完整 Key，并根据调用协议配置对应接口地址。OpenAI SDK、Codex、Cursor、VS Code 插件通常使用 OpenAI 兼容 Base URL；Claude Code 使用 Anthropic 原生协议配置。
- OpenAI 兼容 Base URL：https://api.tokencraft.cc/v1。
- Anthropic 原生 Messages 接口：https://api.tokencraft.cc/v1/messages。
- Claude Code 的 ANTHROPIC_BASE_URL 使用 https://api.tokencraft.cc。
- 请勿将 API Key 写入前端代码、公开仓库或客户端安装包。
tc-sk-******************************a8F2OpenAI Base URL: https://api.tokencraft.cc/v1Anthropic endpoint: https://api.tokencraft.cc/v1/messagesAPI
API 调用
TokenCraft 同时提供 OpenAI 兼容接口和 Anthropic 原生接口。调用 GPT、Kimi、GLM 等 OpenAI-compatible 模型时使用 OpenAI 兼容 Base URL；调用 Claude 原生 Messages 协议或配置 Claude Code 时使用 Anthropic 原生接口。
| 协议 | 端点 | 适用场景 |
|---|---|---|
| OpenAI 兼容 | https://api.tokencraft.cc/v1/chat/completions | 业务系统集成、OpenAI SDK、Codex、Cursor、VS Code 插件。 |
| Anthropic 原生 | https://api.tokencraft.cc/v1/messages | Claude Code，以及需要 Claude Messages 原生协议的工具。 |
Model IDs
可用模型 ID 与官网刊例价
请求参数中的 model 填写下表中的模型 ID。官网刊例价用于客户初步估算成本，实际开通模型、优惠价格、额度、并发和账单规则，以报价单、合同或控制台开通范围为准。
| 模型 ID | 类别 | 任务场景 | 计量单位 | 官网刊例输入单价（元 / 百万 tokens） | 官网刊例输出单价（元 / 百万 tokens） |
|---|---|---|---|---|---|
kimi-k2.6 | 大语言 | 文本生成 | 每百万 tokens | ¥6.5 | ¥27 |
GLM-5.1 | 大语言 | 文本生成 | 每百万 tokens | 输入 < 32K：¥6输入 ≥ 32K：¥8 | 输入 < 32K：¥24输入 ≥ 32K：¥28 |
cl-st-4-6 | 大语言 | 文本生成 | 每百万 tokens | ¥21 | ¥105 |
gt-5.5 | 大语言 | 文本生成 | 每百万 tokens | 上下文 < 272K：¥35上下文 ≥ 272K：¥70 | 上下文 < 272K：¥210上下文 ≥ 272K：¥315 |
model。如企业账号尚未开通某个模型，请联系 TokenCraft 开通后再调用；未开通模型会返回模型不可用或模型未开通错误。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": "你好，请用一句话介绍 TokenCraft。"}
],
"stream": false
}'Tools
开发工具配置
以下配置适用于常见编码工具。不同版本的字段名称可能略有差异，请以工具当前版本界面为准；核心参数保持一致：API Key、接口地址、Model ID。
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_BASE_URL="https://api.tokencraft.cc"
# 模型 ID 以 TokenCraft 控制台或项目报价单为准。Console
API Key 与用量
控制台用于管理 API Key、查看余额、追踪调用用量和下载账单材料。用量同步存在一定延迟，通常用于账单归集和客户内部核对。
3查看用量明细
调用接口后，可以在「用量明细」中按 API Key、模型和日期范围筛选记录。建议开发、测试、生产环境分别使用独立 Key，方便定位成本来源。
- API Key 备注会显示在用量记录中。
- 模型名来自实际调用日志，可能包含历史已下线模型。
- 月度账单可导出 CSV，用于企业内部对账。
Billing
余额、账单与价格
TokenCraft 采用企业账户余额和项目报价单管理模型使用费用。模型版本、上下文长度、并发限制、试运行额度和正式价格，以 TokenCraft 出具的报价单、合同或控制台开通范围为准。
4核对余额与账单
企业控制台首页会展示当前可用余额和近期用量摘要。需要做月度核对时，可进入「账单导出」下载 CSV，并结合 API Key 备注确认各项目消耗。
- 余额用于判断当前企业账户是否可继续调用。
- 账单导出用于客户内部财务核对和项目分摊。
- 如价格、额度或模型范围与合同不一致，请以正式报价单和开通范围为准。
Troubleshooting
错误码与排查
当请求失败时，请先根据错误类型检查 API Key、余额、模型权限和请求格式。如需联系 TokenCraft 支持，请提供请求时间、模型 ID、Key 备注和 X-TC-Request-Id。
5保留请求 ID
TokenCraft 会在响应头中返回请求 ID。请求 ID 可帮助支持团队定位网关日志、上游响应和账单记录。
- 认证失败：检查 Key 是否正确、是否已吊销。
- 余额不足：检查企业余额或 Key 日额度。
- 模型未开通：确认模型 ID 是否在企业开通范围内。
- 服务异常：保留 X-TC-Request-Id 并联系支持。
{
"error": "余额不足，请到控制台充值。",
"request_id": "tc_req_20260620_xxxxxx"
}X-TC-Request-Id: tc_req_20260620_xxxxxx| 状态码 | 含义 | 处理方式 |
|---|---|---|
| 401 | API Key 无效或已被吊销 | 检查 Authorization 或 x-api-key 请求头，确认 Key 来自 TokenCraft 控制台且状态为 active。 |
| 429 | 余额不足、Key 配额不足或上游限流 | 检查企业余额、Key 日额度和调用频率；必要时联系 TokenCraft 支持。 |
| 404 | 模型未开通或模型 ID 不正确 | 确认模型 ID 与控制台或报价单中的开通范围一致。 |
| 500 | 平台或上游服务异常 | 保留请求时间和 X-TC-Request-Id，联系 TokenCraft 支持排查。 |