模型 ID 规范与查询办法

The guide below is in Chinese.

用 GET /v1/models 查询当前 Key 可见的模型,原样复制返回的 data[].id,不要自行拼型号或改写前缀。

查询你能调用的模型

Shell command
curl "https://staging-dp.taotoken.io/v1/models" -H "Authorization: Bearer $TP_API_KEY"
  • 必须带有效的 sk- Key,匿名请求返回 401
  • 返回按这把 Key 可见范围筛选的模型。具体调用仍受当次限流、余额和路由影响
  • 响应形状(OpenAI 兼容):
JSON
{
  "object": "list",
  "data": [
    {"id": "<model_id>", "object": "model", "owned_by": "taotoken"}
  ]
}

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

发出第一次对话请求

把下面的 MODEL_ID 替换为查询到的对话模型 ID。此请求可能产生费用。

Shell command
curl "https://staging-dp.taotoken.io/v1/chat/completions" \
  -H "Authorization: Bearer $TP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"你好"}]}'

按 Chat 格式读取响应。选择视频模型时,使用视频模型目录里的 slug。

网页浏览

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

常见错误

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

模型存在但仍调用失败时,可用Key 可调用性查询和错误码区分 Key 权限、余额和可用路由。

下一步

计费、用量与限流 · 其他协议的请求示例