模型与访问权限¶

所有模型使用同一个 API Key 和同一个 Base URL，调用时在请求的 model 字段填写模型 ID。下面展示构建文档时取得的模型目录；账号实际可用范围以登录后的控制台为准。

未登录的公开模型目录当前为空。请登录控制台，或携带自己的 API Key 查询 GET /v1/models，确认账号已获授权的模型。文档中的示例模型来自主站公开配置，不代表所有账号都已开通。

以哪里为准¶

模型会随服务调整而上线或下线，部分模型也可能只对部分账号开放。你的账号实际能调用哪些模型，以下面两处为准：

curl -s 'https://freeinference.qq.com/v1/models' \
  -H "Authorization: Bearer $TENCENT_INFERENCE_API_KEY"

返回结果里没有的模型，当前账号就不能调用，请求它会得到 404。注意这个接口不强制鉴权：没带 API Key 或 Key 无效时，返回的是对所有人公开的模型，而不是报错。

上下文: 模型一次能处理的最大 token 数，输入与输出合计不能超过它。
最大输出: 单次回复最多生成的 token 数。请求中的 max_tokens 不应超过这个值。
输入: 模型接受的内容类型。向只标「文本」的模型发送图片等内容会返回 400。
能力: 工具调用：支持 tools（function calling），Cline、Roo Code、Claude Code 等编程助手依赖这项能力；不支持的模型会忽略请求中的 tools。结构化输出：支持通过 response_format 约束输出为指定的 JSON 结构；不支持的模型会忽略 response_format。