@danhachuel/thunderbolt 0.3.65 → 0.3.67

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.65
+> **Versão deste manual:** 0.3.67
 > **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.65 install
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.67 install
 ```
 
 Linux/macOS:
 
 ```bash
-npx --yes --prefer-online @danhachuel/thunderbolt@0.3.65 install
+npx --yes --prefer-online @danhachuel/thunderbolt@0.3.67 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.65 install --purge-data
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.67 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,6 +395,14 @@ 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.
+
+### API Tiktok — várias aplicações
+
+Em **Configuração API > API Tiktok**, situada entre **Contas Google** e **Fontes de Materiais**, cada aplicação TikTok é configurada num card independente. O card contém exclusivamente **TikTok Client ID** e **TikTok Client Secret** e apresenta os botões **Testar chamada API**, **Guardar card** e **Apagar card**. Use **Adicionar nova API** no final da lista para criar outra aplicação sem substituir as anteriores.
+
+O botão de teste é read-only. Sem um token OAuth TikTok já autorizado, o Thunderbolt informa que é necessário concluir o Playground/autorização do TikTok for Developers, sem inventar um resultado nem enviar credenciais. O token e a autorização não são campos dos cards. Instalações que ainda tenham `tiktok_client_key` e `tiktok_client_secret` são migradas automaticamente para o primeiro card; o adapter usa o primeiro card completo e mantém fallback para os campos antigos.
+
 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.
@@ -526,7 +534,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.
 
@@ -558,7 +568,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.65 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.67 install`; o instalador detecta e reutiliza o que já estiver válido.
 
 ### Niche Finder Apify
 

package/README.md

@@ -25,7 +25,7 @@ A primeira versão implementa a camada UI independente com:
 | Edição | Menu expansível abaixo de Automação com Limpador de Metadados, Clip Generator local em Cortes e Editor Python inspirado no PYEdit para vídeos e scripts locais |
 | Upload | YouTube via `youtube-automation-agent` adaptado internamente, fallback ordenado API Oficial → Upload directo → Postiz, upload de MP4 para Postiz via API key/MCP configurável, TikTok, Instagram e Facebook Pages no front end |
 | MCP | Catálogo local opcional de Short Video Maker, AutoVio, OpenMontage e OpenCut, com portas editáveis e activação |
-| Configurações | **Contas Google**, **Configuração API** e **Notificações**; Notificações contém as subabas **Geral** e **Telegram Gateway**, com envio das mesmas operações locais para um Chat ID; API Keys divididas entre **Serviços e modelos** e **Fontes de materiais**, com várias chaves independentes por fonte, além de contas Google/YouTube por cartão, `INNERTUBE_API_KEY` global para todas as contas, providers, TTS, Nano Banana, Postiz, TikTok e Upload-Post |
+| Configurações | **Contas Google**, **Configuração API** e **Notificações**; Notificações contém as subabas **Geral** e **Telegram Gateway**, com envio das mesmas operações locais para um Chat ID; API Keys divididas entre **Serviços e modelos**, **API Tiktok** e **Fontes de materiais**, com várias chaves independentes por fonte, além de contas Google/YouTube por cartão, `INNERTUBE_API_KEY` global para todas as contas, providers, TTS, Nano Banana, Postiz, TikTok e Upload-Post |
 | Launcher | Execução via `npx`, instalação assistida, diagnóstico e preparação para distribuição |
 
 ## AI Influencers — personagens e geração de conteúdo
@@ -42,10 +42,18 @@ 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. 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.
+
+## API Tiktok — múltiplas aplicações TikTok
+
+A subaba **Configuração API > API Tiktok** fica entre **Contas Google** e **Fontes de Materiais**. Cada aplicação TikTok é apresentada num card separado e contém apenas **TikTok Client ID** e **TikTok Client Secret**, ambos guardados no storage local. O botão **Adicionar nova API** cria cards adicionais; cada card dispõe de **Guardar card**, **Testar chamada API** e **Apagar card**. A autorização OAuth, os scopes e os tokens de publicação continuam fora desta subaba, no fluxo próprio do TikTok for Developers.
+
+As credenciais antigas dos campos únicos `tiktok_client_key` e `tiktok_client_secret` são migradas automaticamente para o primeiro card sem serem eliminadas. Para compatibilidade com integrações existentes, o adapter TikTok utiliza o primeiro card completo e mantém fallback para os campos legados; a UI não altera os campos pedidos nem mistura Client ID/Secret com tokens, redirect URI ou scopes.
+
 ## Upload-Post — publicação para múltiplas plataformas
 
 A página **Upload** contém quatro subabas: **Upload convencional**, **Upload directo**, **Postiz** e **Upload-Post**. A quarta alternativa usa a API oficial do [Upload-Post](https://docs.upload-post.com/) para enviar um vídeo local para uma ou mais plataformas ligadas ao perfil configurado. Seleccione as plataformas na própria subaba, confirme o título e a descrição e clique em **Enviar vídeo pelo Upload-Post**.
@@ -87,7 +95,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.65
+## 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
@@ -4660,6 +4660,103 @@ def render_upload_conventional():
                 st.button("Preparar Facebook Pages", key=f"upload_facebook_{task['id']}", disabled=True, help="UI preparada; publicação Facebook Pages ainda não está activa.")
 
 
+def _normalise_tiktok_api_cards(settings: dict[str, Any]) -> tuple[list[dict[str, str]], bool]:
+    raw_cards = settings.get("tiktok_api_cards")
+    cards: list[dict[str, str]] = []
+    changed = not isinstance(raw_cards, list)
+    if isinstance(raw_cards, list):
+        for index, raw_card in enumerate(raw_cards):
+            if not isinstance(raw_card, dict):
+                changed = True
+                continue
+            card_id = str(raw_card.get("id") or f"tiktok-api-{index + 1}").strip()
+            client_id = str(raw_card.get("client_id") or raw_card.get("client_key") or "").strip()
+            client_secret = str(raw_card.get("client_secret") or "").strip()
+            normalised = {"id": card_id, "client_id": client_id, "client_secret": client_secret}
+            cards.append(normalised)
+            if normalised != {key: str(raw_card.get(key) or "").strip() for key in ("id", "client_id", "client_secret")}:
+                changed = True
+    if not cards:
+        legacy_client_id = str(settings.get("tiktok_client_key") or "").strip()
+        legacy_client_secret = str(settings.get("tiktok_client_secret") or "").strip()
+        if legacy_client_id or legacy_client_secret:
+            cards = [{"id": "tiktok-api-1", "client_id": legacy_client_id, "client_secret": legacy_client_secret}]
+            changed = True
+    if changed and cards:
+        settings["tiktok_api_cards"] = cards
+        write_json("settings.json", settings)
+    return cards, changed
+
+
+def _persist_tiktok_api_cards(settings: dict[str, Any], cards: list[dict[str, str]]) -> None:
+    clean_cards = [
+        {
+            "id": str(card.get("id") or f"tiktok-api-{index + 1}").strip(),
+            "client_id": str(card.get("client_id") or "").strip(),
+            "client_secret": str(card.get("client_secret") or "").strip(),
+        }
+        for index, card in enumerate(cards)
+    ]
+    settings["tiktok_api_cards"] = clean_cards
+    first = next((card for card in clean_cards if card["client_id"] and card["client_secret"]), clean_cards[0] if clean_cards else {"client_id": "", "client_secret": ""})
+    settings["tiktok_client_key"] = first["client_id"]
+    settings["tiktok_client_secret"] = first["client_secret"]
+    write_json("settings.json", settings)
+
+
+def render_tiktok_api_cards(settings: dict[str, Any]) -> None:
+    st.title("API Tiktok")
+    st.caption("Configure várias aplicações TikTok em cards separados. Cada card mantém apenas o TikTok Client ID e o TikTok Client Secret; autorização OAuth, scopes e tokens continuam a ser geridos no TikTok for Developers Playground.")
+    cards, _ = _normalise_tiktok_api_cards(settings)
+    if not cards:
+        st.info("Ainda não existe nenhuma API TikTok configurada. Use o botão abaixo para criar o primeiro card.")
+    for index, card in enumerate(cards):
+        card_id = str(card["id"])
+        with st.container(border=True):
+            header_cols = st.columns([3.2, 1.2])
+            with header_cols[0]:
+                st.subheader(f"API TikTok {index + 1}")
+            with header_cols[1]:
+                configured = bool(card["client_id"] and card["client_secret"])
+                _api_status_badge("Configured" if configured else "Missing configuration", "ready" if configured else "missing")
+            with st.form(f"tiktok_api_card_form_{card_id}"):
+                client_id = st.text_input("TikTok Client ID", value=card["client_id"], key=f"tiktok_api_{card_id}_client_id")
+                client_secret = st.text_input("TikTok Client Secret", value=card["client_secret"], type="password", key=f"tiktok_api_{card_id}_client_secret")
+                action_cols = st.columns(3)
+                with action_cols[0]:
+                    test_clicked = st.form_submit_button("Testar chamada API", use_container_width=True)
+                with action_cols[1]:
+                    save_clicked = st.form_submit_button("Guardar card", type="primary", use_container_width=True)
+                with action_cols[2]:
+                    delete_clicked = st.form_submit_button("Apagar card", use_container_width=True)
+            edited = {"id": card_id, "client_id": client_id.strip(), "client_secret": client_secret.strip()}
+            if test_clicked:
+                cards[index] = edited
+                _persist_tiktok_api_cards(settings, cards)
+                result = test_tiktok_credentials(edited["client_id"], edited["client_secret"], settings.get("tiktok_access_token", ""))
+                if result.get("status") == "success":
+                    st.success(result.get("message") or "Chamada TikTok concluída.")
+                elif result.get("status") == "unsupported":
+                    st.warning(result.get("message") or "Conclua a autorização TikTok antes do teste.")
+                else:
+                    st.error(result.get("message") or "A chamada TikTok falhou.")
+            elif save_clicked:
+                cards[index] = edited
+                _persist_tiktok_api_cards(settings, cards)
+                st.success("Card TikTok guardado.")
+                st.rerun()
+            elif delete_clicked:
+                cards = [item for item in cards if str(item.get("id")) != card_id]
+                _persist_tiktok_api_cards(settings, cards)
+                st.success("Card TikTok apagado.")
+                st.rerun()
+    if st.button("Adicionar nova API", type="primary", use_container_width=True, key="add_tiktok_api_card"):
+        cards.append({"id": f"tiktok-api-{uuid.uuid4().hex[:10]}", "client_id": "", "client_secret": ""})
+        _persist_tiktok_api_cards(settings, cards)
+        st.success("Novo card TikTok criado.")
+        st.rerun()
+
+
 def render_google_accounts():
     st.title("Contas Google")
     st.caption("Gestão das contas Google/YouTube, documentos de credenciais, canais em lote e credenciais globais do YouTube.")
@@ -5394,7 +5491,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)
@@ -5439,7 +5537,7 @@ def render_settings():
             key=f"settings_{key}",
         )
 
-    api_keys_tab, google_accounts_tab, material_sources_tab, ai_influencers_tab, voice_test_tab = render_localized_tabs(["API Keys", "Contas Google", "Fontes de Materiais", "AI Influencers", "Teste de Voz"])
+    api_keys_tab, google_accounts_tab, tiktok_api_tab, material_sources_tab, ai_influencers_tab, voice_test_tab = render_localized_tabs(["API Keys", "Contas Google", "API Tiktok", "Fontes de Materiais", "AI Influencers", "Teste de Voz"])
 
     with api_keys_tab:
         with st.container(border=True):
@@ -5590,18 +5688,6 @@ def render_settings():
                             widget_key="api_test_voice_suno",
                         )
 
-                with st.expander("TikTok for Developers — Client ID e Client Secret", expanded=False):
-                    st.caption("Apenas as credenciais da aplicação ficam nesta UI. Redirect URI, scopes, autorização e tokens são geridos no TikTok for Developers Playground.")
-                    tiktok_client_key = text_setting("TikTok Client ID", "tiktok_client_key", secret=True)
-                    _render_credential_status(tiktok_client_key)
-                    tiktok_client_secret = text_setting("TikTok Client Secret", "tiktok_client_secret", secret=True)
-                    _render_api_test_control(
-                        settings,
-                        "tiktok",
-                        lambda: test_tiktok_credentials(tiktok_client_key, tiktok_client_secret, settings.get("tiktok_access_token", "")),
-                        widget_key="api_test_tiktok",
-                    )
-
                 with st.expander("Publicação através do Upload-Post", expanded=False):
                     upload_post_enabled = st.checkbox("Activar Upload-Post", bool(settings.get("upload_post_enabled", False)))
                     upload_post_api_key = text_setting("Upload-Post API key", "upload_post_api_key", secret=True)
@@ -5650,7 +5736,6 @@ def render_settings():
                         "elevenlabs_api_key": elevenlabs_api_key, "elevenlabs_model_id": elevenlabs_model_id,
                         "chatterbox_base_url": chatterbox_base_url, "chatterbox_api_key": chatterbox_api_key, "chatterbox_model_id": chatterbox_model_id,
                         "sonilo_api_key": sonilo_api_key, "sonilo_base_url": sonilo_base_url, "suno_api_key": suno_api_key, "suno_api_base_url": suno_api_base_url, "suno_api_endpoint": suno_api_endpoint,
-                        "tiktok_client_key": tiktok_client_key, "tiktok_client_secret": tiktok_client_secret,
                         "upload_post_enabled": upload_post_enabled, "upload_post_api_key": upload_post_api_key,
                         "upload_post_username": upload_post_username, "upload_post_platforms": upload_post_platforms,
                         "upload_post_auto_upload": upload_post_auto_upload,
@@ -5670,6 +5755,9 @@ def render_settings():
     with google_accounts_tab:
         render_google_accounts()
 
+    with tiktok_api_tab:
+        render_tiktok_api_cards(settings)
+
     with material_sources_tab:
         render_material_source_api_keys(settings)
 

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/languages.py

@@ -114,7 +114,7 @@ _CORE_UI_TEXT_KEYS = (
     "Início", "Niche Finder", "Pipeline", "Pipeline TikTok", "Automação", "Edição", "AI Influencers", "Configurações",
     "Criação de Vídeos", "Criação de Músicas", "Roteiros", "Upload", "Prompts Master", "Contas TikTok", "Automação Youtube",
     "Niche Finder Kaggle", "Niche Finder Apify", "Limpador de Metadados", "Cortes", "Editor Python", "Download Mídia",
-    "Personagens", "Redes Sociais", "Tutorial Meta", "Tutorial Supabase", "Canais Youtube", "Blueprints Youtube", "MCP", "Contas Google",
+    "Personagens", "Redes Sociais", "Tutorial Meta", "Tutorial Supabase", "Canais Youtube", "Blueprints Youtube", "MCP", "Contas Google", "API Tiktok",
     "Configuração API", "Notificações", "Interface local para operação e automação de conteúdo faceless", "Canais", "activos",
     "Tarefas", "total registado", "A fazer", "na pipeline", "Em execução", "a decorrer", "Concluídos", "artefactos prontos",
     "Falhas", "requerem atenção", "Filas locais e dependências da cascata", "Niche", "Blueprints", "Brand", "Script", "Title",
@@ -153,6 +153,9 @@ UI_TRANSLATIONS: dict[str, dict[str, str]] = {
     },
 }
 
+for _translation in UI_TRANSLATIONS.values():
+    _translation.setdefault("API Tiktok", "API Tiktok")
+
 # Labels for the independent LLM provider cards.
 _LLM_TRANSLATIONS: dict[str, dict[str, str]] = {
     "pt": {

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
 
@@ -369,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]
@@ -1060,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({
@@ -1073,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/hermes_ui/storage.py

@@ -287,6 +287,7 @@ DEFAULTS: dict[str, Any] = {
         "postiz_auto_publish": False,
         "tiktok_client_key": "",
         "tiktok_client_secret": "",
+        "tiktok_api_cards": [],
         "tiktok_accounts": [],
         "tiktok_redirect_uri": "http://localhost:3030/oauth/tiktok/callback",
         "tiktok_scopes": "user.info.basic,video.publish,video.upload",

package/integrations/platforms.py

@@ -528,8 +528,18 @@ class YouTubeAdapter:
 
 class TikTokAdapter:
     def __init__(self, settings: dict[str, Any]):
-        self.client_key = settings.get("tiktok_client_key", "")
-        self.client_secret = settings.get("tiktok_client_secret", "")
+        cards = settings.get("tiktok_api_cards") if isinstance(settings.get("tiktok_api_cards"), list) else []
+        selected = next(
+            (
+                card for card in cards
+                if isinstance(card, dict)
+                and str(card.get("client_id") or card.get("client_key") or "").strip()
+                and str(card.get("client_secret") or "").strip()
+            ),
+            {},
+        )
+        self.client_key = str(selected.get("client_id") or selected.get("client_key") or settings.get("tiktok_client_key", "")).strip()
+        self.client_secret = str(selected.get("client_secret") or settings.get("tiktok_client_secret", "")).strip()
         # Redirect URI, scopes, OAuth e access token são geridos no TikTok for Developers Playground.
         # A UI guarda apenas as credenciais da aplicação.
         self.access_token = os.getenv("TIKTOK_ACCESS_TOKEN", "")

package/package.json

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