兼容入口与插件边界

核对历史入口、动态插件路由和文档覆盖范围。

本页补充规范之外的路径差异。优先选择本站有完整契约和示例的入口；别通过替换路径片段猜测兼容性。

已注册入口	用法与边界
GET /v1beta/models	Gemini 模型目录形状；x-goog-api-key 或 Bearer 使用网关令牌
GET /v1beta/openai/models	返回 OpenAI 模型目录形状，不表示所有 OpenAI 资源都在此前缀下
GET /v1/models	x-api-key 加 anthropic-version 选择 Claude 目录；x-goog-api-key 或 key 选择 Gemini 目录；普通 Bearer 选择 OpenAI 目录，优先用 header 而非 query 密钥
GET /v1/models/{model}	Claude header 组合选择 Claude 详情，否则 OpenAI 详情；不是 Gemini 模型详情的别名
POST /v1/models/*path	Gemini action 的兼容前缀；统一示例使用 /v1beta/models/{model}:action
POST /v1/engines/{model}/embeddings	历史入口存在，但使用 Gemini relay format，不承诺是 OpenAI /v1/embeddings 的透明别名；新接入使用明确的向量端点
POST /v1/video/generations、GET /v1/video/generations/{task_id}	历史视频入口，处理取决于插件绑定与任务适配；与 /v1/videos 的响应形状不应直接互换
POST /v1/edits	旧路径送入图片 relay format，不能当作当前文本编辑接口或 /v1/images/edits 的通用别名
POST /pg/chat/completions	控制台会话认证的 Playground；外部应用使用 /v1/chat/completions

​

插件原生路由

已启用插件的 meta.routes 动态注册供应商协议路径，JSON / form / multipart、响应字段和查询路径由插件定义。使用网关 Bearer 凭据；路径可能带供应商前缀，不能直接把供应商域名换成网关域名。管理员需提供插件 key、版本、模型、实际路由及有效请求；本站不把当前安装列表当作每个部署的保证。

插件原生路由与 /v1/tasks/{plugin_key} 不是相同入口：前者运行原生解码器和响应呈现器，后者是规范化 JSON 旧通用提交。第三种是宿主协议 /v1/responses、/v1/images/*、/v1/videos，由插件明确声明支持。Responses 的 sync / stream / background 必须分别支持。

返回任务 ID 后，可按通用任务查询状态与产物；插件未保留结果时不能承诺后续检索。供应商私有 ID、控制台数据库行 ID、公开任务 ID 不能互换。没有统一 webhook 保证，优先使用有限轮询。

​

覆盖检查

源码清单在 scripts/route-coverage.json，登记核心 relay、视频、任务和宿主协议路由，并链接到双语文档或明确边界。check:content 在主仓库内会比较当前路由声明，新增 / 删除路由使检查失败，提醒维护映射；导出独立文档仓库后仍校验清单与页面关系，但无法读取后端时会明确跳过源码比较。此检查不证明 DTO、插件或运行行为完全兼容。

未实现功能见接口支持范围。管理 API、组织管理、账号认证及插件开发不属于推理接入文档范围。

Read in English

提示词缓存 · 推理模型 · 上下文管理