地址、协议与鉴权
区分网关根地址、版本路径和 SDK Base URL,正确传递 API 密钥。
选择正确地址
用途 | 地址 |
|---|---|
网关根地址 | |
OpenAI SDK / Codex Base URL | |
Anthropic SDK / Claude Code Base URL | |
Chat Completions | |
Responses | |
Anthropic Messages | |
Gemini 文本生成 | |
模型列表 | |
SDK 通常自动附加具体接口路径。不要把 /chat/completions 当作 SDK Base URL,也不要重复添加 /v1。控制台地址和浏览器会话接口不是推理入口。
配置凭据
以下为 Bash 环境变量,替换密钥占位符。PowerShell 示例见 curl 指南。
export IROUTER_API_KEY='<your-irouter-api-key>'
export IROUTER_API_BASE='https://gateway.irouter.io/v1'OpenAI 风格请求使用 Authorization: Bearer ...;Messages 示例使用 x-api-key 和 anthropic-version;Gemini 示例使用 x-goog-api-key。密钥应放在请求头,不放进 URL 或业务日志。不同协议的头部和请求体不可混用。
请求约定
JSON 请求发送 Content-Type: application/json,上传文件按接口要求使用 multipart,勿手动拼写其 boundary。模型 ID 来自模型查询。示例中的输出限制、文件名和提示词只是请求示例,不代表账户额度或模型能力上限。
同一 URL 下的可用能力仍取决于模型、线路和权限。具体教程分别说明必需字段;可选参数只在已确认支持时添加。
检查响应
正常 JSON 与流式 SSE 使用不同解析方式。收到错误时保留 HTTP 状态、脱敏错误内容和响应中的请求标识(若有),按错误排查处理。不要将控制台的业务错误格式当作推理接口的统一返回格式。