API 总览

primerouter 提供与 OpenAI 完全兼容的 REST API，并原生支持 Anthropic Messages 与 Google Gemini 的格式。

端点根

https://primerouter.ai

所有 OpenAI 风格端点在 /v1/... 下。Claude 风格端点见 API Reference。

认证

Authorization: Bearer sk-你的key

或 Anthropic 风格：

x-api-key: sk-你的key

获取 key：登录 → 令牌管理 创建。

主要端点

端点	用途
POST /v1/chat/completions	多轮对话（OpenAI 兼容，最常用）
POST /v1/responses	OpenAI Responses API
POST /v1/messages	Anthropic Messages（Claude 原生）
POST /v1/embeddings	向量嵌入
POST /v1/images/generations	文生图
POST /v1/images/edits	图生图、多张参考图
POST /v1/audio/speech	文字转语音（TTS）
POST /v1/audio/transcriptions	语音转文字（Whisper）
GET /v1/models	模型列表
POST /v1/rerank	文档排序

完整 schema 与示例见 API Reference（交互式浏览器）。

子主题

• 认证 — key 类型、过期、IP 白名单
• 流式输出 — SSE 协议细节
• 错误码 — 标准错误结构与处理建议
• 图片生成与编辑 — 多参考图调用、尺寸与品质限制、按张计费口径
• 图片生成 Skill — 网站下载、跨 Agent 安装与使用
• API Reference — 交互式接口浏览器（可在线试调）

SDK 与示例

primerouter 不提供专属 SDK——目标是让你继续用现有 SDK。常见 SDK 配置见 从 OpenAI SDK 迁移。

限流

每个 API key 都受限于：

• 用户级 RPM / TPM（按你的分组决定）
• 模型级 RPM（部分模型有上游限流）

触发返回 429 Too Many Requests + Retry-After header。详见 错误码。