模型 ID 规范与查询办法

Doc status未标注Feature status未标注

页面类型:开始使用 | 读者:需要知道 model 字段该填什么的开发者 | 预计 2 分钟 本页只讲怎么拿到你能用的模型 ID 列表,⛔ 讲某个具体模型的能力/参数/限制——那些在模型说明页。

查询你能调用的模型

GET https://intertoken.ai/v1/models
Authorization: Bearer sk-你的密钥
  • 必须带有效的 sk- Key,匿名请求返回 401
  • 返回的是这把 Key 实际能调用的模型集合,⛔ 是平台全部目录——如果你购买了套餐,未被套餐覆盖且没开现金兜底的模型不会出现在列表里
  • 响应形状(OpenAI 兼容):
{
  "object": "list",
  "data": [
    {"id": "<model_id>", "object": "model", "owned_by": "taotoken"}
  ]
}

data[].id 就是创建任务/对话时 model 字段该填的值,原样复制即可,不要自己拼接或猜测格式。

网页浏览

工作台「模型」页可以按能力类型筛选浏览,适合人工挑选;程序化对接用上面的 API。

常见错误

model 字段填了一个平台完全不认识的标识,创建请求会返回 model_not_found(404)——换一个真实存在的 model 值即可解决。

如果 model 本身是真实存在的模型,但你的 Key/套餐当前调不动它,返回的是别的错误码(余额/套餐类,非 model_not_found),处理方式不是"换个名字",具体见对应的错误码参考。判断自己现在到底能不能调某个模型,以 GET https://intertoken.ai/v1/models 这次返回的列表为准,⛔ 凭记忆或旧文档里的名字硬填。


下一篇:计费、用量与限流 —— 这次调用大概会花多少钱、怎么查还剩多少额度。

<!-- doc_status: 已发布 feature_status: 已上线 updated: 2026-09-19 -->