#Cloud 密钥（BYOK）

##在 Waymark 中添加密钥

1. 按照本页下方的步骤，从你选择的公司获取密钥。
2. 在 Waymark 中打开“设置 › 翻译与语音”，点按要设置的功能：文本与对话翻译、图片翻译或语音。
3. 选择服务商，把密钥粘贴到“在此粘贴 API 密钥”，然后点按“保存”。
4. 点按“测试连接”确认可以使用。
5. 图片翻译和语音默认开启“使用与文本翻译相同的密钥”，所以一个密钥就能覆盖全部功能。若想为某项功能使用其他公司，关闭此选项即可。

##不填密钥也能用

Waymark 的所有功能都能在本机运行。密钥是可选的，能让翻译更自然、更好地识别难读的图片，在嘈杂环境中听得更准。

##什么是 API 密钥？

这是注册 AI 服务后获得的一串长代码，类似预付卡：用多少付多少，直接付给该公司，钱不经过 Waymark。

密钥只保存在本机，不上传 iCloud，可随时在设置中删除。

##该怎么选？

###直接使用 OpenAI

注册 OpenAI，在文本翻译中填一个密钥，图片和语音会自动使用同一个密钥。

###前往中国大陆

在中国不用 VPN 通常无法使用 OpenAI。文本翻译用 DeepSeek，图片翻译用 Qwen，语音交给本机处理。

###最省钱

只在文本翻译中使用 DeepSeek，图片和语音在本机处理。

##各公司能做什么

所选公司做不到的，Waymark 会在本机完成。目前 OpenAI 和 OpenRouter 支持语音。

部分大模型（如 Claude Opus）响应较慢。句子超过 5 秒时 Waymark 会改为本机翻译，经常这样的话请选更快的模型。

##什么是模型？

每家公司都有多个模型，就像汽车型号：小模型快又便宜，大模型更聪明但更贵更慢。

旅途中的短句用小模型就够了。标有“推荐”的模型已默认选好，不用更改。

##费用

按实际用量计费。短文本花费很少，图片和语音比文本贵。选择模型页会标出等级：“很便宜 / 便宜 / 中等 / 较贵”。

实际价格可能变动，请查看各公司的价格页面。建议在公司网站上设置“消费上限”（spending limit），避免超出预期花费。

应用中的价格等级只是模型间的粗略比较，并非实际价格。Waymark 不保证价格或模型列表的准确性，每次使用前请以官方网站为准。

##逐步获取密钥

###OpenRouter

https://openrouter.ai

1. 打开上方网站，注册或登录
2. 在 Credits 页面充值
3. 前往 Keys 页面，点击 Create Key
4. 复制以 sk-or- 开头的密钥并粘贴到 Waymark

###OpenAI

https://platform.openai.com

1. 打开上方网站，注册或登录
2. 在 Billing 页面充值（最低金额由公司规定）
3. 前往 API keys 页面，点击 Create new secret key
4. 复制以 sk- 开头的密钥并粘贴到 Waymark（只显示一次）

###DeepSeek

https://platform.deepseek.com

1. 打开上方网站，注册或登录
2. 在 Top up 页面充值
3. 前往 API keys 页面创建新密钥
4. 复制并粘贴到 Waymark

###Gemini (Google)

https://aistudio.google.com

1. 打开上方网站，用 Google 账号登录
2. 点击 Get API key 并创建新密钥
3. 复制并粘贴到 Waymark
4. 超出免费额度后，需要在 Google Cloud 的 Billing 页面绑定银行卡

###Claude (Anthropic)

https://platform.claude.com

1. 打开上方网站，注册或登录
2. 在 Billing 页面充值
3. 前往 API Keys 页面，点击 Create Key
4. 复制以 sk-ant- 开头的密钥并粘贴到 Waymark

###Qwen (Alibaba Cloud)

https://www.alibabacloud.com

1. 注册阿里云并找到 Model Studio（百炼）服务
2. 开通服务并创建 API 密钥
3. 复制并粘贴到 Waymark
4. 中国大陆账号：打开“高级设置”，将 Base URL 设为 https://dashscope.aliyuncs.com/compatible-mode/v1

##AI 翻译有多可靠？

无论本机翻译还是云端 AI 翻译，都可能出错、遗漏或添加内容，尤其是当地菜名、药名、数字和价格。

在出错可能危险的事情上，例如食物过敏、生病、用药、法律或正式文件，请出示应急卡片（已翻译并核对的短语），并务必向工作人员或专业人士确认。Waymark 是沟通辅助工具，不保证翻译准确。

##你的数据会去哪里？

为某项任务填写密钥后，该任务的文本、图片或语音会直接从你的设备发送到所选公司，并受该公司政策约束，不经过 Waymark 的服务器。

如果填写中转或代理的 Base URL，其所有者能看到经过的全部内容。只使用你自己管理或信任的服务。