开始使用
使用 curl 接入 iRouter
配置 API 地址和密钥,选择可用模型并验证一次文本请求。
准备
在 iRouter 控制台创建 API 密钥,并确认账户余额或订阅适用于所选线路。创建后保存密钥明文。选择支持 Chat Completions 的模型,将下文 <model-id> 替换为完整模型 ID;目录为空时联系管理员确认配置。
Bash 配置与调用
在 Bash 终端设置环境变量,替换密钥占位符。查询模型后,发送简短请求。
export IROUTER_API_BASE='https://gateway.irouter.io/v1'
export IROUTER_API_KEY='<your-irouter-api-key>'
curl --fail-with-body "$IROUTER_API_BASE/models" \
-H "Authorization: Bearer $IROUTER_API_KEY"curl --fail-with-body "$IROUTER_API_BASE/chat/completions" \
-H "Authorization: Bearer $IROUTER_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"model":"<model-id>","messages":[{"role":"user","content":"Reply with a short greeting."}]}'Windows PowerShell
PowerShell 用户可以使用 Invoke-RestMethod,避免把 Bash 的换行和 JSON 引号直接复制过来。填写自己的密钥与模型 ID,以下代码将请求体编码为 UTF-8。
$env:IROUTER_API_KEY = '<your-irouter-api-key>'
$apiBase = 'https://gateway.irouter.io/v1'
$requestHeaders = @{ Authorization = "Bearer $env:IROUTER_API_KEY" }
Invoke-RestMethod -Uri "$apiBase/models" -Headers $requestHeaders
$requestBody = @{
model = '<model-id>'
messages = @(@{ role = 'user'; content = 'Reply with a short greeting.' })
} | ConvertTo-Json -Depth 8
$requestOptions = @{
Uri = "$apiBase/chat/completions"
Method = 'Post'
Headers = $requestHeaders
ContentType = 'application/json; charset=utf-8'
Body = [System.Text.Encoding]::UTF8.GetBytes($requestBody)
}
$result = Invoke-RestMethod @requestOptions
$result.choices[0].message.content验证结果
检查返回中的 choices 与结束原因,再到用量明细核对模型、密钥、账户及调用记录。生成请求可能产生费用,按实际模型与线路计费。随后可接入 OpenAI SDK。
排查
401 检查密钥和环境变量;403 检查权限、线路与 IP 白名单;404 检查路径和模型;429 区分额度与速率限制。失败时保留脱敏错误,不要为了复现连续发送请求。完整排查
字段采用 OpenAI Chat Completions 格式,模型与可选功能以 iRouter 实际配置为准。