API 总览
wrouter 同时暴露三套主流 LLM 协议，互相转译，任选其一即可。
Base URL
https://api.wrouter.io所有接口均通过 HTTPS 提供。请勿在生产环境使用任何代理域名。
协议兼容
| 协议 | Base 路径 | 说明 |
|---|---|---|
| OpenAI | /v1/* | 与 https://api.openai.com/v1 完全兼容 |
| Anthropic | /v1/messages | 与 https://api.anthropic.com/v1/messages 完全兼容 |
| Gemini | /v1beta/models/{model}:generateContent | 与 Google Generative AI API 兼容 |
只需把 SDK 的 base_url 指向 wrouter，模型 ID 与请求体保持原样，wrouter 会按协议路由到对应上游。
接口列表
对话
- Chat Completions —
POST /v1/chat/completions（OpenAI） - Messages —
POST /v1/messages（Anthropic） - Responses —
POST /v1/responses（OpenAI Agentic） POST /v1/responses/compact— 压缩 Responses 会话- Completions（旧版） —
POST /v1/completions
检索
- Embeddings —
POST /v1/embeddings - Rerank —
POST /v1/rerank
图像
- Images Generations —
POST /v1/images/generations - Images Edits —
POST /v1/images/edits
音频
- Speech (TTS) —
POST /v1/audio/speech - Transcriptions (STT) —
POST /v1/audio/transcriptions - Translations —
POST /v1/audio/translations（任意语言翻译为英文）
视频
- 视频生成 —
POST /v1/videos、Kling / Pixverse / Seedance / Veo3 / Wanx / 即梦 等专用入口 - 任务查询 —
GET /v1/videos/{task_id}、GET /v1/videos/{task_id}/content
安全审核
- Moderations —
POST /v1/moderations
实时
- Realtime —
GET /v1/realtime（WebSocket 升级）
元信息
- Models —
GET /v1/models、GET /v1beta/models
通用约定
- 认证：所有请求需在 Header 中携带
Authorization: Bearer sk-...，见 认证 - 内容类型：除文件上传外，请求体均为
application/json; charset=utf-8 - 错误码：统一 RESTful 风格，见 错误码
- 流式响应：所有对话接口支持
stream: true，返回 Server-Sent Events - 限流：默认按 Token 维度限流；可在控制台调整
- 请求超时：建议客户端超时设置 ≥ 600 秒，长生成任务可能超过 5 分钟
与官方 OpenAI 的差异
Authorization使用 wrouter 自己的sk-前缀 Token，不通用organizationHeader 被忽略- 部分专属字段（
logprobs、tools.strict的某些组合）按上游能力转发，若上游不支持会返回 400 - 错误响应体始终是 wrouter 统一格式，见 错误码