海王出海SCRM的API密钥需在翻译引擎官方平台自行获取，DeepL在账户中心API页面生成，Google Translate在Google Cloud Console凭据页面创建，Azure Translator在Translator资源管理页面获取访问密钥和终结点，OpenAI在API Keys管理页面生成。获取密钥后登录海王出海SCRM后台进入翻译设置的引擎配置区域，选择目标引擎类型将密钥完整粘贴到对应输入框中并填写必要的终结点URL。保存后点击测试连接验证密钥有效性，测试成功后引擎即可正常使用。密钥填写时需注意首尾不含空格且大小写正确，部分引擎区分大小写。密钥支持随时修改覆盖旧密钥后即时生效，建议每季度更换一次密钥以保障安全，发现泄露需立即在引擎官方平台删除并重新生成更新。Google Translate和Azure Translator需绑定有效支付方式才能生成可用密钥。测试连接失败时的常见原因包括网络防火墙限制和密钥格式错误，可逐项排查后重试。
API密钥获取与填写的前置准备
API密钥的功能定位与使用场景
海王出海SCRM的API密钥是用于对接第三方翻译引擎DeepL、Google Translate、Azure Translator和OpenAI GPT的身份凭证，系统通过密钥验证企业账号的合法身份和调用权限。API密钥由各翻译引擎官方平台生成并发放，海王出海SCRM本身不生成任何翻译引擎的API密钥。密钥的正确获取和填写是接入第三方引擎并正常使用翻译功能的前提，填写错误会导致翻译请求失败或服务不可用。
获取API密钥前需要完成的准备工作
获取API密钥前需完成以下准备工作，在翻译引擎官方平台注册企业账号并完成邮箱验证，部分引擎需要绑定有效的支付方式或完成企业认证。Google Translate需要启用结算功能并创建项目，Azure Translator需要订阅有效的套餐计划，DeepL需要选择API使用计划类型。建议准备一个专门的团队邮箱用于注册和接收各引擎的通知信息，便于后续统一管理密钥的更新和续期通知。
不同引擎的密钥格式与特征
各翻译引擎的API密钥格式各不相同，DeepL的密钥通常为字母和数字混合的长字符串，以冒号分隔的格式呈现。Google Translate的API密钥通常为40位字母数字混合的字符串。Azure Translator的访问密钥为32位字母数字混合的字符串，同时提供终结点URL。OpenAI的API密钥以sk-开头后跟一串字母数字混合的字符串。了解各引擎的密钥格式特征有助于在配置时判断填写是否正确，避免因格式错误导致验证失败。
各翻译引擎API密钥的获取路径
DeepL API密钥的获取方法
登录DeepL官方网站后进入账户中心，在账户概览页面中找到API Access或API密钥管理选项并点击进入。DeepL提供免费试用密钥和付费专业密钥两种类型，免费密钥有字符数限制且仅用于测试，专业密钥需订阅付费计划。在API密钥管理页面中点击创建密钥或Generate New Key按钮，系统自动生成一串密钥字符串，复制该密钥。新生成的密钥立即生效可用于海王出海SCRM的接入配置，旧密钥被替换后立即失效。
Google Translate API密钥的获取方法
登录Google Cloud Console后选择或创建用于翻译服务的项目，在项目页面左侧导航栏中找到API与服务菜单下的凭据选项并点击进入。在凭据页面中点击创建凭据按钮，在下拉菜单中选择API密钥选项，系统自动生成一个API密钥并显示在弹出窗口中。新生成的API密钥在创建后立即生效，为保护密钥安全建议在创建后立即复制并保存到安全位置。
Azure Translator API密钥的获取方法
登录Azure门户后在搜索框中输入Translator并选择Translator服务资源，如果尚未创建资源需先完成创建流程。进入Translator资源的管理页面后，在左侧导航栏中找到密钥和终结点选项并点击进入。页面中显示密钥1和密钥2两个访问密钥以及终结点URL，任选一个密钥复制使用即可。密钥1和密钥2功能完全相同。
OpenAI API密钥的获取方法
登录OpenAI平台后在页面右上角点击个人头像进入API管理或API Keys管理页面，在API密钥列表页面中点击Create new secret key按钮创建新密钥。系统弹出创建密钥的对话框，可为该密钥命名以便后续区分不同用途。点击Create secret key后系统生成以sk-开头的密钥字符串，这是唯一一次可见完整密钥的机会。
API密钥在海王出海SCRM中的填写方法
进入API密钥配置界面的操作路径
管理员登录海王出海SCRM后台后，在翻译设置页面中找到翻译引擎配置或第三方服务集成模块。引擎配置界面以卡片形式展示DeepL、Google Translate、Azure Translator和OpenAI GPT四个引擎的接入状态和配置入口。点击需要配置的引擎卡片上的配置按钮进入该引擎的API密钥填写表单页面。
各引擎API密钥的填写字段说明
DeepL的配置表单包含API密钥字段，将DeepL账户中心复制的密钥完整粘贴到输入框中即可完成配置。Google Translate的配置表单包含API密钥字段，将Google Cloud Console生成的密钥完整粘贴即可完成配置。Azure Translator的配置表单包含访问密钥和终结点URL两个必填字段，分别粘贴Azure门户中复制的密钥和终结点地址。OpenAI的配置表单包含API密钥字段，将OpenAI平台生成的sk-开头密钥完整粘贴即可。
填写时的注意事项与格式要求
填写API密钥时需注意不要包含首尾多余空格，粘贴后建议前后检查确保不包含换行符或特殊不可见字符。部分密钥区分大小写，粘贴时应保持原样不做任何修改。Azure Translator的终结点URL需包含完整的区域信息，不同区域的终结点地址不同。OpenAI密钥填写后建议先保存再执行测试连接，避免因未保存导致测试失败。
API密钥填写后的验证与生效
测试连接的操作方法与成功标准
填写完API密钥后点击配置表单中的测试连接或Validate按钮，系统向翻译引擎官方API发送一条测试请求验证凭证的有效性。测试成功时按钮变为绿色并显示连接成功或凭证有效的提示，该引擎即被正式接入可使用。测试成功后在引擎卡片上显示已接入的状态标识。
测试连接失败时的常见错误与解决
测试连接失败时的错误信息包括无效凭证、网络超时和认证失败等。无效凭证表示API密钥本身无效或已过期需重新获取，网络超时表示网络环境无法访问引擎API需检查防火墙和代理设置，认证失败表示密钥格式或类型与所选引擎不匹配需确认密钥类型是否正确。建议根据错误信息逐项排查调整后重新测试。
保存配置后的生效时间与验证方法
API密钥配置保存后立即生效，无需重启软件或重新登录。生效验证可通过发送测试消息并查看翻译结果是否正常返回完成，翻译成功说明API密钥配置正确且服务可用。如果翻译请求持续失败，建议返回配置页面重新检查API密钥是否正确填写。
API密钥的更新与安全管理
API密钥的定期更新策略
建议企业每季度更换一次翻译引擎的API密钥，长期使用同一密钥存在被泄露或被滥用的风险。更换密钥前需先在引擎官方平台生成新密钥，然后在海王出海SCRM后台更新对应的配置字段。新旧密钥交替期间，旧密钥失效后立即使用新密钥。
密钥权限的最小化配置
在引擎官方平台创建API密钥时建议配置最小权限范围，仅授予翻译服务所需的调用权限，不授予账号管理或其他敏感操作的权限。限制密钥的IP白名单可进一步提升安全性。
密钥泄露的应急处理方案
发现API密钥可能泄露时应立即在引擎官方平台删除该密钥并生成新的密钥，同时在海王出海SCRM后台更新配置。更新完成后通过测试连接确认新密钥生效，旧密钥已被官方平台撤销。