开发者文档

切换外观

对话补全 ​

POST/chat/completions

接口说明 ​

使用 Bearer API Key 发起 OpenAI 兼容对话补全；支持图片、OCR/看图问答、内联文件、音频输入与音频回答、Reasoning、工具、结构化输出、Prompt Cache，以及普通 JSON 或 stream=true 的 SSE。

请求 ​

  • 方法：POST

  • 鉴权：Authorization: Bearer ${TOKENFACTORY_API_KEY}

请求头 ​

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

路径参数：无

查询参数：无

请求字段 ​

字段类型必填说明示例或约束
audioobject否请求 audio 输出时的格式与音色设置。示例：{"format":"wav","voice":"alloy"}；可为 null
audio.formatstring父字段存在时必填音频输出格式。示例："wav"；可选值："wav"、"aac"、"mp3"、"flac"、"opus"、"pcm16"
audio.voicestring 或 object父字段存在时必填官方预置音色名或自定义音色引用对象。示例："alloy"；形式：string 或 object
frequency_penaltynumber否词频惩罚，范围 -2 到 2。最小值：-2；最大值：2；可为 null
function_callstring 或 object否已弃用；请改用 tool_choice。形式：string 或 object
function_call.namestring父字段存在且匹配该形式时必填函数名。—
functionsobject[]否已弃用的函数定义数组；请改用 tools。—
functions[].descriptionstring否函数说明。—
functions[].namestring父字段存在时必填函数名。—
functions[].parametersobject否函数参数 JSON Schema。—
functions[].strictboolean否是否严格遵守 JSON Schema。—
logit_biasobject否Token ID 到偏置值的映射，值范围 -100 到 100。可为 null
logprobsboolean否是否返回输出 Token 的对数概率。可为 null
max_completion_tokensinteger (int32)否最大输出 Token 数，包含可见与 Reasoning Token。最小值：1；可为 null
max_tokensinteger (int32)否已弃用的最大输出 Token 数；请改用 max_completion_tokens。最小值：1；可为 null
messagesobject[]是OpenAI 兼容消息数组；每项必须包含 role，content、tool_calls、function_call、tool_call_id 与 name 按角色条件提供。示例：[{"content":"你好","role":"user"}]
messages[].audioobject否assistant 对先前音频回答的引用。—
messages[].audio.idstring父字段存在时必填先前音频回答 ID。—
messages[].contentstring 或 object[]否消息内容；可为字符串、text/image_url/input_audio/file 内容块数组，或工具调用 assistant 消息中的 null。示例："你好"；可为 null；形式：string 或 object[]
messages[].content[].fileobject否内联文件输入；当前不支持 Files 生命周期引用。—
messages[].content[].file.file_datastring否Base64 data URL 文件内容。—
messages[].content[].file.file_idstring否官方 Files 引用 ID；Token Factory 当前未实现 Files 生命周期，发送即返回 400 invalid_request_error。—
messages[].content[].file.filenamestring否内联文件名。—
messages[].content[].image_urlobject否内联 data URL 或 HTTPS 图片 URL。支持图片理解、OCR 与看图问答。—
messages[].content[].image_url.detailstring否图片细节级别。最短：1 字符
messages[].content[].image_url.urlstring父字段存在且匹配该形式时必填图片 URL 或 data URL。—
messages[].content[].input_audioobject否Base64 内联输入音频。—
messages[].content[].input_audio.datastring父字段存在且匹配该形式时必填Base64 音频数据。—
messages[].content[].input_audio.formatstring父字段存在且匹配该形式时必填输入音频格式。可选值："wav"、"mp3"
messages[].content[].prompt_cache_breakpointobject否显式 Prompt Cache 断点。示例：
messages[].content[].prompt_cache_breakpoint.modestring父字段存在且匹配该形式时必填固定为 explicit。示例："explicit"；可选值："explicit"
messages[].content[].textstring否type=text 时的文本。示例："结合这些资料查询无锡天气"
messages[].content[].typestring父字段存在且匹配该形式时必填内容块类型。示例："text"；可选值："text"、"image_url"、"input_audio"、"file"
messages[].function_callobject否旧版 assistant 函数调用对象。可为 null
messages[].namestring否function 消息对应的非空函数名。—
messages[].refusalstring否assistant 的拒答说明；允许为 null。可为 null
messages[].rolestring是消息角色；字段条件由 role 决定。示例："user"；可选值："developer"、"system"、"user"、"tool"、"function"、"assistant"
messages[].tool_call_idstring否tool 消息对应的非空工具调用 ID。—
messages[].tool_callsobject[]否assistant 发起的工具调用数组；用于满足 assistant 消息时必须非空。最少：1 项
messages[].tool_calls[].customobject否自定义工具调用。—
messages[].tool_calls[].custom.inputstring否自定义工具输入。—
messages[].tool_calls[].custom.namestring否自定义工具名。—
messages[].tool_calls[].functionobject否函数调用。—
messages[].tool_calls[].function.argumentsstring父字段存在时必填函数参数字符串；官方不保证内容一定是有效 JSON，也允许空字符串。—
messages[].tool_calls[].function.namestring父字段存在时必填函数名。—
messages[].tool_calls[].idstring父字段存在时必填工具调用 ID。—
messages[].tool_calls[].typestring父字段存在时必填工具调用类型。最短：1 字符
metadataobject否随请求保存的元数据；最多 16 个字符串键值对。可为 null
modalitiesstring[]否输出模态数组；允许为 null，可选择 text 和 audio。示例：["text","audio"]；可为 null
modelstring是要调用的模型 ID；先通过当前入口的模型列表确认可用值。示例："YOUR_MODEL_ID"
moderationobject否输入和输出的可选 Moderation 配置。可为 null
moderation.modelstring父字段存在时必填Moderation 模型 ID。—
moderation.policyobject否输入和输出的 score/block 策略。可为 null
moderation.policy.inputobject否输入 Moderation 策略。可为 null
moderation.policy.input.modestring父字段存在时必填策略模式。可选值："score"、"block"
moderation.policy.outputobject否输出 Moderation 策略。可为 null
moderation.policy.output.modestring父字段存在时必填策略模式。可选值："score"、"block"
ninteger (int32)否每个输入生成的候选数；至少为 1。最小值：1；可为 null
parallel_tool_callsboolean否是否允许模型并行发起工具调用。—
predictionobject否静态预测输出，用于加速已知内容的重新生成。可为 null
prediction.contentobject父字段存在时必填预测文本或内容块数组。—
prediction.typestring父字段存在时必填固定为 content。可选值："content"
presence_penaltynumber否主题出现惩罚，范围 -2 到 2。最小值：-2；最大值：2；可为 null
prompt_cache_keystring否Prompt Cache 路由键；允许为 null。示例："example-cache-key"；可为 null
prompt_cache_optionsobject否Prompt Cache 选项；提供时必须是对象。示例：
prompt_cache_options.modestring否缓存断点模式。示例："explicit"；最短：1 字符
prompt_cache_options.ttlstring否缓存生存时间。示例："30m"；最短：1 字符
prompt_cache_retentionstring否已弃用的 Prompt Cache 保留策略；允许为 null。最短：1 字符；可为 null
reasoning_effortstring否Reasoning 模型思考强度；允许为 null，实际可用值取决于模型。示例："high"；最短：1 字符；可为 null
response_formatobject否Chat 结构化输出设置。示例：{"json_schema":{"name":"weather_answer","schema":{"properties":{"answer":{"ty...
response_format.json_schemaobject否JSON Schema 的 name、description、schema 与 strict 设置。示例：{"name":"weather_answer","schema":{"properties":{"answer":{"type":"string"}},...
response_format.typestring父字段存在时必填输出格式类型。示例："json_schema"；可选值："text"、"json_object"、"json_schema"
safety_identifierstring否非识别性的安全标识；建议使用哈希值，禁止直接发送 PII。最长：64 字符；可为 null
seedinteger (int32)否尽力提供确定性采样的 Beta 随机种子。可为 null
service_tierstring否服务处理等级；允许为 null。最短：1 字符；可为 null
stopstring 或 string[]否一个或最多四个停止序列；最新 Reasoning 模型可能不支持。可为 null；形式：string 或 string[]
storeboolean否是否存储输出；允许为 null。可为 null
streamboolean否是否使用 text/event-stream 流式返回；省略、null 或 false 时返回 JSON。示例：false；可为 null
stream_optionsobject否仅在 stream=true 时使用的流式选项。示例：{"include_usage":true}；可为 null
stream_options.include_obfuscationboolean否是否在流式 delta 中包含混淆填充字段。—
stream_options.include_usageboolean否true 时在 [DONE] 前返回 choices 为空的 usage-only chunk；Token Factory 始终从上游取得可信 Usage 用于计费，但不会在未请求时向客户端暴露该块。示例：true
temperaturenumber否采样温度，范围 0 到 2。最小值：0；最大值：2；可为 null
tool_choicestring 或 object 或 object 或 object否工具选择模式或指定工具对象。示例："auto"；形式：string 或 object 或 object 或 object
tool_choice.functionobject父字段存在且匹配该形式时必填被选择的函数。—
tool_choice.function.namestring父字段存在且匹配该形式时必填函数名。—
tool_choice.typestring父字段存在且匹配该形式时必填被选择的工具类型。；固定为 custom。；固定为 allowed_tools。可选值："function"；可选值："custom"；可选值："allowed_tools"
tool_choice.customobject父字段存在且匹配该形式时必填被选择的自定义工具。—
tool_choice.custom.namestring父字段存在且匹配该形式时必填自定义工具名。—
tool_choice.allowed_toolsobject父字段存在且匹配该形式时必填允许使用的工具及选择模式。—
tool_choice.allowed_tools.modestring父字段存在且匹配该形式时必填允许自动选择或要求至少调用一个工具。可选值："auto"、"required"
tool_choice.allowed_tools.toolsobject[]父字段存在且匹配该形式时必填允许模型调用的工具集合。—
toolsobject[]否模型可调用的函数或自定义工具数组。示例：[{"function":{"description":"查询指定城市天气","name":"lookup_weather","parameters":{...
tools[].customobject否自定义工具定义。—
tools[].functionobject否函数工具定义。示例：{"description":"查询指定城市天气","name":"lookup_weather","parameters":{"properties":...
tools[].function.descriptionstring否函数说明。示例："查询指定城市天气"
tools[].function.namestring父字段存在时必填函数名。示例："lookup_weather"
tools[].function.parametersobject否函数参数 JSON Schema。示例：{"properties":{"city":{"type":"string"}},"required":["city"],"type":"object"}
tools[].function.strictboolean否是否严格遵守 JSON Schema。示例：true
tools[].typestring父字段存在时必填工具类型。示例："function"；可选值："function"、"custom"
top_logprobsinteger (int32)否每个位置返回的候选 Token 数，范围 0 到 20。最小值：0；最大值：20；可为 null
top_pnumber否核采样概率质量，范围 0 到 1。最小值：0；最大值：1；可为 null
userstring否已弃用的终端用户标识；请改用 safety_identifier 与 prompt_cache_key。—
verbositystring否文本回答详细程度；允许为 null。最短：1 字符；可为 null
web_search_optionsobject否Chat Web Search 配置。—
web_search_options.search_context_sizestring否搜索上下文规模。最短：1 字符
web_search_options.user_locationobject否近似用户位置。可为 null
web_search_options.user_location.approximateobject父字段存在时必填city、country、region 与 IANA timezone。—
web_search_options.user_location.typestring父字段存在时必填固定为 approximate。可选值："approximate"

请求报文 ​

媒体类型：application/json

json
{
  "audio": {
    "format": "wav",
    "voice": "alloy"
  },
  "messages": [
    {
      "content": [
        {
          "prompt_cache_breakpoint": {
            "mode": "explicit"
          },
          "text": "结合这些资料查询无锡天气",
          "type": "text"
        },
        {
          "image_url": {
            "detail": "auto",
            "url": "data:image/png;base64,AAAA"
          },
          "type": "image_url"
        },
        {
          "file": {
            "file_data": "data:application/pdf;base64,AAAA",
            "filename": "example.pdf"
          },
          "type": "file"
        },
        {
          "input_audio": {
            "data": "AAAA",
            "format": "wav"
          },
          "type": "input_audio"
        }
      ],
      "role": "user"
    },
    {
      "role": "assistant",
      "tool_calls": [
        {
          "function": {
            "arguments": "{\"city\":\"无锡\"}",
            "name": "lookup_weather"
          },
          "id": "call_example",
          "type": "function"
        }
      ]
    },
    {
      "content": "晴，25℃",
      "role": "tool",
      "tool_call_id": "call_example"
    }
  ],
  "modalities": [
    "text",
    "audio"
  ],
  "model": "YOUR_MODEL_ID",
  "prompt_cache_key": "example-cache-key",
  "prompt_cache_options": {
    "mode": "explicit",
    "ttl": "30m"
  },
  "reasoning_effort": "high",
  "response_format": {
    "json_schema": {
      "name": "weather_answer",
      "schema": {
        "properties": {
          "answer": {
            "type": "string"
          }
        },
        "required": [
          "answer"
        ],
        "type": "object"
      },
      "strict": true
    },
    "type": "json_schema"
  },
  "stream": true,
  "stream_options": {
    "include_usage": true
  },
  "tool_choice": "auto",
  "tools": [
    {
      "function": {
        "description": "查询指定城市天气",
        "name": "lookup_weather",
        "parameters": {
          "properties": {
            "city": {
              "type": "string"
            }
          },
          "required": [
            "city"
          ],
          "type": "object"
        },
        "strict": true
      },
      "type": "function"
    }
  ]
}

响应 ​

成功状态：200

响应头 ​

名称值或类型说明
Content-Typeapplication/json 或 text/event-stream响应媒体类型
request-idstringToken Factory 独立生成的平台请求编号；Anthropic 错误体的 request_id 与其相同。
retry-afterstring可选重试等待提示：非负秒数或标准 HTTP 日期。重试前仍需确认请求可安全重复。
x-request-idstringToken Factory 独立生成的平台请求编号，与 request-id 相同。

响应字段 ​

OpenAI Chat Completion 成功响应；列出当前官方顶层字段，开放扩展仅用于向前兼容官方未来新增字段。 下表完整列出当前公开协议明确声明的字段；开放扩展只允许未声明的附加字段，不会放宽已声明字段的必填、类型或枚举约束。

字段类型必填说明示例或约束
choicesobject[]是非空候选输出数组；元素结构随模型能力变化。示例：[{"finish_reason":"stop","index":0,"logprobs":null,"message":{"audio":{"data"...；最少：1 项
choices[].finish_reasonstring是生成结束原因；成功 JSON 响应中必须为非空字符串。示例："stop"；最短：1 字符
choices[].indexinteger (int32)是候选结果序号。示例：0
choices[].logprobsobject否候选 Token 对数概率；官方允许整个字段省略或为 null。示例：null；可为 null
choices[].logprobs.contentobject[]父字段存在时必填消息正文 Token 对数概率；未请求时为 null。可为 null
choices[].logprobs.content[].bytesinteger (int32)[]父字段存在时必填所选 Token 的 UTF-8 字节；无法表示时为 null。可为 null
choices[].logprobs.content[].logprobnumber父字段存在时必填所选 Token 对数概率。—
choices[].logprobs.content[].tokenstring父字段存在时必填所选 Token 文本。—
choices[].logprobs.content[].top_logprobsobject[]父字段存在时必填该位置返回的候选 Token 列表。—
choices[].logprobs.content[].top_logprobs[].bytesinteger (int32)[]父字段存在时必填Token 的 UTF-8 字节；无法表示时为 null。可为 null
choices[].logprobs.content[].top_logprobs[].logprobnumber父字段存在时必填Token 对数概率。—
choices[].logprobs.content[].top_logprobs[].tokenstring父字段存在时必填Token 文本。—
choices[].logprobs.refusalobject[]父字段存在时必填拒答 Token 对数概率；未请求时为 null。可为 null
choices[].logprobs.refusal[].bytesinteger (int32)[]父字段存在时必填所选 Token 的 UTF-8 字节；无法表示时为 null。可为 null
choices[].logprobs.refusal[].logprobnumber父字段存在时必填所选 Token 对数概率。—
choices[].logprobs.refusal[].tokenstring父字段存在时必填所选 Token 文本。—
choices[].logprobs.refusal[].top_logprobsobject[]父字段存在时必填该位置返回的候选 Token 列表。—
choices[].logprobs.refusal[].top_logprobs[].bytesinteger (int32)[]父字段存在时必填Token 的 UTF-8 字节；无法表示时为 null。可为 null
choices[].logprobs.refusal[].top_logprobs[].logprobnumber父字段存在时必填Token 对数概率。—
choices[].logprobs.refusal[].top_logprobs[].tokenstring父字段存在时必填Token 文本。—
choices[].messageobject是OpenAI Chat 助手消息；可返回文本、拒答、工具调用或音频回答。示例：{"audio":{"data":"AAAA","expires_at":1787835600,"id":"audio_example","transcr...
choices[].message.annotationsobject[]否助手文本 URL 引用；官方可省略或为 null，提供时必须是数组。可为 null
choices[].message.annotations[].typestring父字段存在时必填固定为 url_citation。可选值："url_citation"
choices[].message.annotations[].url_citationobject父字段存在时必填Chat Web Search URL 引用位置。—
choices[].message.annotations[].url_citation.end_indexinteger (int32)父字段存在时必填引用在文本中的结束字符下标。最小值：0
choices[].message.annotations[].url_citation.start_indexinteger (int32)父字段存在时必填引用在文本中的起始字符下标。最小值：0
choices[].message.annotations[].url_citation.titlestring父字段存在时必填引用页面标题。—
choices[].message.annotations[].url_citation.urlstring父字段存在时必填引用页面 URL。—
choices[].message.audioobject否Chat 音频回答。示例：{"data":"AAAA","expires_at":1787835600,"id":"audio_example","transcript":"晴，2...；可为 null
choices[].message.audio.datastring父字段存在时必填Base64 音频数据。示例："AAAA"
choices[].message.audio.expires_atinteger (int64)父字段存在时必填音频到期 Unix 秒时间戳。示例：1787835600
choices[].message.audio.idstring父字段存在时必填音频回答 ID。示例："audio_example"
choices[].message.audio.transcriptstring父字段存在时必填音频文字稿。示例："晴，25℃"
choices[].message.contentstring是助手文本内容；工具调用时可能为 null。示例："{"answer":"晴，25℃"}"；可为 null
choices[].message.function_callobject否旧版函数调用对象。可为 null
choices[].message.function_call.argumentsstring父字段存在时必填函数参数字符串；官方不保证内容一定是有效 JSON，也允许空字符串。—
choices[].message.function_call.namestring父字段存在时必填函数名。—
choices[].message.refusalstring是模型拒答文本；没有拒答时可为 null。示例：null；可为 null
choices[].message.rolestring是固定为 assistant。示例："assistant"；可选值："assistant"
choices[].message.tool_callsobject[]否助手发起的函数或自定义工具调用数组；官方可省略。最少：1 项
choices[].message.tool_calls[].customobject否自定义工具调用。—
choices[].message.tool_calls[].custom.inputstring否自定义工具输入。—
choices[].message.tool_calls[].custom.namestring否自定义工具名。—
choices[].message.tool_calls[].functionobject否函数调用。—
choices[].message.tool_calls[].function.argumentsstring父字段存在时必填函数参数字符串；官方不保证内容一定是有效 JSON，也允许空字符串。—
choices[].message.tool_calls[].function.namestring父字段存在时必填函数名。—
choices[].message.tool_calls[].idstring父字段存在时必填工具调用 ID。—
choices[].message.tool_calls[].typestring父字段存在时必填工具调用类型。最短：1 字符
createdinteger (int64)是响应创建时间的 Unix 秒时间戳。示例：1787832000
idstring是本次响应 ID。示例："chatcmpl_example"
metadataobject否随 Chat Completion 返回的元数据；允许为 null。示例：null；可为 null
modelstring是实际处理请求的模型 ID。示例："YOUR_MODEL_ID"
moderationobject否输入与输出 Moderation 结果；官方允许省略或为 null。示例：null；可为 null
moderation.inputobject父字段存在时必填输入内容的 Moderation 结果或错误。—
moderation.outputobject父字段存在时必填输出内容的 Moderation 结果或错误。—
objectstring是固定为 chat.completion。示例："chat.completion"；可选值："chat.completion"
service_tierstring否实际服务处理等级；允许为 null。示例："default"；最短：1 字符；可为 null
system_fingerprintstring否已弃用的后端配置指纹；官方可省略或为 null。示例："fp_example"；可为 null
usageobject否官方可省略；Token Factory 对可计费成功终态额外要求可信 Usage，缺失时失败关闭。示例：{"completion_tokens":4,"prompt_tokens":8,"total_tokens":12}；可为 null
usage.completion_tokensinteger (int32)父字段存在时必填生成结果使用的 Token 数。示例：4；最小值：0
usage.completion_tokens_detailsobject否输出 Token 分类明细；官方可省略。可为 null
usage.completion_tokens_details.accepted_prediction_tokensinteger (int32)否该类别的 Token 数；允许为 null。最小值：0；可为 null
usage.completion_tokens_details.audio_tokensinteger (int32)否该类别的 Token 数；允许为 null。最小值：0；可为 null
usage.completion_tokens_details.reasoning_tokensinteger (int32)否该类别的 Token 数；允许为 null。最小值：0；可为 null
usage.completion_tokens_details.rejected_prediction_tokensinteger (int32)否该类别的 Token 数；允许为 null。最小值：0；可为 null
usage.completion_tokens_details.text_tokensinteger (int32)否该类别的 Token 数；允许为 null。最小值：0；可为 null
usage.prompt_tokensinteger (int32)父字段存在时必填输入使用的 Token 数。示例：8；最小值：0
usage.prompt_tokens_detailsobject否输入 Token 分类明细；官方可省略。可为 null
usage.prompt_tokens_details.audio_tokensinteger (int32)否该类别的输入 Token 数；允许为 null。最小值：0；可为 null
usage.prompt_tokens_details.cache_write_tokensinteger (int32)否该类别的输入 Token 数；允许为 null。最小值：0；可为 null
usage.prompt_tokens_details.cached_tokensinteger (int32)否该类别的输入 Token 数；允许为 null。最小值：0；可为 null
usage.prompt_tokens_details.image_tokensinteger (int32)否该类别的输入 Token 数；允许为 null。最小值：0；可为 null
usage.prompt_tokens_details.text_tokensinteger (int32)否该类别的输入 Token 数；允许为 null。最小值：0；可为 null
usage.total_tokensinteger (int32)父字段存在时必填输入与输出 Token 总数。示例：12；最小值：0

返回报文 ​

媒体类型：application/json

json
{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "logprobs": null,
      "message": {
        "audio": {
          "data": "AAAA",
          "expires_at": 1787835600,
          "id": "audio_example",
          "transcript": "晴，25℃"
        },
        "content": "{\"answer\":\"晴，25℃\"}",
        "refusal": null,
        "role": "assistant"
      }
    }
  ],
  "created": 1787832000,
  "id": "chatcmpl_example",
  "metadata": null,
  "model": "YOUR_MODEL_ID",
  "moderation": null,
  "object": "chat.completion",
  "service_tier": "default",
  "system_fingerprint": "fp_example",
  "usage": {
    "completion_tokens": 4,
    "prompt_tokens": 8,
    "total_tokens": 12
  }
}

SSE 返回报文 ​

媒体类型：text/event-stream

允许事件：data、[DONE]、error

协议终态：[DONE]、error

text
data: {"id":"chatcmpl_example","object":"chat.completion.chunk","created":1787832000,"model":"YOUR_MODEL_ID","choices":[{"index":0,"delta":{"role":"assistant","content":"{\"answer\":\"晴，25℃\"}","audio":{"id":"audio_example","data":"AAAA","expires_at":1787835600,"transcript":"晴，25℃"}},"finish_reason":null}],"usage":null}

data: {"id":"chatcmpl_example","object":"chat.completion.chunk","created":1787832000,"model":"YOUR_MODEL_ID","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":null}

data: {"id":"chatcmpl_example","object":"chat.completion.chunk","created":1787832000,"model":"YOUR_MODEL_ID","choices":[],"usage":{"prompt_tokens":8,"completion_tokens":4,"total_tokens":12}}

data: [DONE]

只有上方列出的协议终态才表示流正常结束；连接中断不代表请求未执行。若已经收到部分内容，不要无条件重放同一请求。

错误 ​

适用完整地址状态错误码常见触发重试建议动作结果风险
https://api.tokenfactory.cn/v1/chat/completions401invalid_api_keyAuthorization 缺失、Bearer 格式错误、Key 不可用或账户未实名否检查 Bearer API Key、Key 状态与实名状态无
https://api.tokenfactory.cn/v1/chat/completions400model_not_found当前模型不可用否核对模型名称与请求地址；持续出现时联系支持无
https://api.tokenfactory.cn/v1/chat/completions404model_not_found模型不存在、未上架或当前入口不可用否调用模型列表并改用当前入口可用模型无
https://api.tokenfactory.cn/v1/chat/completions404MODEL_ROUTING_PROTOCOL_UNSUPPORTED当前模型不可用否核对模型名称与当前入口的模型列表；持续出现时联系支持无
https://api.tokenfactory.cn/v1/chat/completions503MODEL_ROUTING_NOT_CONFIGURED当前模型服务不可用视情况稍后重试；持续出现时提供平台请求编号联系支持无
https://api.tokenfactory.cn/v1/chat/completions503MODEL_ROUTING_POLICY_INVALID当前模型服务不可用视情况稍后重试；持续出现时提供平台请求编号联系支持无
https://api.tokenfactory.cn/v1/chat/completions503MODEL_ROUTING_NO_AVAILABLE_ROUTE当前模型服务不可用否提供平台请求编号联系支持，确认服务恢复后再发送无
https://api.tokenfactory.cn/v1/chat/completions429insufficient_balance账户可用余额不足否充值后重新发起请求无
https://api.tokenfactory.cn/v1/chat/completions429balance_daily_limit_exceeded账户当天余额消费已达到自助上限否调整每日上限或等待次日恢复无
https://api.tokenfactory.cn/v1/chat/completions413request_too_large请求体超过平台接收上限否缩小请求体后重试无
https://api.tokenfactory.cn/v1/chat/completions400invalid_request_error请求参数或请求体缺字段、格式错误或不受支持否修正请求后重试无
https://api.tokenfactory.cn/v1/chat/completions502upstream_error服务响应异常，请稍后重试视情况确认未收到有效结果后再决定是否重试中到高
https://api.tokenfactory.cn/v1/chat/completions504upstream_timeout请求处理超时，请稍后重试视情况先确认是否已有部分输出，再决定是否重试中到高
https://api.tokenfactory.cn/v1/chat/completions500internal_error平台内部出现未预期错误视情况确认未收到有效结果并记录请求时间后再决定是否重试中到高
https://api.tokenfactory.cn/v1/chat/completions405method_not_allowed请求方法不是该公开地址允许的方法否改用文档列出的 HTTP 方法无
https://api.tokenfactory.cn/v1/chat/completions415unsupported_media_typeContent-Type 与该公开地址要求的媒体类型不一致否按文档发送正确 Content-Type无
https://api.tokenfactory.cn/v1/chat/completions403permission_denied当前 API Key 无权执行该请求否检查 API Key 权限与当前入口的模型可见性无
https://api.tokenfactory.cn/v1/chat/completions409conflict_error请求与当前资源状态冲突视情况读取最新状态后修正请求或稍后重试中到高
https://api.tokenfactory.cn/v1/chat/completions422unprocessable_entity请求结构正确但当前请求无法处理否按错误信息修正参数或输入内容无
https://api.tokenfactory.cn/v1/chat/completions503service_unavailable服务暂不可用，请稍后重试视情况保留平台请求编号，稍后重试或联系支持中到高
https://api.tokenfactory.cn/v1/chat/completions503service_busy模型服务繁忙，请稍后重试视情况参考 Retry-After 并限制重试次数；已收到输出时先确认是否可安全重复中到高
https://api.tokenfactory.cn/v1/chat/completions400context_length_exceeded输入超过模型上下文限制否缩短输入或减少历史上下文后再发送无
https://api.tokenfactory.cn/v1/chat/completions400missing_required_parameter缺少必填请求参数否按文档补齐错误指出的公开参数后再发送无
https://api.tokenfactory.cn/v1/chat/completions400invalid_parameter请求参数的类型或格式不正确否修正错误指出的公开参数类型或格式后再发送无
https://api.tokenfactory.cn/v1/chat/completions502upstream_usage_missing服务响应缺少可验证的用量信息视情况保留平台请求编号联系支持；确认可安全重复后再发送中到高

错误返回报文 ​

适用完整地址 ​

https://api.tokenfactory.cn/v1/chat/completions

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

json
{
  "error": {
    "code": "model_not_found",
    "message": "当前模型不可用",
    "param": null,
    "type": "invalid_request_error"
  }
}

适用完整地址：https://api.tokenfactory.cn/v1/chat/completions

供应商非 2xx 响应会归一化为当前公开协议的错误信封，并只保留安全响应头；502、504 或连接中断时，调用结果可能未知。

限制与计费 ​

适用完整地址限制或计费说明
https://api.tokenfactory.cn/v1/chat/completions请求成功后按通用余额计费；余额不足时调用失败。
受全局请求体上限约束。
模型上下文与输出限制依当前模型和上游事实而定。
支持文本、图片/OCR/看图问答、内联文件、音频输入与音频回答、Reasoning、Tools、Structured Output 和 Prompt Cache；模型参数支持由供应商判断，诊断结果不参与选路。
不支持 file_id/Files 生命周期、独立 Audio API、Realtime 或通过私有 OCR 接口冒充对话能力。

相关说明 ​

请求与响应按当前 OpenAI 兼容能力开放；供应商扩展字段可能随所选模型变化。

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

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