Android Studio Quail 1 API 密钥设置 — Agent 三方 Key 配置指南
在 Android Studio Quail 1 的 Agent 中配置 APIMaster.ai 三方 API Key。Model Providers 添加 OpenAI-compatible 远程模型,接入 GPT、Claude、Gemini 等。
Android Studio Quail 1(2026.1.1 稳定版)内置 Agent 与 AI 聊天,支持接入第三方远程模型。按 Google 官方 Use a remote model 流程,在 Model Providers 中添加 APIMaster.ai(OpenAI-compatible)即可使用。
开始前请 获取 API Key。Key 仅保存在本机 Android Studio 设置中,勿发到群聊或截图。发消息失败时可使用 API 连通性测试 辅助排查。
前置条件
- 已安装 Android Studio Quail 1(2026.1.1 或更新;Help → Check for Updates 升级)。
- 已从 APIMaster 控制台 复制 API Key。
- 已在 模型广场 了解可用 model id(Refresh 后会自动拉取列表)。
第 1 步:打开 Model Providers 并添加 Provider
- 打开 Settings / Preferences(Windows/Linux:
File → Settings;macOS:Android Studio → Settings)。 - 左侧展开 Tools → AI,选择 Model Providers。
- 点击列表上方的 「+」 添加按钮。
- 选择 Third-Party Remote Provider(第三方远程 Provider)。

第 2 步:填写 APIMaster 连接信息
在 Provider 详情中填写:
| 字段 | 填写内容 |
|---|---|
| Description | APIMaster.ai(或任意易识别的名称) |
| URL | https://apimaster.ai/v1(必须带 /v1) |
| URL Schema | OpenAI-compatible |
| API key | 粘贴你的 APIMaster Key |
填写完成后点击 Refresh,Android Studio 会从 APIMaster 拉取可用模型列表。
在 Available models 表格中,勾选你要启用的模型(可多选),例如:
gpt-5.4/gpt-5.5/gpt-5.6-solclaude-opus-4-8/claude-sonnet-4-6gemini-2.5-pro/gemini-3.5-flash
点击 OK 保存。
说明:
- URL Schema 须选 OpenAI-compatible,APIMaster 走 OpenAI Chat Completions 兼容协议。
- 若 Refresh 后列表为空,检查 Key 是否有效、网络是否正常,或到 模型广场 确认账户已开通对应模型。
- 使用第三方模型时,Chat 与 Agent 功能可用;部分 Android Studio 专属 AI 能力可能仅支持 Google 内置模型(见 官方说明)。
第 3 步:在 Agent 中选择 APIMaster 模型
- 打开 Android Studio 右侧 Agent 面板(或 AI 聊天窗口)。
- 点击输入框右下角 模型选择器(当前模型名旁的下拉箭头)。
- 在 APIMaster.ai 分组下选择已启用的模型(如
gpt-5.6-sol、claude-opus-4-8)。 - 若要增删 Provider 或调整启用模型,可点击 Manage Models… 回到 Model Providers 设置。

第 4 步:验证 Agent 对话
- 在 Agent 输入框发送测试消息(如
hello world或 Android 开发相关问题)。 - 收到正常回复即表示配置成功;请求经 APIMaster 发出,按所选模型计费。

常用 Model ID 参考
Refresh 后列表以 APIMaster 账户实际开通为准,常见 id 包括:
| model id | 说明 |
|---|---|
gpt-5.4 / gpt-5.5 / gpt-5.6-sol |
GPT 系列 |
claude-haiku-4-5 |
Claude Haiku |
claude-sonnet-4-6 / claude-sonnet-5 |
Claude Sonnet |
claude-opus-4-8 |
Claude Opus |
gemini-2.5-pro / gemini-3.5-flash |
Gemini 系列 |
deepseek-v4-pro |
DeepSeek |
完整列表见 模型广场;Refresh 拉取的是
GET /v1/models返回的 id。
常见问题
| 现象 | 处理 |
|---|---|
| 401 / Invalid API Key | 检查 Key 是否完整;在 Settings 重新粘贴;在控制台确认未禁用 |
| Refresh 后无模型 | 确认 URL 为 https://apimaster.ai/v1;检查 Key 与网络;确认账户有可用模型 |
| Agent 仍用 Gemini | 在模型选择器里切换到 APIMaster.ai 分组下的模型 |
| 404 / model not found | 在 Model Providers 取消勾选不可用 id,Refresh 后重选 |
| 部分 AI 功能不可用 | 第三方模型主要支持 Chat / Agent;专属功能见 Google 文档 |
| 找不到 Model Providers | 需 Quail 1(2026.1.1+);升级后路径:Tools → AI → Model Providers |
核对清单
- Android Studio 已升级到 Quail 1(2026.1.1+)
- Tools → AI → Model Providers 已添加 APIMaster.ai
- URL =
https://apimaster.ai/v1,URL Schema = OpenAI-compatible - API key 已填 APIMaster Key
- 已 Refresh 并勾选要用的模型
- Agent 模型选择器已选 APIMaster 模型,对话正常