QANode Logo

Nó Arquivo para Base64

O nó Arquivo para Base64 recebe um fileRef e devolve o conteúdo do arquivo em Base64 e Data URI.


Visão Geral

PropriedadeValor
Tipofile-to-base64
CategoriaArquivos
Cor🟤 Dourado (#C89F65)
Entradain
Saídaout

Quando Usar

Use este nó quando:

  • uma API exige arquivo em Base64;
  • você precisa montar payload JSON com arquivo embutido;
  • um sistema externo espera Data URI;
  • você precisa registrar ou comparar o conteúdo codificado.

Quando a API aceita upload multipart ou binário, normalmente é melhor enviar o fileRef diretamente pelo nó HTTP Request, sem converter para Base64.


Configuração

CampoTipoDescrição
ArquivofileRefArquivo de entrada

Outputs

OutputTipoDescrição
base64stringConteúdo Base64 puro
dataUristringConteúdo no formato data:mime/type;base64,...
namestringNome do arquivo
mimeTypestringMIME type
sizeBytesnumberTamanho em bytes
fileReffileRefReferência original do arquivo

Acessando os outputs

{{ steps["file-to-base64"].outputs.base64 }}
{{ steps["file-to-base64"].outputs.dataUri }}

Exemplo: Enviar Base64 em JSON

[Gerar Arquivo] → [Arquivo para Base64] → [HTTP Request]

No HTTP Request:

{
  "fileName": "{{ steps["file-to-base64"].outputs.name }}",
  "mimeType": "{{ steps["file-to-base64"].outputs.mimeType }}",
  "content": "{{ steps["file-to-base64"].outputs.base64 }}"
}

Dicas

  • Use dataUri quando o destino espera o prefixo data:mime/type;base64,.
  • Use base64 quando o destino espera apenas o conteúdo codificado.
  • Evite converter arquivos grandes para Base64 sem necessidade, pois o texto fica maior que o arquivo original.
  • Para uploads comuns, prefira fileRef direto no nó que aceita arquivo.