APIMaster.ai

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 连通性测试 辅助排查。


前置条件

  1. 已安装 Android Studio Quail 1(2026.1.1 或更新;Help → Check for Updates 升级)。
  2. 已从 APIMaster 控制台 复制 API Key。
  3. 已在 模型广场 了解可用 model id(Refresh 后会自动拉取列表)。

第 1 步:打开 Model Providers 并添加 Provider

  1. 打开 Settings / Preferences(Windows/Linux:File → Settings;macOS:Android Studio → Settings)。
  2. 左侧展开 Tools → AI,选择 Model Providers
  3. 点击列表上方的 「+」 添加按钮。
  4. 选择 Third-Party Remote Provider(第三方远程 Provider)。

Android Studio Model Providers — 添加 APIMaster.ai


第 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-sol
  • claude-opus-4-8 / claude-sonnet-4-6
  • gemini-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 模型

  1. 打开 Android Studio 右侧 Agent 面板(或 AI 聊天窗口)。
  2. 点击输入框右下角 模型选择器(当前模型名旁的下拉箭头)。
  3. APIMaster.ai 分组下选择已启用的模型(如 gpt-5.6-solclaude-opus-4-8)。
  4. 若要增删 Provider 或调整启用模型,可点击 Manage Models… 回到 Model Providers 设置。

Android Studio Agent — 选择 APIMaster 模型


第 4 步:验证 Agent 对话

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

Android Studio Agent 对话验证


常用 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/v1URL Schema = OpenAI-compatible
  • API key 已填 APIMaster Key
  • Refresh 并勾选要用的模型
  • Agent 模型选择器已选 APIMaster 模型,对话正常

相关链接