API 参考
查询可用模型
用当前密钥查询模型 ID,并与公开模型目录交叉核对。
请求
先按 API 概览设置 IROUTER_API_KEY。此查询用于确认密钥可见的模型,不发起文本生成。
curl --fail-with-body 'https://gateway.irouter.io/v1/models' \
-H "Authorization: Bearer $IROUTER_API_KEY"读取结果
OpenAI 格式的模型列表使用 data 数组,各项的 id 是调用时的模型 ID。复制其中支持目标协议的 ID,替换教程里的 <model-id>。不要根据显示名称自行补前缀、日期或版本号。
列表用于模型发现,不是价格表,也不能证明工具调用等可选功能已经启用。上下文、能力和价格到模型目录确认。
空列表与权限错误
空列表时检查密钥线路、模型访问限制和目录配置;401 时检查密钥本身,403 时检查权限与来源限制。模型出现于列表却调用失败时,继续核对具体接口和参数,并提供请求时间与完整模型 ID 给支持人员。
确认后继续 Chat Completions 或对应协议教程。