Package Information
Available Nodes
Documentation generating…
Documentation
Thais™ AI Content para n8n
n8n-nodes-thais-ai-content adiciona ao n8n um único nó, chamado Thais™ AI Content, que concentra a geração de imagem, vídeo, música e chat por modelo, além dos utilitários de catálogo, tarefas, créditos e arquivos.
Instalação
Em Settings → Community Nodes → Install, informe:
n8n-nodes-thais-ai-content
Credencial
A credencial Thais™ AI Content API já vem com os endereços preenchidos, de modo que normalmente basta informar a chave de API.
| Campo | Preenchimento |
|---|---|
| Chave de API | Informada por você e guardada pelo gerenciador de credenciais do n8n |
| URL Base da API | Já preenchida; altere apenas se usar um endereço próprio |
| URL Base de Upload | Já preenchida; usada somente pelas operações de arquivo |
Fluxo de uso
Os campos são dependentes entre si, e cada escolha restringe a próxima:
Tipo → Operação → Modelo → Modalidade de Saída → Parâmetros
O campo Tipo oferece Chat, Imagem, Música, Vídeo e Utilitários. Ao escolher Imagem, a lista de operações passa a exibir apenas transformações de imagem, como texto para imagem, imagem para imagem, editar imagem, ampliar imagem e separar camadas. Em seguida, o campo de modelo mostra somente os modelos daquela operação, e a modalidade de saída exibe apenas os retornos que o modelo selecionado suporta.
Parâmetros
O campo Parâmetros possui dois modos, e o exemplo de teste aparece apenas no segundo:
| Modo | Comportamento |
|---|---|
| Estruturado | Um campo próprio para cada parâmetro do modelo, com tipo correto, marcação de obrigatoriedade, limites numéricos e listas fechadas para os valores aceitos. As explicações do ícone de ajuda estão em português, enquanto os rótulos mantêm o nome técnico enviado à API. |
| JSON Personalizado | Editor JSON já preenchido com o exemplo completo do modelo, útil quando o payload é montado por expressão. |
Nos modelos com especificação oficial disponível, os dois modos apresentam exatamente os mesmos campos, de modo que o exemplo em JSON reflete integralmente o contrato do modelo. Modelos ainda sem campos estruturados permanecem utilizáveis pelo modo JSON Personalizado, e a listagem de modelos indica quais já possuem campos individuais.
Exemplo de automação por expressão:
{
"prompt": "={{ $json.descricao }}",
"aspect_ratio": "={{ $json.formato || '1:1' }}"
}
Callback e espera
Em Adicionar Opção você informa o Callback/Webhook URL, enviado como callBackUrl na criação da tarefa, e ajusta o intervalo inicial e o tempo máximo de espera. Com Aguardar Conclusão ativo, o nó consulta o status com intervalo progressivo até sucesso, falha ou tempo limite; desativado, devolve imediatamente o identificador da tarefa para consulta posterior.
O acompanhamento reconhece os estados waiting, queuing, generating, success e fail, e a leitura tolera variações de envelope entre modelos. Quando a tarefa falha, o nó interrompe a execução informando o código e a mensagem de falha; quando o tempo máximo é atingido, informa o último estado observado e sugere aumentar o limite, desativar a espera ou usar callback. Para gerações longas, a própria API recomenda o uso de callback em lugar de consultas repetidas, e as URLs geradas expiram em cerca de 24 horas, de modo que convém baixar os arquivos logo após a conclusão.
Utilitários
Selecionando o tipo Utilitários, o mesmo nó oferece as operações auxiliares:
| Operação | Retorno |
|---|---|
| Listar Modelos | Catálogo com tipo, operação, modelo, modalidades, campos obrigatórios e exemplo de payload |
| Obter Detalhe da Tarefa | Estado, progresso, parâmetros enviados, resultado, URLs geradas, créditos consumidos e falhas |
| Consultar Créditos | Saldo disponível na conta |
| Gerar Link de Download | Link temporário para um arquivo já gerado |
| Enviar Por URL | Importa um arquivo a partir de uma URL pública |
| Enviar Arquivo Binário | Envia o binário recebido do nó anterior |
| Enviar Base64 | Envia conteúdo em Base64 ou data URL |
As operações de upload retornam file_id, file_url, download_url e a expiração, permitindo encadear o resultado diretamente nos campos de URL dos modelos.
Saída
Cada execução devolve tipo, operação, modelo, modalidade de saída, modo de parâmetros, payload efetivamente enviado, identificador da tarefa, motivo de parada, resultado selecionado e resposta completa. Campos com nomes compatíveis com credenciais, como authorization, api_key, token, secret e password, são removidos da saída.
Desenvolvimento
npm install
npm run build
npx tsc --noEmit
npm run lint
node tests/verify-node.js
node tests/test-execution.js
O arquivo tests/test-execution.js sobe um servidor local que reproduz o contrato da API e valida o ciclo completo de criação, acompanhamento, conclusão, falha, tempo limite e envio de callback.
A estrutura segue o modelo oficial de nós comunitários do n8n em TypeScript. Consulte a documentação oficial para detalhes.
Licença
MIT.