API Key 与模型调用

创建 API Key

在用户控制台的 API Key 页面创建 Key，并填写便于识别的名称。完整 Key 只在创建时显示一次

建议按用途拆分，例如开发环境和生产服务各用一把。某个应用不再使用时，及时删除对应 Key，不必影响其他应用

调用前准备

请求中的 model 必须使用控制台模型目录里的模型 ID。若要固定使用某个服务商，可使用 用户名@模型名；该服务商不可用时，请求不会自动切换到其他服务商

使用 OpenAI 格式

OpenAI 兼容客户端使用以下配置：

Base URL：https://www.imrouter.com/api/v1
API Key：用户控制台创建的 API Key
接口：POST /chat/completions

bash

curl https://www.imrouter.com/api/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

使用 OpenAI SDK 或其他兼容客户端时，只需替换 Base URL、API Key 和模型 ID

使用 Anthropic 格式

Anthropic Messages 兼容客户端使用以下配置：

Base URL：https://www.imrouter.com/api
API Key：用户控制台创建的 API Key
接口：POST /v1/messages

bash

curl https://www.imrouter.com/api/v1/messages \
  -H "x-api-key: sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

使用 Anthropic SDK 或其他兼容客户端时，将其 Base URL 设为 https://www.imrouter.com/api，客户端会拼接 /v1/messages。若客户端要求填写完整 API 前缀，则使用 https://www.imrouter.com/api/v1

安全建议

把 Key 保存在环境变量或密钥管理服务中
不要把 Key 写入前端代码、公开仓库、聊天记录或截图
不要用网页登录凭证调用模型，也不要用 API Key 登录控制台
怀疑 Key 泄露时，立即删除并创建新 Key

接入常用工具

遇到余额不足或需要核对调用成本时，请查看充值与计费

API Key 与模型调用 ​

创建 API Key ​

调用前准备 ​

使用 OpenAI 格式 ​

使用 Anthropic 格式 ​

安全建议 ​