API 密钥

Transrewrt 不包含自己的 AI —— 它会将您的文本发送到您选择的 AI 提供商。要连接提供商，您需要添加 API 密钥：这是由提供商签发的私有代码，类似于其服务的密码。您只需 一个 提供商即可开始，而且无需付费：多家提供商提供免费模型或免费层级，您也可以完全不用密钥而在自己的计算机上运行模型。

受支持的提供商包括 OpenRouter、OpenAI、Anthropic、Google Gemini、DeepSeek、Groq、Mistral、xAI、Cerebras、NVIDIA、阿里云、apikey.fun、任何兼容 OpenAI 的端点，以及本地兼容 OpenAI 的服务器（Ollama、LM Studio、llama.cpp 等）。

第 1 步 — 选择提供商

任何受支持的提供商都可以。如果您不确定选哪个：

• 免费开始：OpenRouter、Google Gemini、Groq、Mistral、Cerebras 和 NVIDIA 都提供免费模型或免费层级。
• 已有账户？ 如果您已经在使用 OpenAI、Anthropic 或其他受支持的提供商，只需复用该账户即可。
• 倾向于将一切保留在自己的计算机上？ 完全跳过密钥，改用本地模型。

第 2 步 — 创建 API 密钥

具体步骤因提供商而略有不同，但各处的模式都是一样的：

1. 在提供商的网站上注册或登录。在 Transrewrt 的 设置 → API 配置 中，每个提供商都有一个 打开提供商网站 链接，可将您带到正确的位置。
2. 找到 API 密钥 页面（有时位于账户、仪表板或开发者设置下）并创建新密钥。有些提供商会要求您为密钥命名或设置支出限额 —— 两者都是可选的。
3. 复制密钥。它是一长串字母和数字，通常以类似 sk- 的内容开头。

注意

请像对待密码一样对待 API 密钥：不要分享、发布或将其发送给任何人。如果密钥泄露，请在提供商网站上将其删除并创建一个新密钥。

第 3 步 — 添加并测试密钥（桌面版）

1. 在 Transrewrt 中，打开 设置 → API 配置。
2. 将密钥粘贴到您的提供商对应的字段中（例如 Google Gemini API 密钥）并保存。
3. 点击该字段旁边的 测试 以确认密钥有效。

测试成功后，您就准备就绪了 —— 在主屏幕上选择该提供商并开始翻译。

改用本地模型（无 API 密钥）

您可以使用 Ollama、LM Studio、llama.cpp 或其他兼容 OpenAI 的服务器（例如通过 LM Studio 的 google/gemma-4-e2b）在自己的计算机上运行模型。数据不会离开您的机器，也不需要 API 密钥。

要连接本地模型，请将 Local LLM base URL 设置为完整的 API 基础地址（包括路径）—— 例如 http://localhost:11434/v1。在桌面版中，在 设置 → API 配置 中进行设置；在 Docker 中，请改为设置 LOCAL_LLM_URL 环境变量。

提示

如果您使用来自其他设备或容器的本地 LLM 服务器，请将其配置为允许外部连接（而非仅限本地主机）。

Docker / 网页版

如果您在浏览器中使用 Transrewrt，密钥由运行服务器的人员管理，而不是在浏览器界面中输入。管理员在服务器上将提供商密钥设置为 环境变量（例如 PROVIDER_API_KEY）—— 请参阅配置。

首次运行检查清单

1. 打开应用，如有需要请设置 界面语言。
2. 添加并测试至少一个提供商密钥 —— 或者配置本地模型（桌面版），或者确认服务器具有环境密钥（网页版）。
3. 在 简易 模式下，在常规设置中选择 提供商；在 高级 模式下，在 设置 → 模型 下添加模型 —— 有关这两种模式，请参阅设置。
4. 在 翻译 中，选择预设或模型并运行简短测试 —— 请参阅翻译文本。

如果出现问题

• 密钥测试失败：检查密钥是否已完整复制（前后没有空格），以及是否已在提供商网站上被删除或禁用。
• 翻译失败并出现配额或额度错误：免费套餐有每日或每月限制；请等待、切换到其他免费提供商，或充值。
• 简易模式下未显示提供商：打开设置 → API 配置，确认至少配置并测试了一个密钥（或本地 LLM URL）。

更多帮助：常见问题。