用途：帮助开发者构建、迁移、调试和运维与 OpenRouter API 的集成。基础地址为 https://openrouter.ai/api/v1，提供多种可互操作的 API 形态及媒体、检索、管理端点。
主要能力：覆盖 Chat Completions、Responses、Messages、旧版 Completions、Embeddings、Rerank、Images、Audio Speech/Transcriptions、Videos、Files，以及模型目录查询（GET /models、GET /model/{author}/{slug}、GET /models/{author}/{slug}/endpoints）和管理 API。提供官方 SDK（@openrouter/sdk、openrouter、Go SDK）与 @openrouter/agent 智能体原语。
使用方式：认证使用 Authorization: Bearer $OPENROUTER_API_KEY 与 Content-Type: application/json，可选 HTTP-Referer、X-OpenRouter-Title、X-OpenRouter-Categories 归因头。先用脚本或 curl 查询实时模型目录，确认 id、上下文长度、输入输出模态、supported_parameters、推理元数据与价格，再选择 API 形态。可用 provider.require_parameters、provider.only/ignore/order、models 回退列表控制路由。流式响应按 SSE 解析，处理 [DONE] 与 HTTP 200 后的带内错误。
适用场景：需要多模型路由、回退、结构化输出、推理、工具调用、提示与响应缓存、多模态媒体处理及可观测性日志的生产集成。
限制：模型目录、别名、提供商、能力、参数、价格、速率限制与服务层级频繁变化，不得猜测或硬编码；Responses、服务端工具、响应缓存等标记为演进中，需查变更日志与 OpenAPI。响应缓存为 beta，按规范化请求键控，账户级 ZDR 时不可用。凭据须留在服务端，管理密钥权限高于推理密钥。永久性失败不应原样重试，流已输出内容后无法安全重启回退。具体价格、速率限制与平台细节资料未提供。