Skip to main content
每个 Router 模型都由形如 {provider}/{model} 的 ID 标识。使用目录找到该 ID，然后调用 POST /v2/models/{provider}/{model}。

​
发现目录

使用与生成时相同的 API 密钥列出模型：
简略的目录响应：
在调用路径中使用 id。billing 对象包含的是计费事实，而非价格。在依赖它之前，请先阅读策略拒绝计费。

​
分页

  • 当 has_more 为 true 时，将返回的 next_cursor 作为 cursor 传入。当 has_more 为 false 时停止，即使之前的某一页比请求的数量更短。
  • 将游标视为不透明的值。对取值进行 URL 编码，例如使用 cURL 的 --get --data-urlencode "cursor=$NEXT_CURSOR"；不要计算偏移量，也不要修改游标。
  • limit 默认为 20，上限为 100。超过上限的值会被截断；零和负数会选择默认值。响应会报告实际使用的 limit。
  • 无效的游标会返回 400 / invalid_input。它不会静默地重新开始列表。
  • 游标在目录更新后可能仍然有效，但遍历并不是快照：在当前位置之前新增的模型可能不会出现在该次遍历中。
503 / service_unavailable 是临时性的。请通过退避策略重试；不要将其视为空目录。SDK 的运行方法会直接调用所选模型。

​
读取单个模型

当你已知模型 ID 时，直接获取目录条目：
模型详情端点可以避免遍历整个目录。使用 API 参考 查看完整的条目字段。

​
后续步骤

  • Schema 与结果：在调用模型之前，先阅读其输入和输出 schema。
  • 全部模型：浏览目录，每个模型都附带一个可用的请求。