NodaroAccount
Docs do Nodaro
DocumentaçãoReferência de nósModelosTemplatesAgentes de IA (MCP)DesenvolvedoresAuto-hospedagemPesquisaComparações
Referência das ferramentas

Imagem

Gere, transforme, edite, componha e descreva imagens e crie máscaras num assistente de IA com as ferramentas do Nodaro: parâmetros, padrões e créditos.

As ferramentas de imagem permitem que um assistente crie e altere imagens no Nodaro. Com elas, ele pode gerar a partir de um prompt, transformar ou editar uma imagem existente, recortar uma máscara, compor várias imagens ou camadas e descrever o que uma imagem mostra. Cada ferramenta, exceto suggest_overlay_placement, save_image_defaults e as de paletas e de painéis de inspiração, inicia uma tarefa e retorna o ID dela, e o resultado é salvo na sua biblioteca. Todas as ferramentas de imagem, exceto as de paletas e de painéis de inspiração, precisam da permissão workflows:execute.

FerramentaO que fazCréditos
generate_imageTexto para imagem, com referências e inpainting opcionalO preço do modelo
modify_imageEdita, muda o estilo e transforma uma imagem existenteO preço do modelo
image_to_imageImagem para imagem guiada por prompt, com máscaras e várias referênciasO preço do modelo
edit_imageUpscale, remoção de fundo e edições pontuaisO preço da operação
split_into_layersUma imagem dividida em uma imagem base e camadas transparentesPor imagem devolvida
generate_maskUma máscara em preto e branco do que você descrever55
image_collageDe 2 a 30 imagens numa única imagem grande22 em 2K, 44 em 4K
image_overlayLogos, textos, QR codes e formas posicionados numa imagem, sem IA11, mais com tamanhos extras
suggest_overlay_placementOnde um logo ou um texto deve ficar numa imagemUma descrição de imagem
image_to_textUma descrição ou uma resposta sobre uma imagemCobrada pelos tokens usados, pela tarifa do modelo
save_image_defaultsO seu modelo e as suas configurações de imagem padrãoGrátis
list_palettes, save_paletteAs suas próprias paletas de cores, para orientar generate_imageGrátis
list_moodboards, save_moodboardOs seus próprios painéis de inspiração, para orientar generate_imageGrátis

generate_image

Cria uma imagem a partir de um prompt de texto com um dos modelos de imagem do Nodaro. É a ferramenta por trás de pedidos como “faça uma imagem de…”, e funciona como o nó Gerar imagem.

Permissão: workflows:execute. Créditos: o preço do modelo na resolução ou na qualidade escolhida.

ParâmetroTipoObservações
promptstringA descrição da imagem, com até 4.000 caracteres. Obrigatório, a menos que uma predefinição o forneça.
modelstringO ID do modelo. Padrão: gpt-image-2. Um ID desconhecido volta ao padrão. Veja list_models.
aspect_ratiostringPor exemplo 16:9, 9:16, 1:1, 4:3, 3:4 ou 21:9. Padrão: 16:9. Formas como 16x9 são aceitas, e uma proporção que o modelo não aceita é trocada por uma que ele aceita. auto mantém o formato da sua foto em todos os modelos: base_image_url, quando definida; caso contrário, a primeira imagem de referência. Um modelo cuja própria configuração auto mantém o formato a recebe. Qualquer outro modelo usa a proporção aceita mais próxima dessa foto, e o GPT Image 2.6 também, porque o auto dele renderiza um quadrado em retrato. Sem foto, auto resulta no auto do próprio modelo, quando ele tem um; caso contrário, em 16:9, quando o modelo a lista; e, se não, na primeira proporção listada do modelo.
resolutionstring1K, 2K ou 4K, nos modelos compatíveis. É usado o valor compatível mais próximo.
qualitystringOs níveis de qualidade que o modelo lista em list_models, nos modelos que têm configuração de qualidade. Com auto, a execução é cobrada pela imagem que realmente fez, e nunca mais do que o preço de max.
backgroundstringauto, opaque ou transparent, nos modelos que o listam. No GPT Image, um fundo transparente é renderizado em 1K.
output_formatstringO formato do arquivo: png (padrão), jpeg, webp, gif ou svg no GPT Image 2.6 Flare e Sunburst, e png ou jpeg no MiniMax H3 Image, no Seedream 5.5 e no FLUX 3 Klein. Veja Formato de saída.
gif_frames, gif_frame_duration_ms, svg_levelAs configurações de GIF e SVG de output_format.
negative_promptstringO que evitar, com até 2.000 caracteres.
reference_image_urlsarrayAté 14 imagens de referência, como URLs ou IDs do Nodaro, para manter uma pessoa, um personagem, um produto ou um estilo. Um modelo com um limite de imagens próprio aceita 16 no GPT Image 2.6 Flare e Sunburst ou no MiniMax H3 Image, e 10 no Seedream 5.5 ou no FLUX 3 Klein, contando a base_image_url. Nesses modelos, todas as imagens são repassadas, e uma chamada acima do limite é recusada antes de qualquer cobrança, com uma mensagem que diz quantas remover. A resposta confirma quantas foram anexadas.
countintegerDe 1 a 4 imagens por modelo. Cada imagem é uma tarefa própria.
modelsarrayDe 2 a 4 IDs de modelos de imagem, no lugar de model. A mesma requisição roda em cada modelo.
presetIdstringUma predefinição de list_node_presets, aplicada como o editor a aplica. Os campos que você informa a substituem. Veja Aplicar uma predefinição.
variablesobjectValores para os marcadores de uma predefinição que não têm padrão, por exemplo { "BRAND": "Acme" }.
palette_idstringUma paleta de list_palettes. As cores dela são citadas no prompt.
moodboard_idstringUm painel de inspiração de list_moodboards. A descrição dele entra no prompt, e as imagens dele vão para o modelo como referências de estilo.
subjectobjectQuem está na tomada, como IDs de catálogo: { field: id } ou { field: [ids] }. Os campos são os campos de pessoa e de figurino, heldProp, material e animal, de get_picker_catalog.
structuredobjectDetalhes estruturados adicionados ao prompt: person (idade, gênero, expressão, olhos, cabelo, profissão), styling (estética, look de cor, iluminação, clima), setting (atmosfera, fundo, época), camera (formato, enquadramento, movimento), lens (abertura, distância focal) e mood.
described_referencesarrayAté 10 itens { name, description } para um assunto que você consegue nomear, mas do qual não tem imagem. Cada item vira uma linha do prompt, para que o nome no seu prompt chegue ao modelo como um assunto descrito.
connected_references, reference_orderarrayAvançado. Referências rotuladas e ordenadas, no próprio formato do editor, até 14 na maioria dos modelos. Em um modelo com um limite de imagens próprio, o limite conta as imagens que a chamada envia, e entradas que compartilham uma imagem contam uma vez só. Uma chamada acima do limite é informada de quantas remover. Uma chamada com mais de 64 entradas é recusada antes de qualquer execução.
base_image_url, mask_urlstringInpainting: a imagem a editar e uma máscara, em que o branco é alterado e o preto é mantido. A área mascarada é gerada de novo e recolocada sobre a imagem.
strengthnumberPara inpainting, de 0 (sutil) a 1 (repintura completa), nos modelos compatíveis.
guidance_scalenumberDe 0 a 20, nos modelos compatíveis.
user_requeststringA última mensagem do usuário para o assistente, palavra por palavra, com até 4.000 caracteres. Ela fica guardada no nó, no workflow da conversa, e nunca muda o que é gerado. Veja As conversas MCP viram workflows.
flow_idstring"new" começa um novo workflow para esta etapa. O ID de workflow de um resultado anterior adiciona a etapa a esse workflow. Até 36 caracteres. Veja Conversas MCP.

Retorna: um ID de tarefa. Nos clientes com MCP Apps, o cartão mostra a imagem quando ela fica pronta.

Várias imagens numa chamada

  • count gera até 4 imagens da mesma requisição. Cada imagem é uma tarefa própria.
  • models roda a mesma requisição em 2 a 4 modelos. Com os dois, count vale por modelo, então uma chamada gera no máximo 8 imagens.
  • A resposta lista todos os IDs de tarefa, agrupados por modelo, com o ID do lote. O cartão e jobId acompanham a primeira tarefa.
  • Cada modelo recebe as próprias configurações. Ajustes como proporção e resolução são adaptados a cada modelo, como numa chamada única.
  • O lote é cobrado como um todo. O Nodaro verifica o seu saldo para o lote inteiro e cria todas as tarefas dele, ou nenhuma. Uma resposta de erro significa que nada foi cobrado.
  • Recusas. Um count fora de 1 a 4, mais de 4 modelos, model e models juntos, ou uma lista que cita um modelo que não é de imagem são recusados. O erro diz qual é o problema. Os IDs de modelo em models são reconhecidos sem diferenciar maiúsculas de minúsculas.

Aplicar uma predefinição

presetId aplica uma predefinição embutida ou salva exatamente como o editor a aplica:

  • O prompt da predefinição e o texto dela antes e depois do prompt são usados. O seu próprio prompt fica envolvido por esse texto.
  • Os marcadores escritos como {name || default} são preenchidos com os padrões deles.
  • O estilo e o prompt negativo da predefinição são passados do jeito que o modelo os aceita.
  • Qualquer configuração que a predefinição deixa sem valor recebe o padrão do editor. Os seus padrões de imagem salvos não se aplicam a uma chamada com predefinição.

Um marcador sem padrão, como {BRAND}, precisa de um valor em variables. Sem ele, a ferramenta diz qual valor está faltando. Com count, a ferramenta gera esse número de imagens da requisição da predefinição. Com models, ela aplica a predefinição uma vez para cada modelo. Por enquanto, não é possível combinar presetId com palette_id ou moodboard_id: a chamada é recusada.

Paletas e painéis de inspiração

palette_id cita no prompt todas as cores de uma paleta, por um nome comum e pelo código hexadecimal. moodboard_id adiciona a descrição do painel de inspiração ao prompt e envia as imagens dele como referências de estilo, depois das suas próprias referências, até o limite do modelo. A resposta informa quando algumas imagens não couberam. Crie e encontre paletas e painéis de inspiração com as ferramentas abaixo.

Formato de saída

generate_image, modify_image e image_to_image aceitam output_format no GPT Image 2.6 Flare e Sunburst, no MiniMax H3 Image, no Seedream 5.5 e no FLUX 3 Klein. list_models lista os formatos de cada modelo como outputFormats.

  • Formatos. png (padrão), jpeg, webp, gif ou svg no GPT Image 2.6 Flare e Sunburst. png ou jpeg no MiniMax H3 Image, no Seedream 5.5 e no FLUX 3 Klein. jpg é lido como jpeg.
  • GIF. Um GIF animado quadrado de 512 × 512 pixels, com 2 a 16 quadros. gif_frames define o número de quadros, padrão 9. gif_frame_duration_ms define quanto tempo cada quadro aparece, de 20 a 2.000 ms, padrão 200. Um GIF ignora a proporção e a resolução.
  • SVG. svg_level define o detalhe: standard, detailed ou max.
  • Preço. PNG, JPEG e WebP custam o mesmo. Um GIF tem o preço definido pela qualidade e pelo número de quadros. Um SVG custa o preço do PNG mais uma parte pelo nível. Veja Formatos na página do Gerar imagem.
  • Limites. Um fundo transparente só é mantido em PNG e WebP. Uma máscara com GIF ou SVG é recusada.

O que o servidor mudou aparece nos ajustes da resposta.

modify_image

Edita, muda o estilo ou transforma uma imagem existente com um prompt: trocar uma cor, substituir um fundo, aplicar um estilo, estender o quadro ou repintar parte dele. Funciona como o nó Modificar imagem.

Permissão: workflows:execute. Créditos: o preço do modelo.

ParâmetroTipoObservações
promptstringObrigatório. A alteração que você quer, com até 8.000 caracteres.
image_url ou image_asset_idstringObrigatório, um dos dois. Uma URL https pública ou o ID de uma tarefa do Nodaro cujo resultado é uma imagem.
modelstringPadrão: gpt-image-2-6-flare-i2i. Use nano-banana-pro para manter um rosto ou um personagem igual em várias edições e para texto na imagem, e gpt-image-2-i2i para edições com muito texto. Um ID desconhecido volta ao padrão.
aspect_ratiostringO formato da saída. auto mantém o formato da foto em todos os modelos. Um modelo cuja própria configuração auto mantém o formato a recebe. Qualquer outro modelo usa a proporção aceita mais próxima da imagem de origem, e o GPT Image 2.6 também, porque o auto dele renderiza um quadrado em retrato. Outro valor não compatível é trocado por outro. Sem ele, é usada a sua proporção salva. Sem nenhuma das duas, os modelos de edição GPT Image 2, 2.5 e 2.6, o padrão incluído, o MiniMax H3 Image, o Seedream 5.5 e o FLUX 3 Klein rodam em auto. Os outros modelos rodam em 16:9 quando a listam e, se não, na primeira proporção listada.
resolutionstringÉ usado o valor compatível mais próximo. O GPT Image 2.5 renderiza as proporções 27:16, 16:27, 9:8 e 8:9 só em 1K: um pedido em 2K ou 4K nessas proporções roda, e é cobrado, em 1K.
qualitystringOs níveis de qualidade que o modelo lista em list_models, nos modelos que têm configuração de qualidade. Com auto, a execução é cobrada pela imagem que realmente fez, e nunca mais do que o preço de max.
backgroundstringauto, opaque ou transparent, nos modelos que o listam. No GPT Image, um fundo transparente é renderizado em 1K.
output_format, gif_frames, gif_frame_duration_ms, svg_levelO formato do arquivo, como em generate_image. Veja Formato de saída.
negative_promptstringO que evitar, com até 2.000 caracteres.
mask_urlstringUma máscara de inpainting: o branco é alterado, o preto é mantido. Usada por gpt-image-2-6-flare-i2i, gpt-image-2-6-sunburst-i2i, ideogram-edit e flux-fill, os modelos cuja ficha em list_models lista o recurso mask. Os outros modelos a ignoram. Uma máscara não pode ser usada com uma saída GIF ou SVG. Veja Máscaras.
structuredobjectOs mesmos detalhes estruturados de generate_image.
user_requeststringA última mensagem do usuário para o assistente, palavra por palavra, com até 4.000 caracteres. Ela fica guardada no nó, no workflow da conversa, e nunca muda o que é gerado. Veja As conversas MCP viram workflows.
flow_idstring"new" começa um novo workflow para esta etapa. O ID de workflow de um resultado anterior adiciona a etapa a esse workflow. Até 36 caracteres. Veja Conversas MCP.

Retorna: um ID de tarefa.

image_to_image

Transforma uma imagem com um prompt, com opções de máscara e de composição de várias referências numa única imagem.

Permissão: workflows:execute. Créditos: o preço do modelo.

ParâmetroTipoObservações
promptstringObrigatório. A transformação, com até 2.000 caracteres.
image_url ou image_asset_idstringA imagem de origem.
modelstringPadrão: gpt-image-2-6-flare-i2i, ou o modelo de edição que desenha a aspect_ratio que você pediu. Outros incluem nano-banana, nano-banana-2, flux-kontext para edições fotorrealistas, gpt-image-i2i para repinturas criativas, flux-i2i e ideogram-remix. Um ID desconhecido é recusado. O model da resposta indica o modelo que a tarefa executa.
reference_image_urlsarrayImagens de referência extras ao lado da imagem de origem, como URLs ou IDs do Nodaro, para modelos que aceitam várias referências. Até 13. Um modelo com um limite de imagens próprio aceita 15 ao lado da origem no GPT Image 2.6 Flare e Sunburst ou no MiniMax H3 Image, e 9 no Seedream 5.5 ou no FLUX 3 Klein. Nesses modelos, todas as imagens são repassadas, e uma chamada acima do limite é recusada antes de qualquer cobrança, com uma mensagem que diz quantas remover. Uma chamada com mais de 64 referências é recusada antes de qualquer uma delas ser lida.
mask_urlstringUma máscara de inpainting: o branco é alterado, o preto é mantido. Usada por gpt-image-2-6-flare-i2i, gpt-image-2-6-sunburst-i2i, ideogram-edit e flux-fill, os modelos cuja ficha em list_models lista o recurso mask. Os outros modelos a ignoram. Uma máscara não pode ser usada com uma saída GIF ou SVG. Veja Máscaras.
strengthnumberDe 0 (sutil) a 1 (repintura completa).
aspect_ratiostringO formato da saída.
resolutionstring1K, 1.5K, 2K ou 4K, conforme o modelo.
qualitystringauto, low, medium, high, xhigh, max ou basic, conforme o modelo.
output_format, gif_frames, gif_frame_duration_ms, svg_levelO formato do arquivo, como em generate_image. Veja Formato de saída.
seedintegerUma seed fixa, nos modelos compatíveis.
negative_promptstringO que evitar, com até 5.000 caracteres.
user_requeststringA última mensagem do usuário para o assistente, palavra por palavra, com até 4.000 caracteres. Ela fica guardada no nó, no workflow da conversa, e nunca muda o que é gerado. Veja As conversas MCP viram workflows.
flow_idstring"new" começa um novo workflow para esta etapa. O ID de workflow de um resultado anterior adiciona a etapa a esse workflow. Até 36 caracteres. Veja Conversas MCP.

Os seus padrões de imagem salvos preenchem o que a chamada deixa de fora. Um valor que a chamada informa sempre prevalece.

  • Proporção, resolução e qualidade. Cada valor salvo é ajustado ao modelo. Uma aspect_ratio: "auto" salva funciona como uma proporção nomeada. Uma resolução ou qualidade salva que o modelo não aceita é deixada de fora.
  • Modelo. O modelo salvo só é usado quando uma edição consegue executá-lo: um modelo de edição, ou um modelo que gera e edita com um só ID, como nano-banana-pro. Um modelo só de texto para imagem, como gpt-image-2, não é usado numa edição.
  • Sem nenhum dos dois. Os modelos de edição GPT Image 2, 2.5 e 2.6, o MiniMax H3 Image, o Seedream 5.5 e o FLUX 3 Klein rodam em auto e mantêm o formato da foto. O GPT Image 2, o GPT Image 2.5, o MiniMax H3 Image, o Seedream 5.5 e o FLUX 3 Klein recebem o próprio auto, e o GPT Image 2.6 a proporção aceita mais próxima da foto. Qualquer outro modelo roda na própria proporção padrão.

Retorna: um ID de tarefa.

Máscaras

mask_url é uma imagem em preto e branco: o branco é a área a mudar, e o preto é mantido. image_to_image e modify_image a recebem do mesmo jeito. No GPT Image 2.6, o resto da imagem é mantido exatamente como estava: a origem é colada de volta em tudo fora da máscara, e o resultado tem o tamanho da origem. A execução mantém o formato da foto, renderiza no tamanho (1K, 2K ou 4K) mais próximo do da foto e é cobrada nesse tamanho. Os ajustes da resposta listam cada mudança. Uma máscara não custa nada a mais e não conta como imagem de entrada. Crie uma máscara com generate_mask.

edit_image

Faz o upscale de uma imagem, remove o fundo dela ou aplica uma edição pontual. Escolha a operação com model.

Permissão: workflows:execute. Créditos: o preço da operação, na tabela abaixo.

modelOperaçãoRequer
recraft-upscale (padrão)Um upscale nítidoA imagem
topaz-image-upscaleUpscale de 1, 2 ou 4 vezesA imagem e upscale_factor
nodaro-image-upscaleNodaro Image Upscale: 1 (só melhoria), 2, 4 ou 8 vezes. Restaura detalhes e mantém o texto exatamente como está escrito. Cobrado pelo tamanho da saídaA imagem e upscale_factor
recraft-remove-bgRemove o fundo e retorna um PNG com transparênciaA imagem
nano-banana-editUma edição por prompt, dentro de uma máscara ou fora do quadroA imagem, prompt e um mask_url opcional
grok-2-segmentUm mapa grátis das regiões nomeadas de uma imagem anterior do Grok Imagine 2task_id
grok-2-editUma edição por prompt de uma imagem anterior do Grok Imagine 2, opcionalmente só em algumas regiõestask_id, prompt e mask_indexes opcional
ModeloDesenvolvedorModosCréditosDetalhes
Recraft Crisp UpscaleRecraftUpscale de imagem3Aumento de resolução leve para imagens (Recraft Crisp).
Topaz Image UpscaleTopazUpscale de imagema partir de 28Aumento de resolução de imagens com alta qualidade, em 1x (só aprimoramento), 2x ou 4x. Ideal quando o resultado vai direto para produção.
Recraft Remove BGRecraftRemoção de fundo4Remove o fundo da imagem. Utilitário barato.
Nano Banana EditGoogleEdição de imagem11Edições de imagem para imagem com a família Nano Banana, do Google. Um bom editor para uso geral.
Grok Imagine 2 Segment MapxAIEdição de imagem0Mapa de segmentação semântica GRÁTIS de uma geração anterior do grok-2 — máscaras de regiões nomeadas cujos índices alimentam a seleção de regiões do grok-2-edit.
Grok Imagine 2 EditxAIEdição de imagem11Edita com um prompt uma geração anterior do grok-2, a partir do ID da tarefa. Índices de máscara opcionais (do grok-2-segment) limitam a edição a regiões nomeadas.
ParâmetroTipoObservações
modelstringA operação, da tabela acima. Padrão: recraft-upscale.
image_url ou image_asset_idstringA imagem de origem, em todas as operações, exceto as duas do Grok.
promptstringObrigatório para nano-banana-edit e grok-2-edit. Até 2.000 caracteres.
mask_urlstringPara nano-banana-edit: o branco é alterado.
upscale_factorstringPara topaz-image-upscale: 1, 2 ou 4. Para nodaro-image-upscale: 1, 2, 4 ou 8. Padrão: 2.
target_resolutionstringUma forma mais antiga de definir o fator de upscale de topaz-image-upscale: 2K equivale a 2, e 4K e 8K equivalem a 4. Use upscale_factor no lugar.
task_idstringPara as operações do Grok: o ID da tarefa da geração anterior do Grok Imagine 2. get_job o retorna como providerTaskId na saída da geração.
mask_indexesarrayPara grok-2-edit: os valores de index das regiões a alterar, vindos de uma execução de grok-2-segment.
negative_prompt, seed, styleOpcionais, nas operações que os usam.

Para editar só algumas regiões de uma imagem do Grok Imagine 2, trabalhe em duas etapas. Primeiro, execute grok-2-segment com o task_id da imagem e leia as regiões nomeadas no campo segments da tarefa. Depois, execute grok-2-edit com o mesmo task_id, um prompt e os mask_indexes das regiões a alterar. O mapa de regiões é grátis.

grok-upscale não é mais oferecido: ele nunca fez upscale de uma imagem. Uma chamada que ainda o indica é recusada com uma mensagem que indica o substituto, recraft-upscale ou topaz-image-upscale.

Retorna: um ID de tarefa.

split_into_layers

Divide uma imagem em uma imagem base e camadas separadas, cada elemento em um PNG transparente próprio. Cada camada vem com nome, descrição, posição e ordem de empilhamento. Funciona como o nó Dividir em camadas, e não aparece onde esse nó não é oferecido.

Permissão: workflows:execute. Créditos: cobrados por imagem devolvida, a base incluída. Uma execução reserva o preço de max_layers + 1 imagens no tamanho escolhido, e cobra só as imagens que devolve. 1K e 1.5K têm o mesmo preço, assim como 2K e auto.

ParâmetroTipoObservações
image_url ou image_asset_idstringA imagem a dividir: uma URL, o ID de uma tarefa de imagem do Nodaro ou o ID de uma imagem enviada.
max_layersintegerO máximo de camadas, de 1 a 99. Padrão: 9. Mais elementos que isso são juntados em menos camadas, e nenhum é descartado.
sizestringQuantos pixels cada imagem recebe: 1K (padrão, cerca de um megapixel), 1.5K, 2K ou auto, que usa o tamanho da própria imagem, entre 1K e 2K.
promptstringO que separar, com até 2.000 caracteres. Pode marcar áreas como <bbox>x1 y1 x2 y2</bbox>, numa escala de 0 a 1000. Em branco, os elementos principais são encontrados automaticamente.

Retorna: um ID de tarefa. A saída da tarefa traz:

  • imageUrl: a imagem base, um PNG opaco.
  • layers: o arquivo de cada camada, de baixo para cima, e layerCount.
  • layersNotSaved: as camadas que não puderam ser salvas. Elas não são cobradas.
  • layerData: um item por camada, na mesma ordem, com name, description, zIndex, width, height, box, boxNormalized, url e baseUrl.

zIndex é a ordem de empilhamento: 1 fica sobre a base, e valores maiores ficam acima. box é onde a camada fica sobre a base, em pixels da base, e boxNormalized é a mesma caixa numa escala de 0 a 1000. O arquivo de uma camada é recortado no próprio elemento, então redimensione-o para o seu box para colocá-lo de volta no lugar. Uma execução que não encontra nenhum elemento devolve só a base, pelo preço de uma imagem.

generate_mask

Cria uma máscara em preto e branco do que você descrever, por exemplo “a pessoa” ou “céu e nuvens”. O branco é a área selecionada. Use a máscara com image_to_image, edit_image ou os campos de inpainting de generate_image. Funciona como o nó Gerar máscara.

Permissão: workflows:execute. Créditos: 55.

ParâmetroTipoObservações
promptstringObrigatório. O que selecionar, com até 500 caracteres.
image_url ou image_asset_idstringA imagem de origem.
thresholdnumberA confiança da detecção, de 0 a 1. Padrão: 0.3.

Retorna: um ID de tarefa. O resultado é uma máscara PNG.

image_collage

Junta de 2 a 30 imagens numa única imagem grande. Nenhuma imagem é cortada: o layout smart as organiza em linhas, cada uma no próprio formato, e o layout grid usa células iguais, com o espaço vazio preenchido pela cor de fundo. Funciona como o nó Colagem de imagens e serve bem para storyboards e folhas de contato.

Permissão: workflows:execute. Créditos: 22 em 2K, 44 em 4K.

ParâmetroTipoObservações
imagesarrayObrigatório. De 2 a 30 itens, cada um { url } ou { asset_id }. Um item pode acrescentar size, um tamanho relativo para o layout smart (0 automático, 1 grande, 2 médio, 3 pequeno), e label, uma legenda de até 80 caracteres.
layoutstringsmart (padrão) ou grid.
resolutionstringO lado maior: 2K ou 4K (padrão, 3840 pixels).
aspect_ratiostringQualquer W:H, como 16:9 ou 9:16. Padrão: 4:3. Exata no grid; uma meta no smart, em que a altura acompanha as linhas.
gapintegerO espaço entre as imagens e em volta delas, de 0 a 200 pixels. Padrão: 24.
background_colorstringUma cor #RRGGBB. Padrão: #ffffff.
numberedbooleanCarimba 1, 2, 3 e assim por diante no canto de cada imagem, na ordem de images.
badge_positionstringO canto dos números e das legendas: top-left (padrão) ou top-right.

Retorna: um ID de tarefa.

image_overlay

Posiciona de 1 a 12 camadas sobre uma imagem base, com precisão de pixel: logos, recortes, textos, QR codes e formas. Nenhum modelo de IA é executado, então o resultado é sempre o mesmo. Funciona como o nó Sobreposição em imagem, cuja página documenta todas as opções.

Permissão: workflows:execute. Créditos: 11, e um pouco mais por tamanho extra de plataforma em variants, como no nó Sobreposição em imagem.

ParâmetroTipoObservações
image_url ou image_asset_idstringA imagem base.
layersarrayObrigatório. De 1 a 12 camadas. Veja os campos de camada abaixo. A ordem do array é a ordem de empilhamento, a menos que uma camada defina z_index.
canvasobjectUm tamanho de saída, width e height de 16 a 8192 pixels, com uma background_color. A base é encaixada nele com base_fit, contain ou cover. Omita-o para manter o tamanho da imagem base.
variantsarrayTamanhos extras de plataforma para renderizar de uma vez: youtube-thumbnail, youtube-banner, linkedin-company, linkedin-personal, x-header, facebook-cover, instagram-post, instagram-portrait, instagram-story, open-graph, presentation, a4-print.
qr_textstringPreenche cada camada de QR cujo qr.fromInput seja true.
mask_modestringA máscara que a tarefa também retorna como maskUrl, em que o branco pode mudar: around (padrão, um anel em volta das camadas para um acabamento com IA), layers, outside ou none.
mask_spreadintegerA largura do anel around, de 1 a 400 pixels. Padrão: 48.
output_formatstringpng (padrão, mantém a transparência), jpg ou webp.

Os principais campos de camada:

Campo da camadaObservações
kindimage (padrão, requer url ou asset_id), text, qr ou shape.
anchorUma de 9 posições, de top-left a bottom-right. Padrão: center.
x, yO deslocamento em relação à âncora, em porcentagem da largura e da altura da base. Um valor negativo numa âncora à direita ou embaixo move a camada para dentro.
width, heightEm porcentagem da largura e da altura da base. Largura padrão: 25%. A altura acompanha o formato da camada, a menos que você a defina.
opacity, rotation, blendOpacidade de 0 a 1, rotação em graus e mesclagem over, multiply ou screen.
fit, shadow, rounded_corners, z_indexComo a camada preenche a caixa dela (contain, cover ou stretch), uma sombra projetada, cantos arredondados e a ordem de empilhamento.
effectsSó para camadas de imagem: uma máscara circular, bordas suavizadas, um contorno ou um brilho.
textPara uma camada de texto: o text, um fontId (inter, montserrat, space-grotesk, playfair-display, oswald, bebas-neue, anton, pacifico, rubik ou heebo; rubik e heebo servem para hebraico), um fontSize em porcentagem da altura da base, fontWeight, color, align, letterSpacing, lineHeight, uppercase, um contorno e uma caixa de fundo.
qrPara uma camada de QR: o text a codificar, ou fromInput: true, além de cores e margem.
shapePara uma camada de forma: rect, rounded, pill, circle, ribbon, triangle, diamond, hexagon, star, burst ou arrow, com uma cor e um contorno.

Uma marca d’água no canto inferior direito é anchor: "bottom-right", x: -4, y: -6, width: 12. Os logos em SVG são renderizados nítidos no tamanho de destino.

Retorna: um ID de tarefa. O resultado traz a imagem, maskUrl, a width e a height dela e variants, uma lista de { id, label, width, height, url }.

suggest_overlay_placement

Pergunta a um modelo de visão onde uma camada deve ficar sobre uma imagem base. O modelo analisa a imagem e mantém a camada longe de rostos, do assunto principal e de texturas carregadas. Nada é composto: passe a resposta para image_overlay.

Permissão: workflows:execute. Créditos: uma descrição de imagem, cobrada como image_to_text.

ParâmetroTipoObservações
image_url ou image_asset_idstringA imagem base.
intentstringO que a camada é, como um logo, um título, um selo de preço ou um QR code. Até 300 caracteres. Padrão: um logo.
layer_aspectnumberA largura da camada dividida pela altura dela, de 0,05 a 20. Padrão: 1, um quadrado.
safe_areaobjectA área sempre visível, em frações do canvas: x, y, w, h. A camada fica dentro dela.

Retorna: anchor, x, y e width, nas mesmas unidades de porcentagem de image_overlay, e um reason de uma frase.

image_to_text

Descreve uma imagem, ou responde a uma pergunta sobre ela, com um modelo de visão. Use-a para legendas, texto alternativo, análise de cena ou uma pergunta específica, como “liste todo o texto da imagem”. Funciona como o nó Descrever imagem.

Permissão: workflows:execute. Créditos: uma chamada de LLM, cobrada pelos tokens que realmente usou, pela tarifa do modelo que a executou. Uma reserva é feita antes da chamada, e um saldo abaixo da reserva é recusado com 402. Uma descrição mais longa custa mais. O botão Executar do editor mostra ≈N, uma estimativa de uma chamada típica. Veja Como as chamadas de LLM são cobradas.

ParâmetroTipoObservações
image_url ou image_asset_idstringA imagem a descrever.
detail_levelstringbrief, detailed (padrão) ou comprehensive.
custom_promptstringUma pergunta específica em vez de uma descrição geral, com até 2.000 caracteres.
llmModelstringO modelo de visão, um dos IDs de LLM que a ferramenta lista. Padrão: Claude Sonnet 5.5.
reasoning_effortstringDe none a max. Um esforço maior costuma gastar mais tokens de saída, então a chamada custa mais. Em um modelo Claude, qualquer esforço é executado no próprio serviço do desenvolvedor do modelo e é cobrado pela tarifa desse serviço.
advanced_mode, temperature, max_tokensModelos Gemini e Claude, como nas ferramentas de prompt. A chamada é cobrada por token, pela tarifa do próprio desenvolvedor do modelo.

Retorna: um ID de tarefa. O texto fica na saída da tarefa, e o cartão o mostra com um botão Copy.

save_image_defaults

Salva as suas configurações de imagem preferidas na sua conta, como padrões das próximas chamadas de generate_image, modify_image e image_to_image. Só mudam os campos que você informar. Nos clientes com MCP Apps, o chip Save as default num cartão de imagem chama esta ferramenta.

  • Um valor que a chamada informa prevalece. Um valor salvo preenche o que a chamada deixa de fora. Sem nenhum dos dois, vale o padrão da própria ferramenta. Uma aspect_ratio: "auto" salva funciona como uma proporção nomeada.
  • Um só modelo salvo para as três ferramentas. A estrela num cartão de imagem salva o modelo que fez a imagem. Uma edição (modify_image, image_to_image) usa o modelo salvo só quando uma edição consegue executá-lo. generate_image o usa só quando o modelo gera imagens. Por isso, depois de uma estrela no resultado de uma edição, generate_image roda com o próprio padrão.
  • Predefinições. Uma chamada com presetId não lê os seus padrões salvos.

Permissão: workflows:execute. Créditos: grátis.

ParâmetroTipoObservações
modelstring or nullO seu modelo padrão. null o apaga, e o padrão da própria ferramenta volta a valer.
aspect_ratiostring or nullA sua proporção padrão.
resolutionstring or nullA sua resolução padrão.
qualitystring or nullA sua qualidade padrão.

Passe null num campo para apagá-lo.

Retorna: uma confirmação.

list_palettes

Lista as suas paletas de cores, das mais novas para as mais antigas: o nome, cada cor pelo nome comum e pelo código hexadecimal, a observação e o ID. Passe um ID para generate_image como palette_id.

Permissão: assets:read. Créditos: grátis.

ParâmetroTipoObservações
cursorstringO cursor da página anterior.

Retorna: uma página de paletas, a mesma lista de GET /v1/palettes.

save_palette

Cria uma paleta ou altera uma existente. Para criar, passe name e colors. Para alterar uma paleta, passe o id dela e só os campos que mudam.

Permissão: assets:write. Créditos: grátis.

ParâmetroTipoObservações
idstringA paleta a alterar. Deixe-o de fora para criar uma paleta.
namestringDe 1 a 80 caracteres. Obrigatório para criar.
colorsarrayDe 2 a 12 cores escritas como #RRGGBB. Obrigatório para criar. As cores são armazenadas em letras maiúsculas.
descriptionstringUma observação, com até 500 caracteres.

Retorna: a paleta com o ID dela. A ferramenta não exclui paletas. Exclua uma no app, com a CLI ou pela API.

list_moodboards

Lista os seus painéis de inspiração, dos mais novos para os mais antigos: o nome, o número de imagens, a descrição e o ID. Com id, retorna um painel de inspiração com o link e a legenda de cada imagem. Passe um ID para generate_image como moodboard_id.

Permissão: assets:read. Créditos: grátis.

ParâmetroTipoObservações
idstringLê este painel de inspiração por completo.
cursorstringO cursor da página anterior.

Retorna: uma página de painéis de inspiração, ou um painel de inspiração, como GET /v1/moodboards e GET /v1/moodboards/:id os retornam.

save_moodboard

Cria um painel de inspiração ou altera um existente. Para criar, passe name e images. Para alterar um painel de inspiração, passe o id dele e só os campos que mudam.

Permissão: assets:write. Créditos: grátis.

ParâmetroTipoObservações
idstringO painel de inspiração a alterar. Deixe-o de fora para criar um painel de inspiração.
namestringDe 1 a 80 caracteres. Obrigatório para criar.
descriptionstringAté 1.000 caracteres. Uma execução coloca essas palavras no prompt.
imagesarrayDe 1 a 12 itens { url, caption }. Cada url é um link de imagem ou o ID de uma das suas imagens do Nodaro. A legenda é opcional, com até 200 caracteres. Obrigatório para criar. Numa alteração, images substitui todas as imagens.

Retorna: o painel de inspiração com o ID dele. As imagens são guardadas como links, nunca copiadas. A ferramenta não exclui painéis de inspiração.

Perguntas frequentes

Qual modelo generate_image usa por padrão?

O GPT Image 2. Passe model com outro ID de list_models para trocá-lo, por exemplo nano-banana-pro para texto legível ou gpt-image-2-5-flare para iterações rápidas. Um ID desconhecido volta ao padrão sem erro.

Como mantenho a mesma pessoa em várias imagens?

Passe as fotos da pessoa em reference_image_urls, até 14 URLs ou IDs do Nodaro (16 no GPT Image 2.6 ou no MiniMax H3 Image, 10 no Seedream 5.5 ou no FLUX 3 Klein), e a resposta confirma quantas foram anexadas. Para um personagem salvo, passe o retrato aprovado que get_character retorna.

Como removo o fundo ou faço o upscale de uma imagem pelo MCP?

Use edit_image. Defina model como recraft-remove-bg para um PNG transparente, ou como recraft-upscale ou topaz-image-upscale para fazer o upscale. Nenhum deles precisa de prompt.

Um assistente pode colocar um logo ou um texto numa imagem sem IA?

Sim. image_overlay posiciona imagens, textos, QR codes e formas sobre uma imagem base, com precisão de pixel e sem nenhum modelo, e custa 11 créditos. suggest_overlay_placement pode sugerir antes onde um logo deve ficar.

Quanto custa gerar uma imagem pelo MCP?

O mesmo que no editor. O preço depende do modelo e da resolução ou qualidade dele; list_models e a página de cada modelo listam os créditos exatos.

Última atualização

Nesta página