# 后端配置说明

## DashScope 国际版配置

### 环境变量

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

```bash
# 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-开头

### 切换方法

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

系统会自动切换以下服务的 endpoint:
- ✅ STT (语音识别)
- ✅ LLM (大语言模型)
- ✅ TTS (语音合成)
- ✅ DNS 预解析
- ✅ API Key 自动选择

### 完整配置示例

**方案1：只使用一个 key（不推荐，需确保 key 与地域匹配）**
```bash
# 国内版
DASHSCOPE_API_KEY=sk-beijing-xxx
USE_DASHSCOPE_INTL=false

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

**方案2：分别配置两个 key（推荐，灵活切换）**
```bash
# 同时配置两个地域的 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
```