快速开始

按照以下分步说明,快速高效地开始使用 KOPRouter API。

**前置条件**

在发起任何 API 请求前,请确认你已具备:

  • 一个已注册的 KOPRouter 账号
  • 一把在控制台「密钥管理」中创建的、以 sk- 开头的 API Key
注册一个新账号,或登录已有账号。登录后进入控制台,你可以管理 API Key、渠道、充值与用量明细。 在控制台「密钥管理」(API Keys)页面点击「新建」,生成一把 API Key:
请妥善保存这把 Key,所有 API 请求都将用它鉴权(参见「概述」的鉴权说明):

<span class="field-row"><code>Authorization: Bearer sk-...</code></span>
下面是用 `curl` 创建一次对话补全的示例(也可以使用 Postman、Python requests 或其他 HTTP 客户端):
```bash
curl https://koprouter.kopglobal.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [
      { "role": "user", "content": "你好!" }
    ]
  }'
```

<Tip>
  把 `sk-...` 替换为你的真实 API Key,把 `MODEL_ID` 替换为 `/v1/models` 返回的模型 ID。成功的响应会返回一条与你输入匹配的对话补全。
</Tip>
完成第一次请求后,可以继续探索:
* 阅读各端点的请求参数、响应格式与错误处理说明。
* 接入流式响应、工具调用等进阶能力。
* 把 Base URL 配置到 OpenAI SDK、Claude Code、Codex 等工具中,详见「集成文档」。
* 若所在网络(如中国大陆)无法直连 KOPRouter,请先按「网络与代理配置」配置 VPN 或代理。