其他工具接入

凡是允许自定义 base URL 的 AI 工具，都可以接入 GoodPut AI。通用规则：

模型 ID 一律填模型库中的完整 ID（如 z-ai/glm-5.2）。以下按工具类型给出具体步骤。

Cline / Roo Code（VS Code）

1. API Provider 选择 OpenAI Compatible
2. Base URL 填 https://api.goodputai.cn/v1
3. API Key 填你的 GoodPut API Key
4. Model ID 填 z-ai/glm-5.2 或 deepseek/deepseek-v4-pro

Cursor

Cursor Settings → Models → 展开 OpenAI API Key：

1. 填入你的 GoodPut API Key
2. 打开 Override OpenAI Base URL，填 https://api.goodputai.cn/v1
3. 在模型列表中 Add model，输入平台模型 ID（如 deepseek/deepseek-v4-pro）

Cherry Studio

设置 → 模型服务 → 添加提供商：

1. 提供商类型选 OpenAI
2. API 地址填 https://api.goodputai.cn/v1/（注意以 / 结尾）
3. API 密钥填你的 GoodPut API Key
4. 点「管理」从模型列表自动拉取，或手动添加模型 ID

Open WebUI

管理员面板 → 设置 → 外部连接 → OpenAI API：

1. API 地址填 https://api.goodputai.cn/v1
2. 填入 API Key 并保存，模型列表自动同步

Dify / FastGPT

添加模型供应商时选择 OpenAI-API-compatible：

• API Base 填 https://api.goodputai.cn/v1
• 逐个添加需要的模型 ID（如 z-ai/glm-5.2）

沉浸式翻译

翻译服务选择 OpenAI，展开自定义选项：

• 自定义 API 接口地址填 https://api.goodputai.cn/v1/chat/completions
• APIKEY 填你的 GoodPut API Key
• 模型填 deepseek/deepseek-v4-flash（翻译场景轻快便宜）

LangChain / LlamaIndex 等框架

直接按 OpenAI SDK 形式初始化：

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://api.goodputai.cn/v1",
    api_key="你的 GoodPut API Key",
    model="deepseek/deepseek-v4-pro",
)

接入不上？

• 确认 base URL 末尾是否需要 /v1（工具间约定不同，两种都试一下）
• 用 curl 直接验证 Key 与模型 ID 是否正确（见快速开始）
• 错误码含义见错误码与限流