快速开始

本页使用兼容性最广的 Chat Completions 接口完成第一次调用。完成后,你可以继续使用 Responses、Claude Messages、Gemini、图片、音频和视频等接口。

1. 创建 API Key

登录 GetRouter,打开 API Keys 并创建 Key。

建议第一次创建时:

  • 名称写清用途,例如 local-quickstart
  • 设置合理的额度和有效期;
  • 暂时不要开启模型限制或 IP 白名单,先完成最小调用;
  • 成功后再按生产要求收紧权限。

API Key 只会以 YOUR_API_KEY 出现在文档示例中。不要将真实 Key 提交到 Git、前端代码或截图。

2. 选择模型

打开模型目录,复制模型详情中的准确 ID,并确认它支持 Chat Completions。

文档统一使用 MODEL_ID 占位,不写死会变化的模型列表。

3. 发送第一个请求

curl https://getrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [
      {"role": "user", "content": "用一句话介绍 GetRouter。"}
    ]
  }'

成功响应中的文本通常位于:

choices[0].message.content

4. 验证请求记录

打开使用记录,确认:

  • 请求使用了预期的 Key 和模型;
  • Endpoint 是 /v1/chat/completions
  • 状态成功;
  • 用量和费用符合预期。

5. 选择下一步

目标下一篇
使用 Python / Node.js SDKcURL、Python 与 Node.js
使用 Responses APIResponses API
使用流式输出流式输出
使用工具调用工具调用
配置 Codex、Claude Code 或聊天客户端集成指南
查询所有接口字段接口参考
遇到

401404? 先查看 Base URL 与协议,再按连接问题排查逐项检查。