fix: document OpenRouter multi-account keys in .env.example, remove duplicate openrouter_rotation_new.py

- .env.example: add gitakira/sandeobras/softedge/joselena/fugakusayo OpenRouter account keys documentation
- Remove duplicate modules/openrouter_rotation_new.py (not imported anywhere; openrouter_rotation.py is the canonical version)
- modules/api.py (already committed): _setup_openrouter now uses rotation system for key+account name, _call_openrouter updates client API key from rotation, 429 handler rotates to next account and retries, model fallback changed from tencent/hy3-preview:free to deepseek/deepseek-chat

.env.example

@@ -27,6 +27,16 @@ TOGETHER_API_KEY=sua_chave_aqui
 # Limite: Ilimitado com rate limit
 HF_API_KEY=hf_sua_chave_aqui
 
+# OPENROUTER (https://openrouter.ai/keys)
+# Limite: ~1k requests/dia grátis por conta
+# Use 5 contas distintas para rotação automática (evita 429)
+OPENROUTER_API_KEY=sua_chave_aqui
+gitakira_openrouter_api=sk-or-v1-...
+sandeobras_openrouter_api=sk-or-v1-...
+softedge_openrouter_api=sk-or-v1-...
+joselena_openrouter_api=sk-or-v1-...
+fugakusayo_openrouter_api=sk-or-v1-...
+
 # ============================================================================
 # 🌐 CONFIGURAÇÕES DE SERVIDOR (OPCIONAL)
 # ============================================================================

modules/openrouter_rotation_new.py

@@ -1,253 +0,0 @@
-# type: ignore
-"""
-================================================================================
-OPENROUTER MULTI-ACCOUNT ROTATION SYSTEM
-================================================================================
-Rotação automática entre 5 contas OpenRouter para evitar rate limit (429).
-
-Contas Nomeadas:
-1. gitakira (conta 1)
-2. sandeobras (conta 2)
-3. softedge (conta 3)
-4. joselena (conta 4)
-5. fugakusayo (conta 5)
-
-Filosofia:
-- Detecta erro 429 (rate limit exceeded)
-- Automaticamente muda para próxima chave (com fallback na primeira)
-- Sem interrupção para o utilizador
-- Log detalhado de qual conta está sendo usada
-
-Cada conta tem tier free com limite diário:
-- ~1000 requests/dia
-- 5 contas = ~5000 requests/dia antes de precisar esperar 24h
-================================================================================
-"""
-
-import os
-import time
-from typing import List, Optional, Dict, Any
-from dataclasses import dataclass, field
-from datetime import datetime, timedelta
-from loguru import logger
-
-
-# Nomes das 5 contas OpenRouter (mapeado por índice)
-ACCOUNT_NAMES = [
-    "gitakira",      # 0 - Conta 1
-    "sandeobras",    # 1 - Conta 2
-    "softedge",      # 2 - Conta 3
-    "joselena",      # 3 - Conta 4
-    "fugakusayo",    # 4 - Conta 5
-]
-
-
-@dataclass
-class AccountQuota:
-    """Quota info para uma conta OpenRouter"""
-    key_index: int
-    account_name: str  # Nome da conta para identificação
-    api_key: str
-    last_429_time: Optional[float] = None
-    requests_today: int = 0
-    last_reset: float = field(default_factory=time.time)
-    is_exhausted: bool = False
-
-
-class OpenRouterAccountRotation:
-    """
-    Gerencia rotação de 5 contas OpenRouter.
-    Detecta 429 e muda automaticamente para próxima chave.
-    Fallback na primeira conta quando chega na última.
-    """
-    
-    def __init__(self, api_keys: List[str]):
-        """
-        Inicializa sistema de rotação.
-        
-        Args:
-            api_keys: Lista de 5 chaves OpenRouter (pode incluir strings vazias)
-        """
-        self.api_keys = [k.strip() for k in api_keys if k and k.strip()]
-        self.current_key_index = 0
-        self.accounts: Dict[int, AccountQuota] = {}
-        
-        # Inicializa quota para cada chave com nome associado
-        for i, key in enumerate(self.api_keys):
-            account_name = ACCOUNT_NAMES[i] if i < len(ACCOUNT_NAMES) else f"account_{i}"
-            self.accounts[i] = AccountQuota(
-                key_index=i,
-                account_name=account_name,
-                api_key=key,
-                requests_today=0
-            )
-        
-        self.logger = logger
-        self._log_initialization()
-    
-    def _log_initialization(self):
-        """Log status inicial com nomes das contas"""
-        active_keys = len(self.api_keys)
-        self.logger.success(f"✅ OpenRouter Rotation inicializado com {active_keys} contas:")
-        for i, quota in self.accounts.items():
-            status = "✅ ATIVA" if quota.api_key else "❌ VAZIA"
-            self.logger.info(f"  [{i+1}] {quota.account_name.upper():<15} {status}")
-        
-        if active_keys < 5:
-            self.logger.warning(f"⚠️ Apenas {active_keys}/5 contas configuradas")
-    
-    def get_current_key(self) -> Optional[str]:
-        """Retorna chave OpenRouter atual"""
-        if not self.api_keys or self.current_key_index >= len(self.api_keys):
-            return None
-        return self.api_keys[self.current_key_index]
-    
-    def get_current_account_name(self) -> str:
-        """Retorna nome da conta atual"""
-        if self.current_key_index < len(ACCOUNT_NAMES):
-            return ACCOUNT_NAMES[self.current_key_index]
-        return f"account_{self.current_key_index}"
-    
-    def get_current_key_index(self) -> int:
-        """Retorna índice da chave atual (0-4)"""
-        return self.current_key_index
-    
-    def handle_429_error(self) -> bool:
-        """
-        Lida com erro 429 (rate limit exceeded).
-        Muda para próxima chave se disponível (fallback na primeira).
-        
-        Returns:
-            True se mudou para nova chave
-            False se nenhuma chave disponível
-        """
-        # Marca conta atual como esgotada temporariamente
-        quota = self.accounts[self.current_key_index]
-        quota.last_429_time = time.time()
-        quota.is_exhausted = True
-        
-        account_name = quota.account_name.upper()
-        self.logger.warning(
-            f"⚠️ [429 RATE LIMIT] Conta '{account_name}' (índice {self.current_key_index + 1}/5) esgotada. "
-            f"Procurando próxima..."
-        )
-        
-        # Tenta encontrar próxima chave disponível
-        original_index = self.current_key_index
-        for _ in range(len(self.api_keys)):
-            # Move para próxima conta (com fallback na primeira)
-            self.current_key_index = (self.current_key_index + 1) % len(self.api_keys)
-            next_quota = self.accounts[self.current_key_index]
-            
-            if not next_quota.is_exhausted:
-                next_account_name = next_quota.account_name.upper()
-                self.logger.success(
-                    f"✅ [429 RECOVERY] Mudando de '{account_name}' para '{next_account_name}' "
-                    f"(índice {self.current_key_index + 1}/5)"
-                )
-                return True
-            
-            # Se chegou na última e vai voltar na primeira
-            if self.current_key_index == 0 and original_index > 0:
-                self.logger.info(
-                    f"🔄 [429 ROTATION CYCLE] Completado ciclo de contas. "
-                    f"Voltando na primeira: '{ACCOUNT_NAMES[0].upper()}'"
-                )
-        
-        # Todas esgotadas, mas podemos tentar a original após 1 segundo
-        self.logger.error(
-            f"❌ [429 CRITICAL] Todas as {len(self.api_keys)} contas esgotadas! "
-            f"Contas: {', '.join([self.accounts[i].account_name.upper() for i in self.accounts])}"
-        )
-        return False
-    
-    def reset_quotas_if_needed(self):
-        """
-        Reseta quotas se passaram 24 horas.
-        Chamado periodicamente para permitir reutilização de contas.
-        """
-        now = time.time()
-        reset_count = 0
-        for quota in self.accounts.values():
-            hours_since_reset = (now - quota.last_reset) / 3600
-            if hours_since_reset >= 24:
-                quota.requests_today = 0
-                quota.is_exhausted = False
-                quota.last_reset = now
-                reset_count += 1
-                self.logger.info(
-                    f"🔄 [QUOTA RESET] Conta '{quota.account_name.upper()}' resetada (24h passaram)"
-                )
-        if reset_count > 0:
-            self.logger.success(f"✅ {reset_count} conta(s) resetada(s) e disponível(is)")
-    
-    def record_request(self):
-        """Registra uma request para quota tracking"""
-        self.accounts[self.current_key_index].requests_today += 1
-    
-    def get_status(self) -> Dict[str, Any]:
-        """Retorna status atual de todas as contas"""
-        status = {
-            "current_account": self.get_current_account_name(),
-            "current_index": self.current_key_index,
-            "total_accounts": len(self.api_keys),
-            "accounts": []
-        }
-        
-        for i, quota in self.accounts.items():
-            status["accounts"].append({
-                "index": i + 1,  # 1-indexed para display
-                "name": quota.account_name.upper(),
-                "requests_today": quota.requests_today,
-                "exhausted": quota.is_exhausted,
-                "last_429": quota.last_429_time,
-            })
-        
-        return status
-    
-    def print_status(self):
-        """Printa status de quota para logging"""
-        status = self.get_status()
-        current_name = status['current_account'].upper()
-        self.logger.info(
-            f"📊 [QUOTA STATUS] Conta atual: {current_name} "
-            f"(índice {status['current_index'] + 1}/{status['total_accounts']})"
-        )
-        
-        for account_info in status["accounts"]:
-            status_icon = "❌ ESGOTADA" if account_info["exhausted"] else "✅ OK"
-            self.logger.info(
-                f"  [{account_info['index']}] {account_info['name']:<15} "
-                f"{account_info['requests_today']:>5} requests - {status_icon}"
-            )
-
-
-# Singleton instance
-_ROTATION_INSTANCE: Optional[OpenRouterAccountRotation] = None
-
-
-def get_openrouter_rotation() -> OpenRouterAccountRotation:
-    """Get singleton OpenRouter rotation instance"""
-    global _ROTATION_INSTANCE
-    if _ROTATION_INSTANCE is None:
-        from . import config
-        
-        # Carrega 5 chaves nomeadas do config
-        # Nomes: gitakira_openrouter_api, sandeobras_openrouter_api, etc
-        keys = [
-            getattr(config, "GITAKIRA_OPENROUTER_API", ""),
-            getattr(config, "SANDEOBRAS_OPENROUTER_API", ""),
-            getattr(config, "SOFTEDGE_OPENROUTER_API", ""),
-            getattr(config, "JOSELENA_OPENROUTER_API", ""),
-            getattr(config, "FUGAKUSAYO_OPENROUTER_API", ""),
-        ]
-        
-        _ROTATION_INSTANCE = OpenRouterAccountRotation(keys)
-    
-    return _ROTATION_INSTANCE
-
-
-def reset_rotation_instance():
-    """Reset singleton (para testes)"""
-    global _ROTATION_INSTANCE
-    _ROTATION_INSTANCE = None