后端配置说明

DashScope 国际版配置

环境变量

在 .env 文件中添加以下配置：

# DashScope API Key（国内版，北京地域）
DASHSCOPE_API_KEY=sk-your-domestic-api-key-here

# DashScope API Key（国际版，新加坡地域）- 可选
# 如果不设置，将使用 DASHSCOPE_API_KEY
DASHSCOPE_API_KEY_INTL=sk-your-international-api-key-here

# 是否使用国际版API（新加坡等地区）
# false = 国内版 (dashscope.aliyuncs.com)
# true = 国际版 (dashscope-intl.aliyuncs.com)
USE_DASHSCOPE_INTL=false

重要说明：

国内版和国际版的 API Key 是不同地域申请的，互不通用
国内版：在阿里云百炼（北京地域）申请
国际版：在阿里云国际站（新加坡地域）申请
如果只设置 DASHSCOPE_API_KEY，两个版本都会使用该 key
建议分别设置 DASHSCOPE_API_KEY 和 DASHSCOPE_API_KEY_INTL 以支持灵活切换

国内版 vs 国际版

国内版（默认）:

域名: dashscope.aliyuncs.com
适用: 中国大陆地区
API Key: sk-开头

国际版:

域名: dashscope-intl.aliyuncs.com
适用: 海外地区（新加坡、欧美等）
API Key: sk-开头

切换方法

在 .env 文件中设置对应的 API Key
设置 USE_DASHSCOPE_INTL=true
重启后端服务

系统会自动切换以下服务的 endpoint:

✅ STT (语音识别)
✅ LLM (大语言模型)
✅ TTS (语音合成)
✅ DNS 预解析
✅ API Key 自动选择

完整配置示例

方案1：只使用一个 key（不推荐，需确保 key 与地域匹配）

# 国内版
DASHSCOPE_API_KEY=sk-beijing-xxx
USE_DASHSCOPE_INTL=false

# 国际版
DASHSCOPE_API_KEY=sk-singapore-xxx
USE_DASHSCOPE_INTL=true

方案2：分别配置两个 key（推荐，灵活切换）

# 同时配置两个地域的 key
DASHSCOPE_API_KEY=sk-beijing-xxx
DASHSCOPE_API_KEY_INTL=sk-singapore-xxx

# 国内版：USE_DASHSCOPE_INTL=false，自动使用 DASHSCOPE_API_KEY
USE_DASHSCOPE_INTL=false

# 国际版：USE_DASHSCOPE_INTL=true，自动使用 DASHSCOPE_API_KEY_INTL
# USE_DASHSCOPE_INTL=true