API 提供商¶
打开设置 → 提供商,再选择一个提供商编辑其端点、协议、凭据或本地模型。
内置提供商¶
Agora 包含 OpenAI、Anthropic、Google Gemini、DeepSeek、DashScope/通义千问、OpenRouter、OpenCode Go、Groq、Ollama 和本地模型。提供商的模型目录和端点行为可能独立变化。
对于远程提供商,未保存覆盖值时,Base URL 输入框会显示当前生效的内置默认值。没有内置端点的提供商可能只显示占位提示;留空时会在存在默认值的情况下回到提供商默认地址。Base URL 编辑会在停止输入 500 ms 后自动保存,没有单独的保存操作。
自定义提供商¶
自定义端点可选择 OpenAI 兼容、Google 或 Anthropic 协议。请配置与服务器匹配的 Base URL 和协议。模型同步按所选协议执行;无法发现时仍可手动添加模型。
Responses API会从 Chat Completions 切换到提供商的 /responses 端点。它仅用于内置 OpenAI 提供商,以及使用 OpenAI 兼容协议的自定义提供商。
API Key¶
同一提供商可保存多个命名 API Key。选择某个 Key 旁的单选按钮即可将其设为该提供商的活动 Key;各 Key 可独立添加、编辑和删除。
API Key 保存在偏好设置而非 Room 对话数据库中。SecretCrypto 通常使用 Android Keystore AES-256-GCM 封装;旧明文仍可读取,加密失败时会为避免丢失数据而回退为明文。请求只会在需要时把活动凭据发送到已配置目的地。实际服务器由 Base URL 决定,请仔细核对自定义端点。
Anthropic 缓存¶
内置 Anthropic 提供商和使用 Anthropic 协议的自定义提供商,会在 API Key 下方显示高级分组。缓存默认开启,开启后可在缓存时长中选择 5m 或 1h,默认 1h。修改按提供商立即保存。
关闭缓存会省略 Agora 请求中的顶层 cache_control 标记,并保留已选时长供再次开启时使用。这不会关闭中转服务自行添加的缓存。可让时长与中转策略保持一致,或在中转管理缓存时关闭 Agora 的标记。自定义提供商切换到其他协议后会隐藏这些控件,但不会清除已保存的值。
本地模型¶
本地提供商可从 GGUF 文件导入聊天模型。每个条目包含模型 ID、别名、上下文大小、Temperature、Top P 和最大输出 Token。可选的视觉投影文件(.mmproj)用于增加视觉能力,并会在模型行显示标记。
在“高级”中使用模型空闲保留设置未使用的本地模型在卸载前继续驻留内存的时间。删除本地条目会删除由应用持有的模型与投影文件副本;编辑时替换或移除投影文件,会清理旧的投影文件副本。