配置翻译服务Set up a translation service

开始之前Before you start

在 Sill 中打开「Translate → Settings」，添加服务，然后打开对应的配置指南。填写必要的 API Key、Model 和 Region 后，先点「Test Service」；测试会发送固定的 “Hello”，并可能消耗少量额度。

In Sill, open Translate → Settings, add a service, then open its setup guide. Enter the required API Key, Model, and Region, then choose Test Service. The test sends the fixed text “Hello” and may use a small amount of quota.

MyMemory

无需注册或 API Key，适合先体验；它是公共第三方服务，完整原文会离开这台 Mac，并受公共每日额度限制。

No account or API key is required, so it is useful for trying Translate. It is a public third-party service: the full source text leaves your Mac and public daily limits apply.

1. 在 Sill 添加 MyMemory 并设为默认服务。Add MyMemory in Sill and make it the default service.
2. 无需填写 Key；直接测试连接。Leave the Key field empty and test the connection.
3. 不要提交密码、Token、私人通信或公司机密。Do not submit passwords, tokens, private messages, or confidential work.

官方公开匿名额度在本文更新时为 5,000 characters/day；额度和条款可能变化，请以官方页面为准。

At this guide's last update, the published anonymous limit was 5,000 characters/day. Limits and terms can change; use the official pages as the current source.

DeepL API Free / Pro

需要 DeepL API 套餐和 API Key。普通 DeepL Translator 订阅不是 API 套餐；Free 与 Pro 必须使用各自对应的 endpoint。

Requires a DeepL API plan and API key. A regular DeepL Translator subscription is not an API plan, and Free and Pro use different endpoints.

1. 开通 DeepL API Free 或 API Pro。Activate DeepL API Free or API Pro.
2. 在 API Keys 页面为 Sill 创建单独的 Key，并设置 usage limit。Create a separate key for Sill on the API Keys page and set a usage limit.
3. 在 Sill 选择与套餐匹配的 DeepL preset，粘贴 Key 并测试。Choose the matching DeepL preset in Sill, paste the key, and test it.

Microsoft Translator

需要 Azure Translator resource。Global resource 只需 Key；regional 或 multi-service resource 还需要填写 Region。

Requires an Azure Translator resource. A global resource needs only a key; a regional or multi-service resource also needs Region.

1. 在 Azure 创建 Translator resource 并选择计费层。Create a Translator resource in Azure and choose a pricing tier.
2. 打开 resource 的 Keys and Endpoint，复制 Key；仅在页面给出 Region 时填写 Region。Open Keys and Endpoint for the resource and copy a key. Enter Region only when the resource shows one.
3. 在 Sill 保留默认 API URL，填写 Key 和可选 Region，然后测试。Keep Sill's default API URL, enter the key and optional Region, then test.

Google Cloud Translation Basic v2

需要 Google Cloud project、Cloud Billing、已启用的 Cloud Translation API，以及限制到该 API 的 Key。Gemini AI Studio Key 不能用于这里。

Requires a Google Cloud project, Cloud Billing, the enabled Cloud Translation API, and a key restricted to that API. A Gemini AI Studio key does not work here.

1. 创建或选择 project，关联 Billing，并启用 Cloud Translation API。Create or select a project, attach Billing, and enable the Cloud Translation API.
2. 在 Credentials 创建 API Key，并把 API restriction 设为 Cloud Translation API。Create an API key in Credentials and restrict it to the Cloud Translation API.
3. 把 Key 粘贴到 Sill 的 Google Cloud Translation 服务并测试。Paste the key into Sill's Google Cloud Translation service and test it.

OpenAI API

ChatGPT 订阅不包含 API 计费。你需要 developer platform 的 API Key、可用的 Billing/余额和一个当前支持的 Model ID。

A ChatGPT subscription does not include API billing. You need a developer-platform API key, active Billing or balance, and a currently supported Model ID.

1. 在 developer platform 创建 project API Key，并配置 API Billing。Create a project API key on the developer platform and configure API Billing.
2. 从官方模型列表选择支持 Chat Completions 的 Model ID。Choose a Model ID that supports Chat Completions from the official model list.
3. 在 Sill 填写 API Key 和 Model；保留默认 API URL 后测试。Enter the API Key and Model in Sill, keep the default API URL, and test.

DeepSeek API

需要 DeepSeek Platform Key、可用余额和 Model ID。Sill 已预设 OpenAI-compatible API URL。

Requires a DeepSeek Platform key, available balance, and a Model ID. Sill already supplies the OpenAI-compatible API URL.

1. 注册 DeepSeek Platform 并创建 API Key。Register on DeepSeek Platform and create an API key.
2. 确认账户有可用余额，并从官方文档复制 Model ID。Confirm the account has available balance and copy a Model ID from the official docs.
3. 在 Sill 填写 Key 与 Model，然后测试。Enter the key and Model in Sill, then test.

Gemini Developer API

使用 Google AI Studio Key 和 Gemini Model ID。它不是 Google Cloud Translation，也不等同于 Gemini 消费者订阅。

Uses a Google AI Studio key and Gemini Model ID. It is not Google Cloud Translation and is separate from a consumer Gemini subscription.

1. 在 Google AI Studio 创建或导入 project API Key。Create or import a project API key in Google AI Studio.
2. 从 OpenAI compatibility 文档选择当前可用的 Model ID。Choose a current Model ID from the OpenAI compatibility guide.
3. 在 Sill 填写 Key 和 Model；不要使用 Cloud Translation Key。Enter the key and Model in Sill. Do not use a Cloud Translation key.

Qwen · Alibaba Cloud Model Studio

Sill 当前 preset 指向中国内地北京 endpoint。API Key、Model 和 endpoint 必须属于同一 Region；国际站 Key 不能直接用于这个 preset。

Sill's current preset uses the Mainland China (Beijing) endpoint. API Key, Model, and endpoint must use the same Region; an international key does not work with this preset.

1. 在阿里云百炼 / Model Studio 的北京地域开通模型服务。Activate Model Studio in the Beijing region.
2. 创建同地域的 DASHSCOPE_API_KEY，并选择该地域可用的 Model ID。Create a DASHSCOPE_API_KEY in the same region and choose a Model ID available there.
3. 在 Sill 填写 Key 和 Model，保留北京 API URL 后测试。Enter the key and Model in Sill, keep the Beijing API URL, and test.

SiliconFlow

需要 SiliconCloud API Key 和模型广场中显示的完整 Model ID。免费模型、赠送余额和价格会随模型变化。

Requires a SiliconCloud API key and the complete Model ID shown in the model catalog. Free models, promotional balance, and pricing vary by model.

1. 登录 SiliconCloud，在 API Keys 页面创建独立 Key。Sign in to SiliconCloud and create a separate key on the API Keys page.
2. 从模型广场复制完整 Model ID。Copy the complete Model ID from the model catalog.
3. 在 Sill 填写 Key 与 Model，然后测试。Enter the key and Model in Sill, then test.

火山方舟Volcengine Ark

必须先在方舟开通目标模型，再创建当前 project 的 API Key，并填写对应 Model ID。Sill 的 preset 使用北京地域 API URL。

First activate the model in Ark, then create an API key for the current project and enter the matching Model ID. Sill's preset uses the Beijing API URL.

1. 在「开通管理」开通目标模型，并确认当前 project。Activate the target model under Activation Management and confirm the current project.
2. 创建 project API Key；尽量限制到所需模型和调用来源。Create a project API key and restrict it to the required model and callers where possible.
3. 复制 Model ID，在 Sill 填写 Key 与 Model 后测试。Copy the Model ID, enter the key and Model in Sill, then test.

Custom OpenAI-compatible

用于你信任的 OpenAI-compatible 服务或自建网关。Sill 只能验证协议能否工作，不能验证服务器的运营方、日志、留存或计费安全。

For an OpenAI-compatible provider or self-hosted gateway you trust. Sill can test protocol compatibility, but it cannot verify the operator, logging, retention, or billing practices of that server.

1. 从服务方取得 HTTPS API base URL、API Key 与 Model ID。Get the HTTPS API base URL, API key, and Model ID from the provider.
2. API URL 不要包含 `/chat/completions`、query 参数或凭据；Sill 会自动追加路径。Do not include `/chat/completions`, query parameters, or credentials in the API URL. Sill appends the path.
3. 确认服务可信后再测试；测试成功不代表隐私或计费安全。Test only after you trust the service. A passing test does not prove privacy or billing safety.

没有通用的注册、Billing、Pricing 或 API Keys 页面；请使用服务方自己的官方文档。

There is no universal signup, Billing, Pricing, or API Keys page. Use the provider's own official documentation.