Skip to content

ModelBridge 模桥 · 多协议网关 API 参考

5 组端点

涵盖 OpenAI / Anthropic / Gemini 客户端推理入口、管理面板 /api/*、自建 Node.js 24 + SQLite 状态协议 /_modelbridge/state,以及四态密钥与平台预算约束。

POSTAuthorization: Bearer <client-api-key>核心客户端入口

OpenAI 兼容多端点 (chat / completions / embeddings / models)

POST /v1/chat/completions · /v1/completions · /v1/embeddings · GET /v1/models

接收标准 OpenAI 协议请求,依「upstream:<账号ID>:<模型> > @cf/ 前缀 > 自定义 modelMap > 65 条预设别名」精确确定路由,仅在明确 401/403/404/429 时最多尝试 3 个候选账号。

查看四态密钥与路由优先级 ↗

✅ 能做到

  • 跨供应商转换完整保留工具调用、strict 与签名思考回放元数据(gemini_parts / anthropic_content)
  • 按平台注入预算上限:Cloudflare 16 MiB、EdgeOne Makers 1 MiB、阿里云 ESA 16 MiB / 4 次出站 fetch / 9s 首包 / 115s 总时长

⛔ 明确限制 / 拒绝条件

  • 明确不实现 OpenAI /v1/responses、完整图像生成/编辑或音频 TTS/STT 接口
  • modelMap 不是访问控制白名单(限制可用模型须配置账号级 models 字段);超时与 5xx 绝不自动切换重试防重复计费

请求参数、鉴权域与大小上限

AuthorizationheaderBearer <client-api-key>必填

实例调用密钥(无 /api/* 管理权限,受 enabled 状态实时开关控制)。

modelbodystring必填

支持模型名、@cf/... 或 upstream:<accountId>:<model> 精准定向上游。

响应状态与 semantic pre-flight

200 OK返回标准 OpenAI ChatCompletion / SSE stream
400 / 401 / 413 / 502EdgeOne Makers 超 1 MiB、思考回放校验失败或上游明确报错