跳到主要内容

BYOK 格式与填写

BYOK（Bring Your Own Key）指你在应用内接入自己的模型服务与 API Key，再把路由切到 BYOK 或 Auto。

支持的 profile 格式​

Ask AI profiles​

当前提供商预设：

  • openai-compatible
  • gemini-compatible
  • anthropic-compatible

每个 profile 字段包含：

  • Name
  • Provider
  • API endpoint（在 UI 中可选，内置默认值）
  • Model
  • API key

Embedding profiles​

  • 提供商格式：OpenAI-compatible
  • 字段：Name / Provider / API endpoint / Model / API key

填写流程​

  1. 打开 Settings → Intelligence → API keys。
  2. 新建 profile 并选择 provider 类型。
  3. 填写 endpoint、model、API key。
  4. 保存并设为 active。
  5. 回到 Intelligence 路由设置，选择 BYOK（或 Auto）。

默认 endpoint​

  • OpenAI-compatible：https://api.openai.com/v1
  • Gemini-compatible：https://generativelanguage.googleapis.com/v1beta
  • Anthropic-compatible：https://api.anthropic.com/v1

你也可以替换成自己的兼容网关地址。

兼容性注意​

  • 媒体 BYOK 路径（OCR/音频/媒体理解）当前按实现要求使用 OpenAI-compatible profile。

安全说明​

  • API key 以本地加密方式存储。
  • 建议每类能力保持一个激活配置，避免路由混淆。