概述

KOPRouter 是兼容 OpenAI 与 Anthropic 协议的统一模型网关。一个 API Key 即可调用文本对话、向量、图片、音频、审核、重排和视频等模型能力,并按模型与用量统一计费。

什么是 KOPRouter?

KOPRouter 聚合多家上游 AI 供应商,对外暴露一套 OpenAI 兼容接口,并原生支持 Anthropic Messages API。你只需要一个 Base URL 和一把 API Key,即可调用账号已开通的全部模型;模型路由、故障转移、限流与计费都由网关统一处理。

核心能力

统一 Base URL,切换模型只需修改 `model` 字段,无需为每个供应商单独接入。 按优先级加权路由,主渠道异常时自动切换到备用渠道,供应商故障无感。 按 token、按张、按字符、按秒、按次,统一结算,所有明细可在控制台查询。

Base URL 与鉴权

Base URL 为 <你的 Base URL>/v1,鉴权使用 Bearer Token:

Authorization: Bearer sk-...

Base URL 为 <你的 Base URL>,SDK 会自动追加 /v1/messages,鉴权使用:

x-api-key: sk-...

支持的端点

分类 端点 计费方式
文本 /v1/chat/completions 按 token
文本 /v1/completions 按 token
文本 /v1/responses 按 token
文本 /v1/embeddings 按 token
文本 /v1/rerank 按请求
文本 /v1/moderations 按请求
图像 /v1/images/generations 按图片张数
图像 /v1/images/edits 按图片张数
图像 /v1/images/variations 按图片张数
音频 /v1/audio/speech 按合成字符数
音频 /v1/audio/transcriptions 按请求
音频 /v1/audio/translations 按请求
视频 /v1/videos 按完成结果结算

开始调用前

先查询你的账号实际可用的模型,响应中的 id 就是调用时 model 字段应填的值:

curl https://koprouter.kopglobal.com/v1/models \
  -H "Authorization: Bearer sk-..."
调用时请直接使用 `/v1/models` 返回的 `id`。填了列表外的模型会返回 `404 model_not_found`。

下一步

三步完成第一次 API 调用。 遇到 401 / 402 / 429 等问题先来这里看看。