Droid API 设置：如何连接自定义 AI 模型

想在无需复杂设置的情况下，使用自己的 AI 模型编程？Droid 通过 CLI 支持外部 API，让你可以连接适合自身工作流的自定义模型。本指南将介绍如何设置 API、解决常见问题，以及在 Droid 中使用 Kimi。继续阅读，开始使用吧。

Droid 是一款 AI 编程工具，可帮助开发者编写代码、解决错误，更高效地处理开发任务。它支持内置 AI 模型，也允许用户通过 CLI 连接自定义模型，提供更多灵活性。无论你需要快速协助，还是更个性化的配置，它都适用于不同的编程工作流。

内置 AI 模型让你能够轻松开始使用 Droid 编程，无需先连接任何外部 API。安装应用后，你可以在平台内选择模型，并开始借助 AI 进行代码分析、功能开发、修复 bug 和代码审查。以下是开始使用 Droid 的方法：

第 1 步：安装并打开 Droid

先在设备上下载 Factory 应用并完成安装。然后打开应用并登录账户，即可在应用中使用 Droid 及其内置 AI 功能。

第 2 步：将 Droid 连接到项目文件夹

将工作目录设为你要处理的代码库。这样会将 Droid 与本地项目关联起来，使其能够读取文件、理解代码结构，并基于更充分的上下文支持你的开发任务。

第 3 步：选择内置模型并开始输入提示词

打开模型选择器，从 Droid 提供的内置 AI 模型中选择一个。选定模型后，你就可以输入提示词，例如让它分析代码库、修复 bug、审查代码或开发功能。

将 Droid 连接到外部 API 后，你可以自由使用偏好的模型，不再局限于内置选项。设置过程是在 Droid CLI 中向设置文件添加自定义模型；保存后，该模型便会出现在 /model 菜单中。以下步骤以 Kimi 为例，帮助你了解从 API 密钥到模型选择的完整设置流程：

第 1 步：从月之暗面获取 Kimi API 密钥

首先，在月之暗面创建或复制你的Kimi API 密钥。Droid 需要使用此密钥连接 Kimi API，并通过你的账户发送请求。建议将密钥保存为 MOONSHOT_API_KEY 等环境变量，以便在设置文件中安全使用。

第 2 步：打开 Droid 设置文件

接下来，打开 Droid CLI 中用于添加自定义模型的设置文件。在 macOS 上，文件路径为 ~/.factory/settings.json。在 Windows PowerShell 上，使用 %USERPROFILE%\.factory\settings.json。这是 Droid 读取自定义模型配置的主文件。

第 3 步：将 Kimi 添加为自定义模型

在 settings.json 中，将 Kimi 添加到 customModels 数组下。这会告知 Droid 要使用哪个模型、应调用哪个 API 端点、遵循哪种提供商格式，以及使用哪个 API 密钥进行身份验证。如果文件中已有其他设置，请不要替换全部内容，只需将此模型对象添加到现有的 customModels 数组中。

第 4 步：保存文件并重启 Droid

添加配置后，保存文件并重启 Droid CLI。这样可确保 Droid 重新加载更新后的设置，并正确识别新添加的自定义模型。

第 5 步：在 Droid 中通过 /model 选择 Kimi 模型

打开 Droid CLI 并运行 /model 命令。你的 Kimi 配置现在应会显示在“自定义模型”部分。从列表中选择它，即可将 Kimi 设为当前编程会话的活动模型。

第 6 步：运行任务

选择 Kimi 后，即可在 Droid 中将它用于实际工作。可以尝试让它审查代码、修复 bug，或解释代码库。Droid 会通过 Kimi API 发送请求，并使用该模型完成任务。

将 Kimi 连接到 Droid 后，它不再只是 CLI 中的外部模型，而会成为融入日常开发流程的实用编程助手，既能处理小型编码工作，也能协助完成更大型的工程任务。使用 Kimi API 的优势包括：

• 提升开发效率

Kimi 可以在你工作时生成代码、解释逻辑并提出修复建议，帮助你更快完成日常编码任务。这意味着，对于简单的开发支持，你无需在多个工具之间来回切换。在 Droid 中使用 Kimi，日常编程工作会更高效、更易管理。

• 编写更可靠的代码

Kimi 可以审查你的代码、指出潜在问题，并在小错误演变成大问题之前帮助改进代码结构。当你希望逻辑更清晰、代码更易维护时，这类早期反馈尤为有用。长期来看，它能帮助你构建更易测试、更新和理解的代码。

• 应对多样化的开发任务

Kimi 不仅能从零开始编写代码，还能协助重构、编写代码文档、理解陌生项目，并支持不同任务中的功能开发。对于希望用一个 AI 模型协助处理工作流程多个环节的开发者来说，这使其成为灵活的选择。

在 Droid 中连接外部 API 密钥通常很简单，但细小的配置错误仍可能导致问题。大多数问题出在设置文件、提供商名称、API 密钥或模型服务器配置上，而非 Droid 本身。好在，找对排查方向后，这些错误通常很容易解决。

• 检查 ~/.factory/settings.json 中的 JSON 语法；如果使用旧版格式，则检查 config.json

• 系统会通过文件监测自动检测设置变更

• 确认自定义模型配置中包含所有必填字段

• 确保 provider 的值严格为 anthropic、openai 或 generic-chat-completion-api

• 检查 provider 字段是否存在拼写错误，并确认大小写正确

• 确认你的 API 密钥有效且有可用额度

• 检查 API 密钥是否具有该提供商所需的正确权限

• 确认基础 URL 与提供商文档中的 API 端点一致

• 确保本地模型服务器正在运行，例如 ollama serve

• 确认基础 URL 正确；如果提供商要求，请包含 /v1/

• 检查模型是否已拉取或可在本地使用

• 检查提供商的 API 速率限制和使用配额

• 在提供商控制台中监控用量，确认是否已达到限制

在 Droid 中使用自定义 API，让你能够更自主地决定如何借助 AI 编写、测试和改进代码。完成设置后，你可以更轻松地围绕符合自身需求的模型打造编程流程。无论继续使用内置选项，还是连接外部模型，Droid 都提供了将 AI 引入开发工作的灵活方式。如果想从简单的自定义配置开始，可以在 Droid 中试试 Kimi。它是让日常编码工作更顺畅、更高效的实用选择。