# 🔑 CONFIGURAR API KEYS - MusiaIA

## ⚠️ IMPORTANTE: Debes hacer esto manualmente

El archivo `.env` tiene placeholders. Debes **editarlo** y reemplazar los valores.

---

## 📝 PASOS PARA CONFIGURAR

### 1. Abrir .env

```bash
nano .env
# o
vim .env
# o usa cualquier editor
```

### 2. Cambiar estas líneas:

**Línea 11 - GLM46_API_KEY:**
```bash
# ANTES:
GLM46_API_KEY=your_glm46_api_key_here

# DESPUÉS (con TU API key real):
GLM46_API_KEY=abc123tu_api_key_real_aqui
```

**Línea 22 - ANTHROPIC_AUTH_TOKEN:**
```bash
# ANTES:
ANTHROPIC_AUTH_TOKEN=your_auth_token_here

# DESPUÉS (con TU token real):
ANTHROPIC_AUTH_TOKEN=eyJ...tu_token_completo_aqui
```

---

## 🎯 ¿DÓNDE CONSEGUIR LAS KEYS?

### GLM4.6
1. Ve a: https://open.bigmodel.cn/
2. Crea cuenta o inicia sesión
3. Ve a API Keys
4. Crea nueva API Key
5. **Copia y pega** en `.env` línea 11

### Minimax M2
1. Ve a: https://api.minimax.io/
2. Ve a la sección Anthropic
3. **Copia el ANTHROPIC_AUTH_TOKEN** (línea 224 del .env tenía uno de ejemplo)
4. **Pega en `.env` línea 22**

---

## ✅ VERIFICAR QUE ESTÁN BIEN

Después de editar `.env`, debería verse así:

```bash
# .env
GLM46_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
GLM46_BASE_URL=https://api.z.ai/api/paas/v4
GLM46_MODEL=glm-4.6

ANTHROPIC_BASE_URL=https://api.minimax.io/anthropic
ANTHROPIC_AUTH_TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
MINIMAX_MODEL=MiniMax-M2
```

---

## 🧪 PROBAR QUE FUNCIONAN

```bash
# Test 1: Verificar que .env se lee
python3 -c "
from decouple import config
print('GLM46_KEY:', config('GLM46_API_KEY', default='NO CONFIGURADO')[:20] + '...')
print('ANTHROPIC_TOKEN:', config('ANTHROPIC_AUTH_TOKEN', default='NO CONFIGURADO')[:20] + '...')
"

# Test 2: Probar IA (si keys están bien)
python3 src/backend/ai/example_ai.py
```

---

## ❌ ERRORES COMUNES

### "API key not configured"
- **Causa**: No pusiste tu API key real
- **Solución**: Edita `.env` y cambia los placeholders

### "Invalid API key"
- **Causa**: API key incorrecta o expirada
- **Solución**: Ve a la plataforma y genera una nueva

### "ModuleNotFoundError: decouple"
- **Causa**: No instalaste dependencias
- **Solución**: `pip install python-decouple`

---

## 🎯 EJEMPLO COMPLETO

```bash
# 1. Editar .env
nano .env

# 2. Cambiar líneas 11 y 22
GLM46_API_KEY=sk-1234567890abcdef...
ANTHROPIC_AUTH_TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

# 3. Guardar y salir (Ctrl+X, Y, Enter en nano)

# 4. Probar
python3 src/backend/ai/example_ai.py
```

---

## 📞 SI NECESITAS AYUDA

### Ver .env actual:
```bash
cat .env | grep -E "GLM46_API_KEY|ANTHROPIC_AUTH_TOKEN"
```

### Verificar formato:
```bash
# Debe mostrar algo así (no los placeholders):
GLM46_API_KEY=sk-...
ANTHROPIC_AUTH_TOKEN=eyJ...
```

### Reiniciar:
Después de editar `.env`, reinicia cualquier terminal o ejecución.

---

## ✅ DESPUÉS DE CONFIGURAR

Una vez que tengas las API keys reales:

```bash
# Probar generación completa
python3 src/backend/als/example_usage.py

# Probar IA
python3 src/backend/ai/example_ai.py

# ¡Y abrir los .als en Ableton Live!
```

---

**¡Con las API keys configuradas ya puedes generar música con IA!** 🎵🤖