Skip to main content

​
模型与供应商配置

Redbit 使用模型注册表，而不是把供应商选择分散在各个组件里。Settings 为每种媒体类型选择活跃模型家族和变体；注册表定义模型支持什么；payload builder 生成供应商需要的请求结构。 模型路由图：Settings、模型注册表、payload builder、直接供应商路由、中继路由和 Agent profile。 配置边界图：Settings、浏览器存储、直接供应商、中继供应商、可选 Local Core、MCP 和外部自动化边界。

​
谁应该阅读本文

在配置真实供应商、排查模型消失，或向别人解释 API key、中继路由、Agent profile 和 Local Core 边界前，先读这一页。

​
前置概念

Redbit 默认按 BYOK 理解。Settings 可以保存凭证并路由请求，但额度、计费、地区访问、安全策略、保留政策和模型在线状态仍由供应商账号决定。

​
配置层级

​
当前目录快照

UI 中的实际可见模型会受中继模式和自定义中继模型列表影响，因为 Settings 会按供应商能力过滤可见模型。 不要期待同一个 prompt 在不同模型中得到完全相同结果。模型之间可能在 prompt 理解、参考强度、画面比例支持、安全过滤、耗时、输出格式，以及是否支持图像/视频/音频/结构化输入方面不同。

​
直接供应商 vs 中继

​
凭证处理

Settings 会把配置持久化到浏览器存储。API key、access key、secret key 和 token 等敏感字段会在可用时先加密再写入 IndexedDB。加密或持久化失败时，Redbit 会写入脱敏 emergency snapshot，而不是直接写入原始凭证。 实用建议：
  • 凭证只放在 Settings；
  • 不要把 key 粘贴到卡片、工作坊脚本或 Agent 聊天；
  • 当前工作流需要什么，就只配置最小权限；
  • 如果 key 暴露在 Settings 之外，请到供应商控制台轮换；
  • 上传机密媒体前先检查供应商条款。

​
Agent Runtime Profiles

Agent 模型与生成模型分开配置。Settings 支持：
  • auto：从现有设置中解析兼容助手运行时；
  • relay：在可用时使用支持聊天的中继路由；
  • custom：配置供应商预设、协议、base URL、API key、模型 ID 和可选角色覆盖。
Discovery 会在供应商暴露 models endpoint 时读取模型 ID。Capability test 会发起真实调用，并在本地保存 tool calling、structured output、system prompt 和 vision 支持情况。必需探测失败的模型不应成为保存后的默认 profile。

​
下一步

发送敏感素材前，继续看 安全与凭据；如果要理解所选 Agent runtime profile 如何影响工具执行，请继续看 Agent 工作模式。