开发者文档

切换外观

统计 Responses 输入 Token ​

POST/responses/input_tokens

接口说明 ​

由 Token Factory 在本地对 Responses 输入做保守 Token 预估，不调用供应商；成功体保持 OpenAI Responses Input Tokens 的 object 与 input_tokens 字段，结果只用于请求前预算，不参与计费。

请求 ​

  • 方法：POST

  • 鉴权：Authorization: Bearer ${TOKENFACTORY_API_KEY}

请求头 ​

名称必填值或类型说明
Authorization是Bearer ${TOKENFACTORY_API_KEY}Token Factory API Key
Content-Type是application/json请求体媒体类型

路径参数：无

查询参数：无

请求字段 ​

字段类型必填说明示例或约束
conversationobject否当前不支持；请将会话内容展开后直接传入 input。—
inputstring 或 object[]否可缺省或为 null；存在时必须是字符串或 Responses 输入项数组。只提供 instructions 和/或 tools 也可预估。input 项中的 item_reference，以及裸 {id}、type 缺省或 null 且含 id 的引用，都无法在本地还原服务端上下文，提供时返回 400 invalid_request_error。示例：[{"content":[{"text":"解释图片与文档","type":"input_text"},{"detail":"auto","image_u...；可为 null；形式：string 或 object[]
input[].acknowledged_safety_checksobject[]否已确认的计算机操作安全检查数组。—
input[].actionobject否Web Search 或 Computer 操作。—
input[].approval_request_idstring否MCP 审批请求 ID。—
input[].approveboolean否是否批准 MCP 调用。—
input[].argumentsstring否函数参数 JSON 字符串。—
input[].authorizationstring否MCP 调用授权值。—
input[].call_idstring否工具调用 ID。—
input[].callerobject否工具调用来源。—
input[].commandobject否Shell 或计算机命令。—
input[].commandsstring[]否命令字符串数组。—
input[].connector_idstring否MCP Connector ID。—
input[].contentstring 或 object[]否消息文本或图片/内联文件内容块数组。示例：[{"text":"解释图片与文档","type":"input_text"},{"detail":"auto","image_url":"data:im...；形式：string 或 object[]
input[].content[].detailstring否输入图片或文件细节级别；接受非空字符串，可用值由供应商判断。最短：1 字符
input[].content[].file_datastring否Base64 data URL 文件内容。—
input[].content[].file_idstring否官方 Files 引用 ID；Token Factory 当前未实现 Files 生命周期，发送即返回 400 invalid_request_error。—
input[].content[].file_urlstring否文件 URL。—
input[].content[].filenamestring否内联文件名。—
input[].content[].image_urlstring否图片 URL 或 data URL。—
input[].content[].prompt_cache_breakpointobject否显式 Prompt Cache 断点。—
input[].content[].textstring否输入文本。示例："解释图片与文档"
input[].content[].typestring父字段存在且匹配该形式时必填输入内容块类型。示例："input_text"；可选值："input_text"、"input_image"、"input_file"
input[].encrypted_contentstring否不透明加密上下文。—
input[].idstring否既有输入项 ID。—
input[].namestring否工具或函数名。—
input[].namespacestring否工具命名空间。—
input[].outputobject否工具调用输出。—
input[].pending_safety_checksobject[]否等待确认的计算机操作安全检查数组。—
input[].queriesstring[]否搜索查询字符串数组。—
input[].resultsobject[]否工具调用结果数组。—
input[].rolestring否消息角色。示例："user"
input[].server_labelstring否MCP Server 标签。—
input[].server_urlstring否MCP Server URL。—
input[].shell_idstring否Shell 会话 ID。—
input[].statusstring否输出项状态。可选值："in_progress"、"completed"、"incomplete"
input[].summaryobject[]否Reasoning 摘要块数组。—
input[].toolsobject[]否动态发现的工具定义数组。—
input[].typestring否输入项类型。—
instructionsstring否参与 Token 统计的系统级指令字符串。示例："请准确回答"；可为 null
modelstring是要统计输入 Token 的模型 ID；Token Factory 为校验平台模型可见性要求必填。示例："YOUR_MODEL_ID"
previous_response_idstring否当前不支持；提供时返回 invalid_request_error，请改为直接传入完整 input。—
promptobject否当前不支持远程 Prompt 模板；请将模板展开为本地输入字段。—
reasoningobject否参与本地 Token 预估的 Reasoning 设置。示例：
textobject否参与本地 Token 预估的文本输出配置。示例：{"format":{"name":"answer","schema":{"type":"object"},"type":"json_schema"}}
toolsobject[]否参与本地 Token 预估的工具定义数组，可为 null；普通 function 等本地可见工具使用固定隐式预算，type=mcp 可通过 server_url、connector 或 tunnel 动态发现远程 Schema，提供时返回 400；请先展开为本地可见工具定义。示例：[{"name":"lookup","parameters":{"properties":{},"type":"object"},"type":"func...；可为 null

请求报文 ​

媒体类型：application/json

json
{
  "input": [
    {
      "content": [
        {
          "text": "解释图片与文档",
          "type": "input_text"
        },
        {
          "detail": "auto",
          "image_url": "data:image/png;base64,...",
          "type": "input_image"
        },
        {
          "file_data": "data:application/pdf;base64,...",
          "filename": "example.pdf",
          "type": "input_file"
        }
      ],
      "role": "user"
    }
  ],
  "instructions": "请准确回答",
  "model": "YOUR_MODEL_ID",
  "prompt_cache_key": "example-cache-key",
  "reasoning": {
    "effort": "high",
    "summary": "auto"
  },
  "store": false,
  "text": {
    "format": {
      "name": "answer",
      "schema": {
        "type": "object"
      },
      "type": "json_schema"
    }
  },
  "tools": [
    {
      "name": "lookup",
      "parameters": {
        "properties": {},
        "type": "object"
      },
      "type": "function"
    }
  ]
}

响应 ​

成功状态：200

响应头 ​

名称值或类型说明
Content-Typeapplication/json响应媒体类型
request-idstringToken Factory 独立生成的平台请求编号；Anthropic 错误体的 request_id 与其相同。
x-request-idstringToken Factory 独立生成的平台请求编号，与 request-id 相同。
x-tokenfactory-token-estimatestringToken Factory 本地预估算法版本，当前为 o200k-heuristic-v2。

响应字段 ​

Token Factory 本地保守预估结果；成功体保持 OpenAI Responses Input Tokens 字段。 下表完整列出当前公开协议明确声明的字段；开放扩展只允许未声明的附加字段，不会放宽已声明字段的必填、类型或枚举约束。

字段类型必填说明示例或约束
input_tokensinteger (int64)是平台本地保守预估的输入 Token 数；不等同于供应商 Usage 或计费事实。示例：41；最小值：0
objectstring是响应对象类型，固定为 response.input_tokens。示例："response.input_tokens"；可选值："response.input_tokens"

返回报文 ​

媒体类型：application/json

json
{
  "input_tokens": 41,
  "object": "response.input_tokens"
}

错误 ​

适用完整地址状态错误码常见触发重试建议动作结果风险
https://api.tokenfactory.cn/v1/responses/input_tokens401invalid_api_keyAuthorization 缺失、Bearer 格式错误、Key 不可用或账户未实名否检查 Bearer API Key、Key 状态与实名状态无
https://api.tokenfactory.cn/v1/responses/input_tokens404model_not_found模型不存在、未上架或当前入口不可用否调用模型列表并改用当前入口可用模型无
https://api.tokenfactory.cn/v1/responses/input_tokens413request_too_large请求体超过平台接收上限否缩小请求体后重试无
https://api.tokenfactory.cn/v1/responses/input_tokens400invalid_request_error请求参数或请求体缺字段、格式错误或不受支持否修正请求后重试无
https://api.tokenfactory.cn/v1/responses/input_tokens500internal_error平台内部出现未预期错误视情况确认未收到有效结果并记录请求时间后再决定是否重试中到高
https://api.tokenfactory.cn/v1/responses/input_tokens405method_not_allowed请求方法不是该公开地址允许的方法否改用文档列出的 HTTP 方法无
https://api.tokenfactory.cn/v1/responses/input_tokens415unsupported_media_typeContent-Type 与该公开地址要求的媒体类型不一致否按文档发送正确 Content-Type无

错误返回报文 ​

适用完整地址 ​

https://api.tokenfactory.cn/v1/responses/input_tokens

HTTP 400；Content-Type: application/json；响应头：request-id: string、x-request-id: string

json
{
  "error": {
    "code": "invalid_request_error",
    "message": "请求参数或请求体缺字段、格式错误或不受支持",
    "param": null,
    "type": "invalid_request_error"
  }
}

限制与计费 ​

适用完整地址限制或计费说明
https://api.tokenfactory.cn/v1/responses/input_tokens由 Token Factory 使用版本化启发式算法在本地保守预估，不调用供应商或供应路线。
只鉴权，不检查或扣减余额。
纯文本 input/instructions 以对应模型实际输入 Token 偏差约 10% 以内为工程目标，但不是逐请求保证；模型专有或其他 tokenizer 仍可能偏离，Reasoning、Tools 与多模态不在该目标内。
OpenAI 普通 Tools 除可见 JSON 计数外追加固定隐式预算；非空 Reasoning 也追加固定协议预算，隐藏开销下误差可能明显大于 10%。
图片和文件/PDF 使用固定偏高的分层占位预算，再与其他基础值统一增加 10%；这些预算是启发式而非严格上界，高压缩多页 PDF 仍可能低估。
URL/file_id 不抓取内容，text/plain 的 data 按可见正文计数；未知可选字段的可见结构和文本也会参与计数。
input 可缺省或为 null；存在时必须是字符串或数组，仅提供 instructions 和/或 tools 也可预估。
不支持 conversation、previous_response_id、远程 prompt 模板、item_reference、裸 {id} 或 type 缺省/null 且含 id 的引用；不支持可动态发现远程 Schema 的 type=mcp 工具，调用方必须先将上下文与工具定义展开到本地可见字段，否则返回 400 invalid_request_error。

相关说明 ​

这是平台当前可用模型列表；只鉴权、不计费，可用模型会随所用完整地址和上架状态变化。

TokenFactory 词元工厂 · 开发者文档 · 返回官网

无锡伟瑞达科技有限公司 · 苏ICP备2025202631号-3 · 苏公网安备32021302003207号