切换外观
API 文档
这里收录开发者自行编写网站、后端服务、脚本或自动化时可以直接调用的 API。目录按能力组织；每个已开放接口页均提供完整请求地址、参数说明和在线测试。
首次调用请从快速开始创建 API Key、选择模型，再到对话补全在线测试编辑 JSON 请求并查看原始响应。测试其他 API 时，在下方进入对应接口页，点击端点旁的发送按钮填写参数并查看完整响应，无需本地运行命令。已有客户端、IDE 和编码工具的配置见工具与集成。
当前按量接入
生成类请求使用账户余额按量计费，充值后按实际用量扣费；查询与本地 Token 统计不计费。套餐暂未开放；含 /coding/ 的旧路径不会自动改扣余额，已有配置需显式核对请求地址。
完整地址优先
请直接复制表格或详情页中的完整 HTTPS 地址。实际请求按你调用的完整地址执行，不会自动切换到另一个地址。
只有在 SDK 强制要求填写 Base URL 时，才使用与目标完整地址前缀一致的以下地址；Base URL 不能代替完整 API 地址：
https://api.tokenfactory.cn/v1https://api.tokenfactory.cn/anthropic
公开模型查询
查询模型信息：GET https://api.tokenfactory.cn/v1/public/models，无需 API Key，查询不计费。返回每个模型已开放的接口与具体操作，Responses 生成与 Compact 分别列出。
聊天（Chat）
| 能力 | 方法 | 完整公开地址 |
|---|---|---|
| 对话补全 | POST | https://api.tokenfactory.cn/v1/chat/completions |
| 创建 Response | POST | https://api.tokenfactory.cn/v1/responses |
| 压缩 Response 上下文 | POST | https://api.tokenfactory.cn/v1/responses/compact |
| 统计 Responses 输入 Token | POST | https://api.tokenfactory.cn/v1/responses/input_tokens |
| 创建 Anthropic 消息 | POST | https://api.tokenfactory.cn/anthropic/v1/messages |
| 统计 Anthropic 输入 Token | POST | https://api.tokenfactory.cn/anthropic/v1/messages/count_tokens |
图像（Images）
| 能力 | 方法 | 完整公开地址 |
|---|---|---|
| 生成图片 | POST | https://api.tokenfactory.cn/v1/images/generations |
| 编辑图片 | POST | https://api.tokenfactory.cn/v1/images/edits |
模型接口（Models）
| 能力 | 方法 | 完整公开地址 |
|---|---|---|
| 查询可用模型 | GET | https://api.tokenfactory.cn/v1/models |
| 查询 OpenAI 模型详情 | GET | https://api.tokenfactory.cn/v1/models/{model} |
| 查询 Anthropic 可用模型 | GET | https://api.tokenfactory.cn/anthropic/v1/models |
| 查询 Anthropic 模型详情 | GET | https://api.tokenfactory.cn/anthropic/v1/models/{model_id} |
模型列表、详情和聊天分类中的两类输入 Token 统计只鉴权，不收取生成费用。OpenAI 操作使用 Bearer API Key；Anthropic 操作接受 x-api-key 或 Bearer API Key，二选一；anthropic-version 为可选，缺省时按 2023-06-01 处理。生成类接口按实际用量扣取账户余额；具体鉴权、计量和限制见对应详情页。
两类输入 Token 统计由 Token Factory 在本地预估，不调用供应商或供应路线。只有纯文本以约 10% 偏差为工程目标，且不是逐请求保证；模型专有或其他 tokenizer 仍可能偏离，Reasoning/Thinking、 Tools 和多模态的误差可能明显更大。 OpenAI 普通 Tools 使用固定隐式预算，Anthropic Tools 使用确定性的隐式 system/toolset 预算； 图片、PDF 和文件使用固定偏高的分层占位预算，统一再增加 10%，但这些启发式并非严格上界， 高压缩多页 PDF 仍可能低估。预估值只用于请求前预算，不能作为账单、余额或实际生成 Usage。
Responses Input Tokens 的 input 可缺省或为 null，存在时必须是字符串或数组；只提供 instructions 和/或普通本地 tools 也可估算，Token Factory 为校验模型可见性仍要求 model。 URL 与 file_id 不抓取内容。显式 item_reference、裸 {id}、type 缺省/null 且含 id 的引用 因无法在本地还原服务端上下文而会被拒绝；tools[].type=mcp 可能动态发现远程 Schema，也必须先 展开为本地可见工具定义。Anthropic Count Tokens 要求提供 messages 数组；数组中的每项包含 role/content，tools 只接受数组或 null；document.source.type=text、 media_type=text/plain 的 data 按可见正文计数。两种协议中的未知可选字段会按其可见结构和文本 参与计数。
余额查询（Usage）
以下接口使用 Authorization: Bearer <API Key>，只读取当前 Key 所属账户的余额快照，不发起模型调用。
| 能力 | 方法 | 完整公开地址 |
|---|---|---|
| 查询余额 | GET | https://api.tokenfactory.cn/v1/user/balance |
文档边界
当前支持的多模态能力都复用对话接口，不需要另建 OCR 或音频端点：OpenAI Chat Completions 与 Responses 支持图片输入、OCR/看图问答、内联文件、音频输入与音频回答、Reasoning、工具调用、结构化输出和 Prompt Cache；Anthropic Messages 支持图片、内联 PDF/文档、工具、Thinking、结构化输出和 Prompt Cache。能力仍取决于所选模型及其已验证路线。
生成接口当前不支持 file_id，平台也不提供 Files 上传、查询、删除等生命周期接口。其他尚不支持的能力包括独立 Audio API、Realtime、Responses background、Conversations、WebSocket、Images Variations、视频理解/生成、音色克隆/管理，以及任何文本或多模态 Embeddings/Rerank。/v1/embeddings 与 /v1/rerank 不属于公开 API。未列出的路径不属于当前公开合同；第三方 AI 工具配置请前往工具与集成，模型详情请前往模型文档，当前价格见官网价格页。
上线前检查
首次调用成功后，按以下清单检查业务侧配置。接口参数与限制以对应详情页为准，通用兼容边界见兼容性说明。
- 密钥与环境：为应用和环境分别管理 API Key，存放于受保护的凭据位置；泄露或人员变动时及时停用、轮换。按接口详情选择鉴权和完整请求地址，只调用公开 API。
- 超时、并发与重试：配置连接、首字节、流空闲超时及客户端并发上限。按错误处理定位失败，按流式与重试决定后续动作；部分输出或未知结果不做无条件重放。
- 成本与权益保护：检查余额和每日消费上限，把模型价格、最大输出、请求大小与重试次数纳入预算。
- 日志与可观测性：记录平台请求编号、时间、接口、状态和耗时，便于排查；不记录 API Key、Authorization/Cookie、完整 prompt、完整输出或用户身份信息。
- 模型变化与故障准备：从模型文档或公开模型查询确认所需接口已开放并复制
model；定期更新缓存，查询失败时不把历史目录当作当前可用承诺。验证模型不可用、余额不足、超时或部分流中断时的提示、停止重试和恢复流程。