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.
| Ferramenta | O que faz | Créditos |
|---|---|---|
generate_image | Texto para imagem, com referências e inpainting opcional | O preço do modelo |
modify_image | Edita, muda o estilo e transforma uma imagem existente | O preço do modelo |
image_to_image | Imagem para imagem guiada por prompt, com máscaras e várias referências | O preço do modelo |
edit_image | Upscale, remoção de fundo e edições pontuais | O preço da operação |
split_into_layers | Uma imagem dividida em uma imagem base e camadas transparentes | Por imagem devolvida |
generate_mask | Uma máscara em preto e branco do que você descrever | 55 |
image_collage | De 2 a 30 imagens numa única imagem grande | 22 em 2K, 44 em 4K |
image_overlay | Logos, textos, QR codes e formas posicionados numa imagem, sem IA | 11, mais com tamanhos extras |
suggest_overlay_placement | Onde um logo ou um texto deve ficar numa imagem | Uma descrição de imagem |
image_to_text | Uma descrição ou uma resposta sobre uma imagem | Cobrada pelos tokens usados, pela tarifa do modelo |
save_image_defaults | O seu modelo e as suas configurações de imagem padrão | Grátis |
list_palettes, save_palette | As suas próprias paletas de cores, para orientar generate_image | Grátis |
list_moodboards, save_moodboard | Os seus próprios painéis de inspiração, para orientar generate_image | Grá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âmetro | Tipo | Observações |
|---|---|---|
prompt | string | A descrição da imagem, com até 4.000 caracteres. Obrigatório, a menos que uma predefinição o forneça. |
model | string | O ID do modelo. Padrão: gpt-image-2. Um ID desconhecido volta ao padrão. Veja list_models. |
aspect_ratio | string | Por 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. |
resolution | string | 1K, 2K ou 4K, nos modelos compatíveis. É usado o valor compatível mais próximo. |
quality | string | Os 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. |
background | string | auto, opaque ou transparent, nos modelos que o listam. No GPT Image, um fundo transparente é renderizado em 1K. |
output_format | string | O 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_level | As configurações de GIF e SVG de output_format. | |
negative_prompt | string | O que evitar, com até 2.000 caracteres. |
reference_image_urls | array | Até 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. |
count | integer | De 1 a 4 imagens por modelo. Cada imagem é uma tarefa própria. |
models | array | De 2 a 4 IDs de modelos de imagem, no lugar de model. A mesma requisição roda em cada modelo. |
presetId | string | Uma predefinição de list_node_presets, aplicada como o editor a aplica. Os campos que você informa a substituem. Veja Aplicar uma predefinição. |
variables | object | Valores para os marcadores de uma predefinição que não têm padrão, por exemplo { "BRAND": "Acme" }. |
palette_id | string | Uma paleta de list_palettes. As cores dela são citadas no prompt. |
moodboard_id | string | Um 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. |
subject | object | Quem 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. |
structured | object | Detalhes 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_references | array | Até 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_order | array | Avanç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_url | string | Inpainting: 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. |
strength | number | Para inpainting, de 0 (sutil) a 1 (repintura completa), nos modelos compatíveis. |
guidance_scale | number | De 0 a 20, nos modelos compatíveis. |
user_request | string | A ú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_id | string | "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
countgera até 4 imagens da mesma requisição. Cada imagem é uma tarefa própria.modelsroda a mesma requisição em 2 a 4 modelos. Com os dois,countvale 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
jobIdacompanham 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
countfora de 1 a 4, mais de 4 modelos,modelemodelsjuntos, 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 emmodelssã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
promptfica 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,gifousvgno GPT Image 2.6 Flare e Sunburst.pngoujpegno MiniMax H3 Image, no Seedream 5.5 e no FLUX 3 Klein.jpgé lido comojpeg. - GIF. Um GIF animado quadrado de 512 × 512 pixels, com 2 a 16 quadros.
gif_framesdefine o número de quadros, padrão9.gif_frame_duration_msdefine quanto tempo cada quadro aparece, de 20 a 2.000 ms, padrão200. Um GIF ignora a proporção e a resolução. - SVG.
svg_leveldefine o detalhe:standard,detailedoumax. - 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âmetro | Tipo | Observações |
|---|---|---|
prompt | string | Obrigatório. A alteração que você quer, com até 8.000 caracteres. |
image_url ou image_asset_id | string | Obrigatório, um dos dois. Uma URL https pública ou o ID de uma tarefa do Nodaro cujo resultado é uma imagem. |
model | string | Padrã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_ratio | string | O 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. |
resolution | string | É 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. |
quality | string | Os 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. |
background | string | auto, 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_level | O formato do arquivo, como em generate_image. Veja Formato de saída. | |
negative_prompt | string | O que evitar, com até 2.000 caracteres. |
mask_url | string | Uma 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. |
structured | object | Os mesmos detalhes estruturados de generate_image. |
user_request | string | A ú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_id | string | "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âmetro | Tipo | Observações |
|---|---|---|
prompt | string | Obrigatório. A transformação, com até 2.000 caracteres. |
image_url ou image_asset_id | string | A imagem de origem. |
model | string | Padrã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_urls | array | Imagens 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_url | string | Uma 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. |
strength | number | De 0 (sutil) a 1 (repintura completa). |
aspect_ratio | string | O formato da saída. |
resolution | string | 1K, 1.5K, 2K ou 4K, conforme o modelo. |
quality | string | auto, low, medium, high, xhigh, max ou basic, conforme o modelo. |
output_format, gif_frames, gif_frame_duration_ms, svg_level | O formato do arquivo, como em generate_image. Veja Formato de saída. | |
seed | integer | Uma seed fixa, nos modelos compatíveis. |
negative_prompt | string | O que evitar, com até 5.000 caracteres. |
user_request | string | A ú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_id | string | "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, comogpt-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
autoe 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óprioauto, 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.
model | Operação | Requer |
|---|---|---|
recraft-upscale (padrão) | Um upscale nítido | A imagem |
topaz-image-upscale | Upscale de 1, 2 ou 4 vezes | A imagem e upscale_factor |
nodaro-image-upscale | Nodaro 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ída | A imagem e upscale_factor |
recraft-remove-bg | Remove o fundo e retorna um PNG com transparência | A imagem |
nano-banana-edit | Uma edição por prompt, dentro de uma máscara ou fora do quadro | A imagem, prompt e um mask_url opcional |
grok-2-segment | Um mapa grátis das regiões nomeadas de uma imagem anterior do Grok Imagine 2 | task_id |
grok-2-edit | Uma edição por prompt de uma imagem anterior do Grok Imagine 2, opcionalmente só em algumas regiões | task_id, prompt e mask_indexes opcional |
| Modelo | Desenvolvedor | Modos | Créditos | Detalhes |
|---|---|---|---|---|
| Recraft Crisp Upscale | Recraft | Upscale de imagem | 3 | Aumento de resolução leve para imagens (Recraft Crisp). |
| Topaz Image Upscale | Topaz | Upscale de imagem | a partir de 28 | Aumento 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 BG | Recraft | Remoção de fundo | 4 | Remove o fundo da imagem. Utilitário barato. |
| Nano Banana Edit | Edição de imagem | 11 | Edições de imagem para imagem com a família Nano Banana, do Google. Um bom editor para uso geral. | |
| Grok Imagine 2 Segment Map | xAI | Edição de imagem | 0 | Mapa 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 Edit | xAI | Edição de imagem | 11 | Edita 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âmetro | Tipo | Observações |
|---|---|---|
model | string | A operação, da tabela acima. Padrão: recraft-upscale. |
image_url ou image_asset_id | string | A imagem de origem, em todas as operações, exceto as duas do Grok. |
prompt | string | Obrigatório para nano-banana-edit e grok-2-edit. Até 2.000 caracteres. |
mask_url | string | Para nano-banana-edit: o branco é alterado. |
upscale_factor | string | Para topaz-image-upscale: 1, 2 ou 4. Para nodaro-image-upscale: 1, 2, 4 ou 8. Padrão: 2. |
target_resolution | string | Uma 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_id | string | Para 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_indexes | array | Para grok-2-edit: os valores de index das regiões a alterar, vindos de uma execução de grok-2-segment. |
negative_prompt, seed, style | Opcionais, 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âmetro | Tipo | Observações |
|---|---|---|
image_url ou image_asset_id | string | A imagem a dividir: uma URL, o ID de uma tarefa de imagem do Nodaro ou o ID de uma imagem enviada. |
max_layers | integer | O máximo de camadas, de 1 a 99. Padrão: 9. Mais elementos que isso são juntados em menos camadas, e nenhum é descartado. |
size | string | Quantos 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. |
prompt | string | O 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, elayerCount.layersNotSaved: as camadas que não puderam ser salvas. Elas não são cobradas.layerData: um item por camada, na mesma ordem, comname,description,zIndex,width,height,box,boxNormalized,urlebaseUrl.
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âmetro | Tipo | Observações |
|---|---|---|
prompt | string | Obrigatório. O que selecionar, com até 500 caracteres. |
image_url ou image_asset_id | string | A imagem de origem. |
threshold | number | A 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âmetro | Tipo | Observações |
|---|---|---|
images | array | Obrigató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. |
layout | string | smart (padrão) ou grid. |
resolution | string | O lado maior: 2K ou 4K (padrão, 3840 pixels). |
aspect_ratio | string | Qualquer 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. |
gap | integer | O espaço entre as imagens e em volta delas, de 0 a 200 pixels. Padrão: 24. |
background_color | string | Uma cor #RRGGBB. Padrão: #ffffff. |
numbered | boolean | Carimba 1, 2, 3 e assim por diante no canto de cada imagem, na ordem de images. |
badge_position | string | O 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âmetro | Tipo | Observações |
|---|---|---|
image_url ou image_asset_id | string | A imagem base. |
layers | array | Obrigató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. |
canvas | object | Um 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. |
variants | array | Tamanhos 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_text | string | Preenche cada camada de QR cujo qr.fromInput seja true. |
mask_mode | string | A 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_spread | integer | A largura do anel around, de 1 a 400 pixels. Padrão: 48. |
output_format | string | png (padrão, mantém a transparência), jpg ou webp. |
Os principais campos de camada:
| Campo da camada | Observações |
|---|---|
kind | image (padrão, requer url ou asset_id), text, qr ou shape. |
anchor | Uma de 9 posições, de top-left a bottom-right. Padrão: center. |
x, y | O 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, height | Em 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, blend | Opacidade de 0 a 1, rotação em graus e mesclagem over, multiply ou screen. |
fit, shadow, rounded_corners, z_index | Como a camada preenche a caixa dela (contain, cover ou stretch), uma sombra projetada, cantos arredondados e a ordem de empilhamento. |
effects | Só para camadas de imagem: uma máscara circular, bordas suavizadas, um contorno ou um brilho. |
text | Para 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. |
qr | Para uma camada de QR: o text a codificar, ou fromInput: true, além de cores e margem. |
shape | Para 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âmetro | Tipo | Observações |
|---|---|---|
image_url ou image_asset_id | string | A imagem base. |
intent | string | O 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_aspect | number | A largura da camada dividida pela altura dela, de 0,05 a 20. Padrão: 1, um quadrado. |
safe_area | object | A á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âmetro | Tipo | Observações |
|---|---|---|
image_url ou image_asset_id | string | A imagem a descrever. |
detail_level | string | brief, detailed (padrão) ou comprehensive. |
custom_prompt | string | Uma pergunta específica em vez de uma descrição geral, com até 2.000 caracteres. |
llmModel | string | O modelo de visão, um dos IDs de LLM que a ferramenta lista. Padrão: Claude Sonnet 5.5. |
reasoning_effort | string | De 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_tokens | Modelos 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_imageo usa só quando o modelo gera imagens. Por isso, depois de uma estrela no resultado de uma edição,generate_imageroda com o próprio padrão. - Predefinições. Uma chamada com
presetIdnão lê os seus padrões salvos.
Permissão: workflows:execute. Créditos: grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
model | string or null | O seu modelo padrão. null o apaga, e o padrão da própria ferramenta volta a valer. |
aspect_ratio | string or null | A sua proporção padrão. |
resolution | string or null | A sua resolução padrão. |
quality | string or null | A 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âmetro | Tipo | Observações |
|---|---|---|
cursor | string | O 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âmetro | Tipo | Observações |
|---|---|---|
id | string | A paleta a alterar. Deixe-o de fora para criar uma paleta. |
name | string | De 1 a 80 caracteres. Obrigatório para criar. |
colors | array | De 2 a 12 cores escritas como #RRGGBB. Obrigatório para criar. As cores são armazenadas em letras maiúsculas. |
description | string | Uma 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âmetro | Tipo | Observações |
|---|---|---|
id | string | Lê este painel de inspiração por completo. |
cursor | string | O 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âmetro | Tipo | Observações |
|---|---|---|
id | string | O painel de inspiração a alterar. Deixe-o de fora para criar um painel de inspiração. |
name | string | De 1 a 80 caracteres. Obrigatório para criar. |
description | string | Até 1.000 caracteres. Uma execução coloca essas palavras no prompt. |
images | array | De 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.
Páginas relacionadas
Gerar imagem
Modificar imagem
Sobreposição em imagem
Vídeo
Como escolher um modelo
Última atualização
Prompts e texto
Transforme uma ideia num prompt testado, pergunte a qualquer LLM sobre imagens, vídeo, áudio ou PDFs, escreva um roteiro e deixe um LLM juiz escolher o melhor.
Vídeo
Gere vídeo de texto ou imagem, estenda, reestilize, reilumine e faça upscale de clipes e faça rostos falar ou se mover num assistente de IA com o Nodaro.