开始使用
选择模型与线路
确认模型 ID、协议、能力和线路价格,解释目录与密钥可用列表的差异。
先确定任务和协议
打开模型目录,按任务选择文本、图像、视频或音频模型。进入详情页后确认完整模型 ID、接口类型、能力和计价单位。应用的 model 字段填写 ID,不填写展示名称。
Chat Completions、Responses、Messages 和 Gemini 原生接口的请求体不同。客户端需要哪种协议,就选择支持该协议的模型与线路;不能通过更换 URL 就假定字段自动兼容。
再选择线路
同一模型在不同线路上可能有不同价格和可用条件。创建密钥或切换线路前,核对该线路是否提供目标模型,以及余额或订阅是否适用。按 Token 计费的价格显示为 USD / 1M tokens;按次计费应查看模型标注。
模型名称本身不能说明上下文长度、图片输入、工具调用或推理参数是否可用。生产应用应单独验证所需能力。
用密钥确认可用模型
公开目录用于选型,GET https://gateway.irouter.io/v1/models 用于确认当前密钥可见的模型。不同密钥和线路的结果可能不同;模型列表也不等同于完整能力或价格表。
先查询列表,再复制一个实际模型 ID 替换教程中的 <model-id>。目录或列表为空时,检查线路和访问权限,或联系管理员确认模型配置。
接入后的验证
先完成一个简短文本请求,再逐项添加流式输出、图片、工具或结构化输出。每次改变模型或线路后复测这些能力,并在用量明细核对归属与费用。查询模型示例