> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inputapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 兼容入口与插件边界

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

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

| 已注册入口 | 用法与边界 |
| - | - |
| `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 后，可按[通用任务](/zh/guides/tasks)查询状态与产物；插件未保留结果时不能承诺后续检索。供应商私有 ID、控制台数据库行 ID、公开任务 ID 不能互换。没有统一 webhook 保证，优先使用有限轮询。

## 覆盖检查

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

未实现功能见[接口支持范围](/zh/guides/api-coverage)。管理 API、组织管理、账号认证及插件开发不属于推理接入文档范围。

[Read in English](/en/guides/protocol-compatibility)

[提示词缓存](/zh/guides/prompt-caching) · [推理模型](/zh/guides/reasoning-models) · [上下文管理](/zh/guides/context-management)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.