API 使用
模型列表与端点选择
用实时页面和 /v1/models 选择当前 Key 真正可用的模型与协议端点
目标
在不依赖静态模型清单的前提下,为当前 Key 选择可用模型和正确 endpoint。
前置条件
- 已登录普通用户控制台。
- 已创建至少一个受限 Key,或准备先从公开模型广场了解能力。
准确入口
- 模型广场:https://infinitex.pro/pricing
- 可用渠道:https://infinitex.pro/available-channels
- 可用性检测:https://infinitex.pro/status
- 运行时模型:
GET https://api.infinitex.pro/v1/models
操作步骤
- 在模型广场按能力搜索,记录页面当前标出的端点和分组,不保存整站模型清单。
- 在可用渠道确认对应协议路线当前开放,并查看页面提供的实际请求地址。
- 在状态页排除当前线路异常。
- 用目标 Key 请求
/v1/models;这个返回集合是该 Key 当前可见模型的最终过滤结果。 - 按客户端协议选择 endpoint:消息数组用
/v1/chat/completions,Responses 客户端用/v1/responses,Claude-compatible 客户端用/v1/messages。 - 先发一条最小请求,再从使用日志确认实际 endpoint 和模型。
决策表
| 客户端请求形态 | Endpoint | 额外条件 |
|---|---|---|
| OpenAI messages | /v1/chat/completions | 模型与渠道支持 Chat Completions |
| OpenAI Responses | /v1/responses | 客户端与路线支持 Responses |
| Claude Messages | /v1/messages | 模型与渠道支持 Claude-compatible 协议 |
| 模型发现 | /v1/models | 返回结果受 Key 分组、模型限制与生产配置影响 |
成功结果
选择的模型同时出现在实时页面和当前 Key 的 /v1/models 中;最小请求与使用日志显示相同 endpoint 和模型。
常见错误
- 模型广场可见但
/v1/models不返回:Key 分组或模型限制不匹配。 - endpoint 返回 404/协议错误:客户端协议与模型路线不匹配。
- 状态页正常但请求失败:继续检查 Key、额度、限流和具体 request ID。
- 从旧截图复制模型名:重新使用实时页面和
/v1/models。
安全与计费影响
模型、价格、倍率和渠道会变化,文档不保存动态清单。模型探测与生成请求都可能产生不同的日志;生成请求按实时价格计费。
下一步
最后更新于