Android Studio ↗ 通过其内置 AI 助手和 GitHub Copilot 插件 ↗支持自定义模型提供程序。将提供程序指向 AI Gateway 的 OpenAI 兼容端点,即可通过你的网关路由请求。请使用 Cloudflare API 令牌进行身份验证,并通过统一计费或已存储的提供程序密钥向模型提供程序进行身份验证。
请配置你要使用的助手。内置 AI 助手和 GitHub Copilot Chat 有各自独立的提供程序设置。
开始之前,你需要:
- 你的 Cloudflare 账户 ID。查找方法请参阅查找账户和 zone ID。
- 已通过身份验证的 AI Gateway。你可以使用账户的
default网关,也可以创建网关并使用其 slug。 - 具有 Account > AI Gateway > Run 权限的 Cloudflare API 令牌。
- 所选模型的统一计费额度或已存储的提供程序密钥。
- 已安装 Android Studio。若使用内置 AI 助手,请选择支持第三方远程模型提供程序的版本。若使用 GitHub Copilot Chat,请安装最新的 GitHub Copilot 插件 ↗并完成登录流程。
-
在 Android Studio 设置中,转到 Tools > AI > Model Providers。
-
选择 Add > Third-Party Remote Provider。
-
在 Description 中输入名称,例如
Cloudflare AI Gateway。 -
在 URL 中输入以下值。将
<ACCOUNT_ID>和<GATEWAY_ID>替换为你的 Cloudflare 账户 ID 和网关 slug。网关 slug 可以使用default。https://gateway.ai.cloudflare.com/v1/<ACCOUNT_ID>/<GATEWAY_ID>/compat输入不带
/chat/completions的基础 URL。Android Studio 会先获取模型列表,然后你才能选择模型。 -
对于 URL Schema,选择 OpenAI-compatible。对于 API key,输入 Cloudflare API 令牌。
-
选择 Refresh 获取模型列表。选择要使用的模型,然后选择 OK 保存设置。
请选择统一计费额度或已存储的提供程序密钥支持的模型。模型出现在列表中,并不代表你已为其配置凭据。
-
打开 AI 聊天窗口。使用模型选择器从远程提供程序中选择模型,然后发送提示。
部分专用 Android Studio AI 功能可能无法与第三方模型搭配使用。有关功能兼容性,请参阅使用远程模型 ↗。
在 GitHub Copilot Chat 中使用自定义端点提供程序。请为此配置明确选择 Chat Completions。
-
打开 GitHub Copilot Chat。在模型选择器中,选择 Manage Models。
-
在 Language Models (Copilot) 中,选择 Add Models,然后选择自定义端点提供程序选项。
-
在 Add Custom Endpoint Provider 中输入以下值:
- Provider Name:
Cloudflare AI Gateway。 - API Key:你的 Cloudflare API 令牌。
- API Type:Chat Completions。
- Provider Name:
-
选择 Save。在 Add Model 对话框中,按
provider/model格式输入模型 ID。例如,输入openai/gpt-4.1-mini。请选择统一计费额度或已存储的提供程序密钥支持的模型。
-
对于 Deployment URL,输入以下值。将
<ACCOUNT_ID>和<GATEWAY_ID>替换为你的 Cloudflare 账户 ID 和网关 slug:https://gateway.ai.cloudflare.com/v1/<ACCOUNT_ID>/<GATEWAY_ID>/compat/chat/completions请包含
/chat/completions。与内置助手不同,此字段需要填写完整端点 URL。 -
对于 Model Friendly Display Name,输入名称,例如
GPT-4.1 mini via AI Gateway。请根据模型设置令牌限制和功能。对于openai/gpt-4.1-mini,可以使用以下设置:- Max Input Tokens:
128000。 - Max Output Tokens:
16000。 - Support Tool Calling:已选中。
- Support Vision:已选中。
- Custom Request Headers:未选中。
- Max Input Tokens:
-
选择 Save,然后选择 OK。启动新的 Copilot 聊天,并从模型选择器中选择你的自定义模型。
-
发送类似
Reply with exactly: copilot-gateway-test的提示,并确认 Copilot 显示了回复。
要确认流量已到达 AI Gateway,请参阅验证是否生效。