Package Information
Available Nodes
Documentation generating…
Documentation
Thais Content K Models para n8n
n8n-nodes-thais-content-k-models é um pacote de nó comunitário para automatizar criação e transformação de conteúdo no n8n. Todo o uso acontece em um único nó, chamado Thais Conteúdo, que concentra imagem, vídeo, música, chat e os utilitários de catálogo, tarefas, créditos e arquivos.
A credencial armazena apenas as URLs base HTTPS e a chave de API. Nenhuma chave, senha de banco de dados ou dado interno é incluído neste pacote.
Instalação
No n8n, abra Settings → Community Nodes, escolha Install e informe:
n8n-nodes-thais-content-k-models
Credencial
A credencial Thais Content K Models API solicita três valores:
| Campo | Uso |
|---|---|
| Chave de API | Autenticação Bearer em todas as chamadas |
| URL Base da API | Endpoint de criação e consulta de tarefas |
| URL Base de Upload | Endpoint do serviço de arquivos, que roda em infraestrutura separada |
Fluxo de uso
O nó organiza os campos em uma hierarquia dependente, na qual cada escolha restringe a seguinte:
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ção passa a exibir somente operações de imagem, como texto para imagem, imagem para imagem, editar imagem, ampliar imagem e separar camadas. Em seguida, Modelo mostra apenas os modelos compatíveis com aquela operação, e Modalidade de Saída mostra apenas os retornos que o modelo selecionado suporta.
Parâmetros
O campo Parâmetros oferece dois modos complementares:
| Modo | Comportamento |
|---|---|
| Estruturado | Exibe um campo próprio para cada parâmetro do modelo escolhido, com tipo correto, marcação de obrigatoriedade, limites numéricos e dropdowns com os valores aceitos. Por exemplo, aspect_ratio e resolution aparecem como listas fechadas, e voice, nos modelos de fala, aparece como lista de vozes disponíveis. |
| JSON Personalizado | Exibe um editor JSON já preenchido com o exemplo executável daquele modelo, útil quando o payload é montado dinamicamente por expressão. |
Os campos do modo Estruturado são gerados a partir da especificação oficial de cada modelo, de forma que os nomes enviados correspondem exatamente ao contrato esperado. Modelos que ainda não possuem campos estruturados permanecem plenamente utilizáveis pelo modo JSON Personalizado, e a própria lista de modelos indica quais já contam com campos individuais.
Exemplo de automação por expressão no modo JSON Personalizado:
{
"prompt": "={{ $json.descricao }}",
"aspect_ratio": "={{ $json.formato || '1:1' }}"
}
Callback e espera
Em Adicionar Opção é possível informar o Callback/Webhook URL, enviado como callBackUrl na criação da tarefa, além de ajustar 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 tratamento assíncrono.
Utilitários
Ao selecionar 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, com filtro por tipo e por disponibilidade de modo estruturado |
| Obter Detalhe da Tarefa | Estado, progresso, parâmetros enviados, resultado, URLs geradas, créditos consumidos e mensagens de falha |
| 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 de geraçã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-unified.js
A estrutura segue o modelo oficial de nós comunitários do n8n em TypeScript. Consulte a documentação oficial para detalhes: n8n — Criar nós customizados.
Licença
MIT.