@danhachuel/thunderbolt 0.3.64 → 0.3.66

package/MANUAL-INSTALACAO.md

@@ -2,7 +2,7 @@
 
 Este manual descreve a instalação local da UI Thunderbolt, baseada no MoneyPrinterTurbo, utilizando o pacote npm `@danhachuel/thunderbolt`. O fluxo recomendado instala automaticamente o ambiente Python, as dependências da aplicação, as dependências do MoneyPrinterTurbo, o Streamlit e o suporte FFmpeg através de `imageio-ffmpeg`.
 
-> **Versão deste manual:** 0.3.64
+> **Versão deste manual:** 0.3.66
 > **Pacote npm:** `@danhachuel/thunderbolt`
 > **Porta padrão da UI:** `localhost:3030`  
 > **Repositório:** [github.com/DanHachuel/thunderbolt](https://github.com/DanHachuel/thunderbolt)
@@ -128,13 +128,13 @@ Execute:
 Windows PowerShell ou MobaXterm:
 
 ```powershell
-npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.64 install
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.66 install
 ```
 
 Linux/macOS:
 
 ```bash
-npx --yes --prefer-online @danhachuel/thunderbolt@0.3.64 install
+npx --yes --prefer-online @danhachuel/thunderbolt@0.3.66 install
 ```
 
 A instalação normal é **segura para actualizações**: preserva `storage`, Blueprints, Brandings, configurações e artefactos do utilizador. Remove apenas `.venv`, o clone técnico do MoneyPrinterTurbo e dependências que serão recriadas. Uma pasta antiga sem dados do utilizador, como `C:\Users\<utilizador>\AppData\Local\hermes` da tentativa incompleta, pode ser removida; uma pasta antiga que contenha Blueprints, Brandings ou storage é preservada e apenas avisada no terminal. Feche processos Python, Node, Streamlit e MobaXterm que estejam a usar as pastas antes de executar.
@@ -142,7 +142,7 @@ A instalação normal é **segura para actualizações**: preserva `storage`, Bl
 Se quiser apagar absolutamente tudo de forma intencional, use o comando destrutivo separado:
 
 ```powershell
-npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.64 install --purge-data
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.66 install --purge-data
 ```
 
 O parâmetro `--purge-data` apaga Blueprints, Brandings, configurações, storage e artefactos locais. Não o use numa actualização normal.
@@ -395,8 +395,12 @@ O expander **Imagem e Video** substitui o antigo bloco isolado da Nano Banana. O
 
 A área **Voz, TTS e música — Azure Speech, restantes serviços e Suno** está dividida em cartões independentes para **Azure Speech**, **ElevenLabs**, **SiliconFlow**, **MiniMax TTS**, **Chatterbox**, **Sonilo** e **Suno**. Cada cartão agrupa apenas as credenciais, parâmetros e diagnóstico do serviço correspondente. O Suno aparece num cartão próprio porque é uma integração de criação musical, enquanto os restantes providers são serviços de voz/TTS.
 
+Na subaba **Imagem e Video**, a lista **Provider de media** inclui **FAL AI, KIE AI, Agnes AI, Nano Banana, Replicate AI, Pollinations.ai, Hugging Face Inference API, InferencePort Proxy e HeyGen** para a rota Full IA. O cartão **HeyGen** pede a API key, o **Avatar ID** e, opcionalmente, o **Voice ID**; a opção **Provider activo**, **Pool Vídeo**, **Prioridade** e **Testar Chamada API** funcionam como nos restantes cartões. O teste HeyGen usa apenas `GET /v3/users/me` e não consome uma geração. Nano Banana e Hugging Face podem permanecer no catálogo sem serem seleccionados para vídeo quando o cartão não declara capacidade de vídeo.
+
 Na criação de vídeo, abra **Configurações de áudio** e escolha **Upload** em **Modo de narração**. Use **Ficheiro de narração** para seleccionar o áudio, clique em **Guardar áudio de narração** e confirme a pré-visualização. O Thunderbolt valida que o ficheiro existe antes de criar a tarefa e encaminha o caminho ao MoneyPrinterTurbo com `--custom-audio-file`; este argumento é necessário porque o motor não persiste automaticamente o caminho carregado. São aceites ficheiros `.mp3`, `.wav`, `.m4a`, `.aac`, `.flac` e `.ogg`, guardados no storage local em `voiceovers`.
 
+O selector **Voiceover Service** oferece **Azure Speech SDK V2** e **Azure TTS V1**. Quando existe **Azure Speech key + região**, a opção V2 é preferida e o worker marca internamente a voz com `-V2`, activando o SDK Azure Speech e evitando o stream `edge_tts`. Tarefas antigas que ainda tenham `Azure TTS V1` guardado também são migradas para V2 quando essas credenciais estão configuradas. Sem credenciais Azure, o V1 continua disponível como fallback sem key; nesse caso o timeout interno do stream passa a 90 segundos para tolerar scripts longos e redes lentas. Um erro de TTS identifica explicitamente **Azure Speech / edge_tts API**, a etapa **Narração TTS** e os providers envolvidos.
+
 As notificações novas são verificadas automaticamente na sessão activa e aparecem como pop-ups no canto inferior direito, mesmo quando está aberta outra página. O pop-up não marca o registo como lido: a aba **Notificações** continua a ser o centro persistente para consultar o histórico, gerir preferências e marcar eventos como lidos. Cada ID é apresentado no máximo uma vez por sessão do navegador.
 
 | Provider | Configuração mínima | Pool suportado |
@@ -524,7 +528,9 @@ Após iniciar a aplicação, valide o seguinte percurso:
 
 ## Configuração API — fontes de materiais
 
-A área **Configurações > Configuração API > API Keys** separa as credenciais de serviços da configuração de fontes. Abra a subaba **Fontes de materiais** e escolha a fonte que a pipeline deverá usar. Para **Pexels**, **Pixabay**, **Coverr**, **WaveSpeed AI**, **LoomLoom** ou **TwelveLabs**, cada linha **API Key** é mascarada. Clique em **Adicionar outra chave** para guardar várias credenciais da mesma fonte; por exemplo, duas chaves Pixabay e duas Pexels ficam em listas independentes.
+A área **Configurações > Configuração API > API Keys** separa as credenciais de serviços da configuração de fontes. Abra a subaba **Fontes de materiais** e escolha a fonte que a pipeline deverá usar.
+
+Para **Pexels**, **Pixabay**, **Coverr**, **WaveSpeed AI**, **LoomLoom** ou **TwelveLabs**, cada linha **API Key** é mascarada. Clique em **Adicionar outra chave** para guardar várias credenciais da mesma fonte; por exemplo, duas chaves Pixabay e duas Pexels ficam em listas independentes.
 
 Clique em **Guardar fonte e chaves** para persistir a fonte activa e as respectivas chaves no storage local. O Thunderbolt remove linhas vazias e duplicadas, mantém compatibilidade com instalações antigas que usavam campos separados e escreve arrays no `config.toml` do MoneyPrinterTurbo para permitir rotação interna. Ao seleccionar **Ficheiros locais**, nenhuma API key é necessária e os materiais são obtidos do storage local.
 
@@ -556,7 +562,7 @@ Ao abrir a página, o Thunderbolt não prepara dados públicos, não descarrega
 
 Os parâmetros da UI são número de clusters entre 2 e 10, suporte mínimo entre 0,01 e 0,50, país, engagement, intervalo de datas e tags, todos dentro da área principal da aba. O núcleo normaliza os dados, calcula engagement, aplica filtros, faz transformação logarítmica e standardização, executa K-Means e calcula itemsets/regras com FP-Growth. Não são apresentados resultados até ao primeiro clique em **Analisar Nichos**; o mesmo botão aplica alterações posteriores aos filtros. Os resultados são DataFrames de clusters, itemsets frequentes, regras de associação e dados analisados; o gráfico de dispersão é criado nativamente com Plotly.
 
-As dependências adicionais — `scikit-learn`, `mlxtend`, `plotly`, `seaborn`, `matplotlib` e `kagglehub` — são instaladas pelo procedimento normal de `npx`. Em instalações existentes, execute novamente `npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.64 install`; o instalador detecta e reutiliza o que já estiver válido.
+As dependências adicionais — `scikit-learn`, `mlxtend`, `plotly`, `seaborn`, `matplotlib` e `kagglehub` — são instaladas pelo procedimento normal de `npx`. Em instalações existentes, execute novamente `npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.66 install`; o instalador detecta e reutiliza o que já estiver válido.
 
 ### Niche Finder Apify
 

package/README.md

@@ -42,9 +42,11 @@ A migração é baseada no workflow público [AI Agents A-Z — episódio 35](ht
 
 Em **Pipeline Vídeos > Criação de Vídeos** e **Automação Youtube**, a opção **Pexels/Pixabay** usa a rota stock do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo): as keywords do roteiro são encaminhadas para a pesquisa da fonte seleccionada, os clips são descarregados e reutilizados localmente, e o motor faz a composição com MoviePy/FFmpeg, respeitando proporção, duração máxima, concatenação, transições, correspondência visual ao roteiro, narração, legendas e música de fundo. As API keys de Pexels e Pixabay são exportadas para o `config.toml` do motor e a fonte efectiva é encaminhada por tarefa, sem depender apenas da fonte global guardada nas configurações.
 
-A ordem persistida da criação é **Tema → Script → Título → Keywords opcional → Vídeo → Prompt Thumbnail em JSON → Thumbnail → Upload**. O vídeo é materializado antes do prompt e da imagem da thumbnail; uma falha posterior de thumbnail não invalida um MP4 já pronto. **Full IA** é uma rota separada e usa exclusivamente os cartões activos FAL AI, KIE AI e Agnes AI do pool de vídeo. **Apenas Música** não chama a pipeline de vídeo nem tenta gerar thumbnail: reutiliza o áudio local/Suno já descarregado e deixa-o pronto para a integração de upload musical.
+A ordem persistida da criação é **Tema → Script → Título → Keywords opcional → Vídeo → Prompt Thumbnail em JSON → Thumbnail → Upload**. O vídeo é materializado antes do prompt e da imagem da thumbnail; uma falha posterior de thumbnail não invalida um MP4 já pronto. **Full IA** é uma rota separada e usa o pool de vídeo configurável com **FAL AI, KIE AI, Agnes AI, Nano Banana, Replicate AI, Pollinations.ai, Hugging Face Inference API, InferencePort Proxy e HeyGen**, respeitando apenas cartões activos que declarem capacidade de vídeo. **Apenas Música** não chama a pipeline de vídeo nem tenta gerar thumbnail: reutiliza o áudio local/Suno já descarregado e deixa-o pronto para a integração de upload musical.
 
-Quando uma etapa falha, a tarefa, a notificação e a página **Configurações > Logs** guardam e mostram sempre a coluna **API/Provider**, o serviço, a rota e, quando aplicável, os campos de configuração em falta. No caso do MoneyPrinterTurbo, os marcadores `LLM_PROVIDER`, `MISSING` e `INVALID` são convertidos em attribution legível; por exemplo, um erro pode indicar simultaneamente **OpenAI / NVIDIA NIM API** e **Pexels API**, em vez de apresentar apenas a mensagem genérica de credenciais adicionais. O worker invoca o helper com `--` antes das flags MoneyPrinterTurbo, porque `mpt_agent.py` reserva esses argumentos para a CLI filha. Registos históricos sem metadata são identificados explicitamente como anteriores à attribution estruturada.
+Quando uma etapa falha, a tarefa, a notificação e a página **Configurações > Logs** guardam e mostram sempre a coluna **API/Provider**, o serviço, a rota e, quando aplicável, os campos de configuração em falta. No caso do MoneyPrinterTurbo, os marcadores `LLM_PROVIDER`, `MISSING` e `INVALID` são convertidos em attribution legível; por exemplo, um erro pode indicar simultaneamente **OpenAI / NVIDIA NIM API** e **Pexels API**, em vez de apresentar apenas a mensagem genérica de credenciais adicionais. Os timeouts `azure_tts_v1`/`edge_tts` são identificados como **Azure Speech / edge_tts API**. Quando há Azure Speech key e região, o worker encaminha a voz para o SDK Azure Speech V2; sem essas credenciais, o fallback edge_tts usa um timeout interno de 90 segundos. O worker invoca o helper com `--` antes das flags MoneyPrinterTurbo, porque `mpt_agent.py` reserva esses argumentos para a CLI filha. Registos históricos sem metadata são identificados explicitamente como anteriores à attribution estruturada.
+
+Na subaba **Configuração API > API Keys > Imagem e Video**, o selector **Provider de media** inclui a mesma lista do pool Full IA. O cartão **HeyGen** usa a API V3, apresenta os campos **Avatar ID** e **Voice ID**, valida a credencial com uma chamada read-only e participa no failover de vídeo quando estiver activo e configurado. Nano Banana e Hugging Face permanecem disponíveis no catálogo; a participação efectiva no pool de vídeo depende da capacidade declarada pelo cartão, para não encaminhar vídeo para um endpoint que apenas suporte imagem.
 
 ## Upload-Post — publicação para múltiplas plataformas
 
@@ -87,7 +89,7 @@ No topo da área principal da aplicação existe o menu nativo de idioma no padr
 
 A UI suporta os temas **Dark** e **Light** através do menu nativo de três pontos do Streamlit, no local original do toolbar. Não existe um selector Theme adicional dentro da página. A configuração distribuída em `.streamlit/config.toml` disponibiliza as variantes nomeadas **Dark** e **Light**, e o menu nativo continua responsável por alternar entre os modos, seguindo o padrão do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo). O CSS próprio do Thunderbolt usa cores semânticas, `currentColor` e `color-mix` para acompanhar o tema activo, sem alterar a posição nem a funcionalidade do toolbar, do botão Deploy e do menu principal.
 
-## Navegação da UI 0.3.64
+## Navegação da UI 0.3.66
 
 A barra lateral mantém os níveis principais, nesta ordem: **Início**, **Niche Finder**, **Pipeline**, **Pipeline TikTok**, **Automação**, **Edição**, **AI Influencers** e **Configurações**. **Pipeline Vídeos** é expansível e contém **Criação de Vídeos**, **Backlog Vídeos**, **Roteiros**, **Thumbnails** e **Upload**. **Pipeline Música** é expansível e contém **Criação de Músicas** e **Upload Música**. **Automação** também é expansível e contém **Automação Youtube**. **Edição** é expansível e contém **Limpador de Metadados**, **Cortes**, **Editor Python** e **Download Mídia**, nessa ordem. **AI Influencers** é expansível e contém **Personagens**, **Geração de Conteúdo IA**, **Redes Sociais**, **Tutorial Meta** e **Tutorial Supabase**, nessa ordem. A página Geração de Conteúdo IA divide-se em **Imagens**, **Vídeos** e **Motion Control**; a subaba Motion Control permanece vazia nesta release.
  **Niche Finder** é expansível e contém **Niche Finder Kaggle** e **Niche Finder Apify**. **Configurações** é expansível e contém **Canais Youtube**, **Blueprints Youtube**, **MCP**, **Contas Google**, **Notificações**, **Logs** e **Configuração API**, nessa ordem. O Início reúne o dashboard e as filas do Pipeline, sem botões de acções rápidas.

package/app/main.py

@@ -40,7 +40,7 @@ from hermes_ui.mcp import detect_local_service, install_skill_locally, load_inte
 from hermes_ui.mcp_server import server_status, start_server, stop_server
 from hermes_ui.material_sources import apply_material_source_cards_to_settings, ensure_material_source_cards, material_source_catalog, material_source_definition, new_material_card, normalize_material_card, selected_material_source
 from hermes_ui.llm_providers import LLM_CARDS_KEY, LLM_PROVIDER_CATALOG, apply_llm_cards_to_settings, ensure_llm_provider_cards, new_llm_card, normalize_llm_card, provider_definition, test_llm_provider_card, stamp_test_result
-from hermes_ui.media_providers import MEDIA_CARDS_KEY, MEDIA_IMAGE_ACTIVE_CARD_KEY, MEDIA_VIDEO_ACTIVE_CARD_KEY, apply_media_provider_cards_to_settings, ensure_media_provider_cards, media_cards_for_pool, media_provider_catalog, media_provider_definition, new_media_card, normalize_media_card
+from hermes_ui.media_providers import FULL_IA_VIDEO_PROVIDER_CODES, MEDIA_CARDS_KEY, MEDIA_IMAGE_ACTIVE_CARD_KEY, MEDIA_VIDEO_ACTIVE_CARD_KEY, apply_media_provider_cards_to_settings, ensure_media_provider_cards, media_cards_for_pool, media_provider_catalog, media_provider_definition, new_media_card, normalize_media_card
 from hermes_ui.music import list_music_files, materialize_suno_audio, request_suno_generation, store_music_file, store_voiceover_file
 from hermes_ui.media_downloader import AUDIO_FORMATS, VIDEO_CONTAINERS, VIDEO_QUALITY_OPTIONS, MediaDownloadError, build_download_options, clear_media_download_history, dependency_status, download_media, list_media_downloads, media_download_file
 from hermes_ui.notifications import clear_notifications, list_notifications, mark_all_notifications_read, mark_notification_read, notification_event_catalog, notification_preferences, record_notification, reconcile_persisted_notifications, save_notification_preferences, unread_notification_count
@@ -164,7 +164,7 @@ VIDEO_CONCATENATION_OPTIONS = ["Random Concatenation (Recommended)", "Sequential
 VIDEO_TRANSITION_OPTIONS = ["None", "Fade", "Dissolve"]
 VIDEO_ENCODER_OPTIONS = ["Default (Recommended)", "H.264", "H.265"]
 VOICEOVER_MODE_OPTIONS = ["Auto", "Upload", "None"]
-VOICEOVER_SERVICE_OPTIONS = ["Azure TTS V1"]
+VOICEOVER_SERVICE_OPTIONS = ["Azure Speech SDK V2", "Azure TTS V1"]
 VOICEOVER_VOLUME_OPTIONS = ["20%", "40%", "60%", "80%", "100%"]
 VOICEOVER_SPEED_OPTIONS = ["0.5x", "0.75x", "1.0x", "1.25x", "1.5x", "2.0x"]
 BACKGROUND_MUSIC_SOURCE_OPTIONS = ["Ficheiro existente", "Carregar ficheiro", "Criar via Suno API", "Random Background Music", "Sem música"]
@@ -1046,7 +1046,20 @@ def render_video_generation_settings(
                     if stored_voiceover_value and Path(stored_voiceover_value).is_file():
                         st.audio(stored_voiceover_value)
                         settings["voiceover_file"] = stored_voiceover_value
-                settings["voiceover_service"] = st.selectbox("Voiceover Service", VOICEOVER_SERVICE_OPTIONS, key=f"{prefix}_voiceover_service")
+                configured_voice_settings = read_json("settings.json", {})
+                configured_azure_voice = bool(
+                    str(configured_voice_settings.get("azure_speech_key") or "").strip()
+                    and str(configured_voice_settings.get("azure_speech_region") or "").strip()
+                )
+                voice_service_default = "Azure Speech SDK V2" if configured_azure_voice else "Azure TTS V1"
+                voice_service_index = VOICEOVER_SERVICE_OPTIONS.index(voice_service_default)
+                settings["voiceover_service"] = st.selectbox(
+                    "Voiceover Service",
+                    VOICEOVER_SERVICE_OPTIONS,
+                    index=voice_service_index,
+                    key=f"{prefix}_voiceover_service",
+                    help="Azure Speech SDK V2 usa a key/região configuradas e não depende do stream edge_tts. Azure TTS V1 usa edge_tts e pode funcionar sem key Azure.",
+                )
                 if channel is not None:
                     channel_id = str(channel.get("id") or channel.get("name") or "")
                     channel_voice = str(channel.get("default_voice") or channel.get("voice") or "").strip()
@@ -5381,7 +5394,8 @@ def render_media_provider_cards(settings: dict[str, Any], *, embedded: bool = Fa
         settings.update(migrated)
         write_json("settings.json", settings)
     with st.expander("Imagem e Video", expanded=False):
-        st.caption("Configure providers de imagem e vídeo em cartões independentes. O router usa apenas o pool correspondente e faz failover entre providers activos.")
+        full_ia_labels = ", ".join(media_provider_definition(code).label for code in FULL_IA_VIDEO_PROVIDER_CODES)
+        st.caption(f"Configure providers de imagem e vídeo em cartões independentes. O router usa apenas o pool correspondente e faz failover entre providers activos. Pool Full IA: {full_ia_labels}.")
         image_cards = [card for card in cards if card.get("supports_image")]
         video_cards = [card for card in cards if card.get("supports_video")]
         selector_cols = st.columns(3)

package/hermes_ui/api_key_tests.py

@@ -124,7 +124,9 @@ def test_media_provider_card(card: Mapping[str, Any]) -> dict[str, Any]:
         return _result("missing", "Complete a Base URL antes de testar.")
     if provider not in {"inferenceport", "ollama", "lmstudio"} and not api_key:
         return _missing("Introduza a API key/token antes de testar este provider.")
-    if not model and provider not in {"inferenceport", "cloudflare_workers_ai"}:
+    if provider == "heygen":
+        return _get(f"{base_url}/v3/users/me", headers={"X-Api-Key": api_key})
+    if not model and provider not in {"inferenceport", "cloudflare_workers_ai", "heygen"}:
         return _result("missing", "Complete o modelo antes de testar.")
     headers = {"Authorization": f"Bearer {api_key}"} if api_key else {}
     if provider == "cloudflare_workers_ai":

package/hermes_ui/media_generation.py

@@ -53,9 +53,13 @@ def _base_url(card: Mapping[str, Any]) -> str:
 
 def _headers(card: Mapping[str, Any], *, fal: bool = False) -> dict[str, str]:
     key = _api_key(card)
+    provider = str(card.get("provider") or "").strip().lower()
     headers = {"Content-Type": "application/json", "Accept": "application/json"}
     if key:
-        headers["Authorization"] = f"Key {key}" if fal else f"Bearer {key}"
+        if provider == "heygen":
+            headers["X-Api-Key"] = key
+        else:
+            headers["Authorization"] = f"Key {key}" if fal else f"Bearer {key}"
     return headers
 
 
@@ -347,6 +351,8 @@ def _video_endpoint(card: Mapping[str, Any]) -> str:
     definition = media_provider_definition(card.get("provider"))
     style = str(card.get("api_style") or definition.api_style)
     base = _base_url(card)
+    if style == "heygen":
+        return f"{base}/v3/videos"
     if style == "fal_queue":
         if not _model(card):
             raise MediaGenerationError("FAL AI requer o identificador da rota/modelo para gerar vídeo.")
@@ -374,6 +380,21 @@ def _video_request(card: dict[str, Any], prompt: str, image_url: str = "") -> An
     }
     if image_url:
         body["image_url"] = image_url
+    if style == "heygen":
+        avatar_id = str(card.get("avatar_id") or "").strip()
+        if not avatar_id:
+            raise MediaGenerationError("HeyGen requer Avatar ID no cartão de media para gerar vídeo.")
+        heygen_body: dict[str, Any] = {
+            "type": "avatar",
+            "avatar_id": avatar_id,
+            "script": body["prompt"],
+            "aspect_ratio": str(card.get("aspect_ratio") or INTERNAL_VIDEO_ASPECT_RATIO),
+            "output_format": "mp4",
+        }
+        voice_id = str(card.get("voice_id") or "").strip()
+        if voice_id:
+            heygen_body["voice_id"] = voice_id
+        return requests.post(endpoint, headers=_headers(card), json=heygen_body, timeout=180)
     if style == "fal_queue":
         body.pop("model", None)
         return requests.post(endpoint, headers=_headers(card, fal=True), json=body, timeout=180)
@@ -403,6 +424,14 @@ def _video_result(payload: Mapping[str, Any]) -> tuple[str, str]:
         if value:
             return "", value
     data = payload.get("data")
+    if isinstance(data, Mapping):
+        direct = str(data.get("video_url") or data.get("url") or "").strip()
+        if direct.startswith(("http://", "https://")):
+            return direct, ""
+        for key in ("video_id", "id", "request_id", "task_id", "job_id"):
+            value = str(data.get(key) or "").strip()
+            if value:
+                return "", value
     if isinstance(data, list) and data and isinstance(data[0], Mapping):
         first = data[0]
         direct = str(first.get("url") or first.get("video_url") or "").strip()
@@ -422,6 +451,8 @@ def _poll_video(card: Mapping[str, Any], request_id: str, *, attempts: int = 24,
         endpoint = f"{base}/requests/{request_id}/status"
     elif style == "replicate":
         endpoint = f"{base}/predictions/{request_id}"
+    elif style == "heygen":
+        endpoint = f"{base}/v3/videos/{request_id}"
     else:
         endpoint = f"{base}/videos/{request_id}"
     headers = _headers(card, fal=style == "fal_queue")
@@ -437,8 +468,14 @@ def _poll_video(card: Mapping[str, Any], request_id: str, *, attempts: int = 24,
         url, _ = _video_result(payload if isinstance(payload, Mapping) else {})
         if url:
             return url
-        status = str((payload or {}).get("status") or "").lower() if isinstance(payload, Mapping) else ""
+        status_payload = payload.get("data") if isinstance(payload, Mapping) and isinstance(payload.get("data"), Mapping) else payload
+        status = str((status_payload or {}).get("status") or "").lower() if isinstance(status_payload, Mapping) else ""
         if status in {"failed", "error", "cancelled", "canceled"}:
+            if style == "heygen" and isinstance(status_payload, Mapping):
+                code = str(status_payload.get("failure_code") or "").strip()
+                detail = str(status_payload.get("failure_message") or "").strip()
+                suffix = f" ({code})" if code else ""
+                raise ProviderCallError(f"HeyGen marcou a tarefa como falhada{suffix}: {detail or 'sem detalhe'}", category="provider", retryable=False)
             raise ProviderCallError("O provider marcou a tarefa de vídeo como falhada.", category="provider", retryable=False)
         if index + 1 < attempts:
             time.sleep(max(0.2, interval_seconds))
@@ -474,7 +511,7 @@ def generate_video_for_card(
         raise MediaGenerationError(f"O provider {provider} não devolveu URL nem identificador de vídeo.")
     destination = output_path or (STORAGE / "videos" / f"media-{provider}-{abs(hash((prompt, url))) & 0xffffffffffffffff:x}.mp4")
     try:
-        response = requests.get(url, headers={"Authorization": f"Bearer {_api_key(routed.card)}"} if _api_key(routed.card) else {}, timeout=300)
+        response = requests.get(url, headers=_headers(routed.card), timeout=300)
         response.raise_for_status()
     except requests.RequestException as exc:
         raise MediaGenerationError(f"Não foi possível descarregar o vídeo gerado: {exc}") from exc

package/hermes_ui/media_providers.py

@@ -12,6 +12,18 @@ MEDIA_VIDEO_ACTIVE_CARD_KEY = "media_video_active_card_id"
 MEDIA_IMAGE_ACTIVE_PROVIDER_KEY = "media_image_provider"
 MEDIA_VIDEO_ACTIVE_PROVIDER_KEY = "media_video_provider"
 
+FULL_IA_VIDEO_PROVIDER_CODES = (
+    "fal_ai",
+    "kie_ai",
+    "agnes",
+    "nano_banana",
+    "replicate",
+    "pollinations",
+    "huggingface",
+    "inferenceport",
+    "heygen",
+)
+
 # Mantidos internamente para preservar compatibilidade e controlar o prompt dos providers.
 INTERNAL_IMAGE_ASPECT_RATIO = "16:9"
 INTERNAL_IMAGE_SIZE = "1K"
@@ -55,7 +67,7 @@ MEDIA_PROVIDER_CATALOG: tuple[MediaProviderDefinition, ...] = (
     ),
     MediaProviderDefinition(
         "replicate",
-        "Replicate",
+        "Replicate AI",
         default_base_url="https://api.replicate.com/v1",
         supports_image=True,
         supports_video=True,
@@ -133,6 +145,15 @@ MEDIA_PROVIDER_CATALOG: tuple[MediaProviderDefinition, ...] = (
         api_style="fal_queue",
         description="Model APIs da FAL com queue, status e resultado.",
     ),
+    MediaProviderDefinition(
+        "heygen",
+        "HeyGen",
+        default_base_url="https://api.heygen.com",
+        supports_video=True,
+        api_style="heygen",
+        extra_fields=("avatar_id", "voice_id"),
+        description="Vídeos com avatar, script ou áudio pela API V3 da HeyGen.",
+    ),
 )
 
 _MEDIA_BY_CODE = {item.code: item for item in MEDIA_PROVIDER_CATALOG}

package/hermes_ui/pipeline_worker.py

@@ -19,7 +19,7 @@ from hermes_ui.script_generation import generate_script_document
 from hermes_ui.storage import STORAGE, ensure_storage, read_json, write_json
 from hermes_ui.llm_providers import active_llm_card, provider_definition
 from hermes_ui.media_generation import MediaGenerationError, _append_generation_constraints, generate_image_from_pool, generate_video_from_pool
-from hermes_ui.media_providers import media_cards_for_pool
+from hermes_ui.media_providers import FULL_IA_VIDEO_PROVIDER_CODES, media_cards_for_pool, media_provider_definition
 from hermes_ui.material_sources import material_api_keys, selected_material_source
 from hermes_ui.thumbnail_generation import ThumbnailGenerationError, generate_thumbnail_image
 
@@ -324,6 +324,16 @@ def _failure_attribution(
     provider_code = str(markers["helper_provider"] or "").strip().casefold()
     combined = f"{output} {error}".casefold()
 
+    if stage == "video" and any(marker in combined for marker in ("edge_tts", "edge tts", "azure_tts_v1", "azure speech")):
+        return {
+            "failure_api": "Azure Speech / edge_tts API",
+            "failure_provider": "azure_speech, edge_tts",
+            "failure_service": "Narração TTS",
+            "failure_route": route,
+            "failure_config_fields": "",
+            "failure_stage": stage,
+        }
+
     if stage == "video" and missing:
         api_labels: list[str] = []
         provider_values: list[str] = []
@@ -359,7 +369,10 @@ def _failure_attribution(
             "failure_stage": stage,
         }
     if stage == "video" and route == "full_ia":
-        providers = [("fal_ai", "FAL AI"), ("kie_ai", "KIE AI"), ("agnes", "Agnes AI")]
+        providers = [
+            (code, media_provider_definition(code).label)
+            for code in FULL_IA_VIDEO_PROVIDER_CODES
+        ]
         found = [label for code, label in providers if code in combined or label.casefold() in combined]
         labels = found or [label for _, label in providers]
         codes = [code for code, label in providers if label in labels] or [code for code, _ in providers]
@@ -567,7 +580,45 @@ def _mpt_video_language(value: Any) -> str:
     return raw if re.fullmatch(r"[A-Za-z]{2,3}(?:-[A-Za-z]{2,4})?", raw) else ""
 
 
-def _moneyprinter_cli_args(task: dict[str, Any], route: str) -> list[str]:
+def _uses_azure_speech_sdk_v2(
+    generation_settings: dict[str, Any],
+    settings: dict[str, Any] | None = None,
+) -> bool:
+    service = str(generation_settings.get("voiceover_service") or "").strip().casefold()
+    if service in {
+        "azure speech sdk v2",
+        "azure speech",
+        "azure tts v2",
+        "azure speech sdk",
+    }:
+        return True
+    if service in {"azure tts v1", "edge tts", "edge_tts"}:
+        configured = settings or {}
+        return bool(
+            str(configured.get("azure_speech_key") or "").strip()
+            and str(configured.get("azure_speech_region") or "").strip()
+        )
+    configured = settings or {}
+    return bool(
+        str(configured.get("azure_speech_key") or "").strip()
+        and str(configured.get("azure_speech_region") or "").strip()
+    )
+
+
+def _azure_speech_v2_voice_name(value: str) -> str:
+    """Mark a normal Azure voice for MPT's Azure Speech SDK V2 branch."""
+    voice = str(value or "").strip()
+    if not voice or ":" in voice or voice.casefold() == "no-voice":
+        return voice
+    if re.search(r"-v2(?:-|$)", voice, flags=re.IGNORECASE):
+        return voice
+    match = re.search(r"-(Female|Male)$", voice, flags=re.IGNORECASE)
+    if match:
+        return f"{voice[:match.start()]}-V2{voice[match.start():]}"
+    return f"{voice}-V2"
+
+
+def _moneyprinter_cli_args(task: dict[str, Any], route: str, settings: dict[str, Any] | None = None) -> list[str]:
     """Build the explicit MPT CLI contract for the stock Pexels/Pixabay route."""
     generation_settings = task.get("generation_settings") if isinstance(task.get("generation_settings"), dict) else {}
     args: list[str] = ["--video-source", route]
@@ -606,6 +657,8 @@ def _moneyprinter_cli_args(task: dict[str, Any], route: str) -> list[str]:
     if voice_mode == "none" or voice_mode == "upload":
         args.extend(["--voice-name", "no-voice"])
     elif voice:
+        if _uses_azure_speech_sdk_v2(generation_settings, settings):
+            voice = _azure_speech_v2_voice_name(voice)
         args.extend(["--voice-name", voice])
     volume = generation_settings.get("voiceover_volume")
     speed = generation_settings.get("voiceover_speed")
@@ -680,7 +733,24 @@ def _run_video_helper(task: dict[str, Any]) -> Path:
         command.extend(["--root", str(configured_root)])
     command.extend(["--subject", subject, "--"])
     generation_settings = task.get("generation_settings") if isinstance(task.get("generation_settings"), dict) else {}
-    command.extend(_moneyprinter_cli_args(task, route))
+    if _uses_azure_speech_sdk_v2(generation_settings, settings) and str(generation_settings.get("voiceover_mode") or "").strip().casefold() not in {"none", "upload"}:
+        missing_voice_config = [
+            field for field, value in (
+                ("azure_speech_key", settings.get("azure_speech_key")),
+                ("azure_speech_region", settings.get("azure_speech_region")),
+            ) if not str(value or "").strip()
+        ]
+        if missing_voice_config:
+            message = "Azure Speech SDK V2 foi seleccionado, mas faltam credenciais de voz."
+            metadata = _failure_attribution(task, settings, "video", error=message)
+            metadata.update({
+                "failure_api": "Azure Speech API",
+                "failure_provider": "azure_speech",
+                "failure_service": "Azure Speech SDK V2",
+                "failure_config_fields": ", ".join(missing_voice_config),
+            })
+            raise PipelineError(_failure_message(message, metadata), failure_metadata=metadata)
+    command.extend(_moneyprinter_cli_args(task, route, settings=settings))
     if str(generation_settings.get("voiceover_mode") or "").strip().casefold() == "upload":
         voiceover_file = Path(str(generation_settings.get("voiceover_file") or "").strip()).expanduser()
         if not str(voiceover_file) or not voiceover_file.is_file() or voiceover_file.stat().st_size <= 0:
@@ -993,7 +1063,7 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
                 video_path = generate_video_from_pool(
                     settings,
                     video_prompt,
-                    allowed_providers={"fal_ai", "kie_ai", "agnes"},
+                    allowed_providers=set(FULL_IA_VIDEO_PROVIDER_CODES),
                 )
             else:
                 video_path = _run_video_helper({
@@ -1006,7 +1076,7 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
                 })
         except MediaGenerationError as exc:
             if route == "full_ia":
-                message = f"Pool Full IA (FAL/KIE AI/Agnes AI): {exc}"
+                message = f"Pool Full IA (FAL AI/KIE AI/Agnes AI/Nano Banana/Replicate AI/Pollinations.ai/Hugging Face Inference API/InferencePort Proxy/HeyGen): {exc}"
             else:
                 message = f"Pipeline MoneyPrinterTurbo ({route}): {exc}"
             metadata = _failure_attribution(task, settings, "video", error=str(exc))

package/integrations/moneyprinter_config.py

@@ -116,6 +116,13 @@ def build_moneyprinter_config(settings: dict[str, Any], existing: dict[str, Any]
     for settings_key, config_key in app_map.items():
         if settings_key in settings:
             app[config_key] = settings[settings_key]
+    # Edge TTS V1 is retained as a keyless fallback, but its default 30-second
+    # stream deadline is too short for longer scripts or slow networks.
+    try:
+        edge_tts_timeout = float(settings.get("edge_tts_timeout", 90))
+    except (TypeError, ValueError):
+        edge_tts_timeout = 90.0
+    app["edge_tts_timeout"] = max(30, int(edge_tts_timeout))
     # A UI can store the canonical mapping while older installations still
     # expose one legacy field per source.  Export every supported source as a
     # TOML array so MoneyPrinterTurbo can rotate keys without CSV parsing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.3.64",
+  "version": "0.3.66",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "license": "MIT",
   "main": "scripts/cli.mjs",