Descrever para seletor
Analise uma foto com IA e preencha os seletores Pessoa, Figurino e beleza, Enquadramento, Lente e Câmera / película com escolhas válidas do catálogo.
O nó Descrever para seletor analisa uma foto e preenche os nós de seletor que você conecta a ele. Um modelo de visão observa o assunto principal e a cena. Ele retorna escolhas que existem no catálogo de cada seletor, como a idade e o cabelo da pessoa, a maquiagem, o tamanho do plano ou a lente. Uma execução preenche todos os seletores conectados.
Quando usar
- Transforme um retrato de referência em um briefing de elenco completo: conecte Pessoa, Figurino e beleza e Enquadramento e, depois, conecte esses seletores ao Gerar imagem ou ao Gerar vídeo.
- Configure um personagem recorrente, com o figurino e o visual de lente dele, a partir de uma única foto.
- Reproduza a câmera de uma imagem de referência: detecte o tamanho do plano, o ângulo, a lente e a película.
Início rápido
Adicionar o nó
Pressione Tab no canvas e escolha Imagem › Interpretação › Descrever para seletor.
Conectar a foto
Arraste de um nó de imagem, como o Enviar imagem, até a entrada Imagem.
Conectar os seletores a preencher
Arraste da saída JSON do seletor até a entrada JSON do seletor de cada seletor que você quer preencher. O painel de configurações lista esses seletores em Analisando:.
Executar e aplicar o resultado
Clique em Executar no nó. Cada seletor recebe a própria parte do resultado. Por padrão, cada seletor aplica a sua parte na hora.
Entradas
| Entrada | Aceita | O que faz |
|---|---|---|
| Imagem | Nós de imagem, como Enviar imagem e Gerar imagem | A foto a analisar. Obrigatória. |
A saída JSON do seletor é um dado estruturado com uma parte para cada seletor conectado. Só nós de seletor conseguem lê-la: ela não se conecta a entradas de texto.
O que ele preenche
O nó analisa exatamente os seletores conectados à saída dele, e nenhum outro. Não há uma configuração para escolher os seletores: a conexão é a escolha.
| Seletor | O que ele detecta |
|---|---|
| Pessoa | Traços como tipo, idade, etnia, porte físico, cabelo, olhos e pele |
| Figurino e beleza | Escolhas de figurino e beleza do catálogo do seletor, como maquiagem, óculos e joias |
| Enquadramento | Tamanho do plano, ângulo e composição |
| Lente | A lente |
| Câmera / película | A câmera ou o formato de filme |
Cada valor é uma escolha real do catálogo do próprio seletor, então um seletor nunca recebe um valor que ele não conhece. Um traço que não está visível na foto fica de fora.
Como os seletores aplicam o resultado
Cada seletor decide como usar a própria parte do resultado, com duas configurações no painel de configurações dele.
Quando um JSON de imagem é injetado escolhe como os novos valores se combinam com as escolhas atuais do seletor:
| Modo | O que faz |
|---|---|
| Substituir tudo (limpar o que não foi detectado) | O padrão. Grava todos os valores detectados e limpa todos os valores que não foram detectados. Use quando a foto deve definir o seletor por completo. |
| Sobrescrever o detectado (manter o resto) | Grava só os valores detectados e mantém as suas outras escolhas. |
| Preencher só os vazios | Grava um valor detectado só onde o campo está vazio. Nunca sobrescreve uma escolha que você fez. |
Aplicar automaticamente ao mudar vem ativado por padrão. Quando está ativado, cada novo resultado é aplicado na hora, com o modo escolhido. Uma escolha que você muda à mão continua assim até a próxima execução. Até lá, o seletor mostra um botão Aplicar valores injetados, que aplica o resultado de novo. Quando está desativado, o seletor mostra Aplicar valores injetados depois de uma nova execução ou de uma mudança feita à mão. Caso contrário, ele mostra Atualizado. Cada execução conta como um novo resultado, mesmo quando retorna os mesmos valores.
Em todos os modos, só as escolhas do seletor mudam. O rótulo do seletor, o texto antes e depois dele e o layout dele continuam como estão.
Configurações
| Configuração | O que faz |
|---|---|
| Analisando: | Somente leitura. Os seletores conectados que a próxima execução vai preencher. Para mudar, conecte ou desconecte seletores. |
| Modelo de IA | O modelo de visão. O padrão é o Gemini 3.8 Flash, um modelo de visão rápido que lê o prompt por pouco. Para a leitura mais completa, escolha o Claude Opus 5.5: ele preencheu o maior número de características por imagem na Disputa de Modelos de Visão. A lista oferece só modelos de visão que conseguem retornar esse resultado estruturado com confiabilidade, incluindo o GPT-6.1 Terra e o Kimi K3.1 Pro. O GPT-5.2, o Gemini 4 Carbon e o Gemini 4 Hydrogen não são oferecidos, porque nenhum deles mantém a resposta nesse formato com confiabilidade. O Claude Fable 5 também é oferecido, e uma leitura com ele é uma das mais caras do nó. |
| Esforço de raciocínio | Quanto o modelo raciocina antes de responder, nos modelos que oferecem essa opção. O padrão é Automático (padrão do modelo), que não envia nenhum esforço. O Claude Opus 5.5 é a única exceção: ele roda em Alto, a menos que você escolha outro nível, e não oferece Automático. Nos nossos testes, Muito alto e Máximo deixaram as leituras mais lentas, sem respostas melhores. |
| Modo avançado | Modelos Gemini e Claude. Executa o modelo diretamente no fabricante dele, para que Temperatura, Máx. de tokens e toda a faixa de profundidade de raciocínio tenham efeito. A chamada passa a ser cobrada pela tarifa do próprio serviço do fabricante. O Claude Opus 5.5 em Alto já é executado ali, então o Modo avançado não muda o preço dele. |
| Orientações extras (opcional) | As suas próprias instruções para a análise, com até 2.000 caracteres, por exemplo focus on the foreground subject. |
Créditos
Uma execução é uma chamada de visão, não importa quantos seletores você conecte. A chamada é cobrada pelos tokens que realmente usou, pela tarifa do modelo selecionado. Os tokens são o prompt da análise, a foto e a resposta. O prompt da análise lista o catálogo de cada seletor conectado, então cada seletor conectado deixa o prompt mais longo. As regras completas estão em Como as chamadas de LLM são cobradas.
-
Antes da execução, o botão Executar mostra uma estimativa (
≈e um número) de uma leitura típica com o modelo selecionado. A estimativa cresce com o número de seletores conectados. -
O modelo define a tarifa. O padrão, o Gemini 3.8 Flash, é um dos modelos mais baratos. O Claude Sonnet 5.5 e o Claude Opus 5 custam mais. O Claude Opus 5.5, o Claude Fable 5 e o Gemini 4 Argon são os mais caros.
-
Algumas chamadas são executadas diretamente no fabricante. Isso acontece no Modo avançado e quando um modelo Claude tem qualquer esforço de raciocínio, porque o esforço do Claude só tem efeito ali. A chamada é então cobrada pela tarifa do próprio serviço do fabricante. O Claude Opus 5.5 roda em Alto por padrão, então toda leitura do Claude Opus 5.5 iniciada no editor é executada ali. O Gemini 4 Argon sempre é executado no próprio serviço do Google.
-
Primeiro vem uma reserva. Quando a execução começa, o Nodaro reserva créditos suficientes para a resposta mais longa que o modelo pode escrever. Um saldo abaixo da reserva é recusado antes de qualquer execução. Depois da chamada, a execução é cobrada pelo que usou.
-
Quando o Claude está indisponível. Quando um modelo Claude não consegue responder porque o serviço dele está fora do ar ou ocupado do lado do Nodaro, a mesma análise é executada uma vez no Gemini 3.8 Flash. A execução é cobrada pelo que as duas leituras usaram: a tentativa do Claude, se o fabricante dela a cobrou, mais a leitura do Gemini 3.8 Flash pela tarifa dele. Se o Gemini 3.8 Flash também falhar, a execução falha e só é cobrada por algum uso cobrado.
-
Uma recusa de conteúdo. Quando o modelo recusa a foto por motivo de conteúdo, a execução falha com a mensagem da política de conteúdo. Ela não é enviada a outro modelo. A recusa é cobrada quando o fabricante do modelo a cobrou, e reembolsada quando não a cobrou.
-
Uma leitura vazia. Quando a análise não encontra nenhuma característica para nenhum seletor conectado, a execução falha com a mensagem “Não conseguimos ler nada nesta foto — tente uma foto mais nítida de uma pessoa”. A mensagem então diz se você foi cobrado. Quando o fabricante do modelo cobrou a leitura, ela acrescenta “Foram cobrados N créditos pela tentativa do modelo”. Quando o fabricante não a cobrou, ela acrescenta “Você não foi cobrado”, e os créditos são reembolsados.
-
Uma resposta que nunca corresponde aos catálogos. No Claude e no Gemini 3.8 Flash, a análise é então pedida mais uma vez diretamente ao fabricante do modelo, cujo serviço garante a resposta aos catálogos. A execução é cobrada pelo que todas as tentativas usaram, e essa última leitura é cobrada pela tarifa do próprio serviço do fabricante.
-
Outras falhas. Uma falha que o fabricante do modelo cobrou, como uma resposta cortada no limite ou uma resposta que nunca correspondeu aos catálogos, é cobrada por esse uso, e o erro diz quanto. Uma falha que não foi cobrada é reembolsada.
Solução de problemas
A execução é recusada com uma mensagem para conectar um nó de seletor. Nada que o nó consiga preencher está conectado à saída dele. Conecte pelo menos um seletor Pessoa, Figurino e beleza, Enquadramento, Lente ou Câmera / película.
Um seletor não mudou depois da execução. Aplicar automaticamente ao mudar pode estar desativado nesse seletor. Clique em Aplicar valores injetados no seletor, ou ative Aplicar automaticamente ao mudar.
A execução falha com “Não conseguimos ler nada nesta foto”. O modelo não encontrou nenhuma característica para nenhum seletor conectado. A mensagem diz se a tentativa foi cobrada. Tente uma foto mais nítida de uma pessoa.
O nó descreveu a pessoa errada. Quando uma foto tem várias pessoas ou um fundo cheio de elementos, adicione Orientações extras (opcional), como describe the woman in the red coat.
Dicas
- Preencha vários seletores em uma execução. Pessoa, Figurino e beleza e Enquadramento juntos transformam uma foto em um briefing de elenco, de visual e de tomada, em uma única chamada ao modelo.
- Proteja as suas escolhas. Use Preencher só os vazios quando você escolheu à mão alguns traços marcantes e quer que a foto preencha o resto.
- Atualize sem perder os extras. Use Sobrescrever o detectado (manter o resto) para atualizar o que a foto mostra e manter as escolhas que você adicionou à mão.
- Refaça do zero. Use Substituir tudo (limpar o que não foi detectado) para ter uma versão limpa do seletor, guiada pela foto.
Pela API
O POST /v1/describe-to-picker executa a mesma análise a partir de código. Ele responde na mesma requisição com { jobId, pickerJson, gaps }. O pickerJson dá a cada seletor os valores detectados, como { "<picker>": { "<dimension>": "<id>" } }, com uma lista de IDs onde uma dimensão aceita várias escolhas.
| Campo | O que faz |
|---|---|
imageUrl | Obrigatório. Um link público http ou https para a foto. |
targetPickers | Obrigatório. Os seletores a preencher, como person, styling, framing, lens e camera-format. |
instructions | Orientações extras (opcional), com até 2.000 caracteres. |
llmModel | O modelo de visão. O padrão é gemini-3.8-flash. |
reasoningEffort | none, low, medium, high, xhigh ou max. Quando omitido, o modelo roda no próprio padrão, exceto o claude-opus-5.5, que roda em high. none no claude-opus-5.5 roda sem esforço, no serviço padrão em vez do próprio serviço da Anthropic. |
advancedMode, temperature, maxTokens | O Modo avançado e os controles dele, nos modelos Gemini e Claude. Os modelos Claude ignoram a Temperatura. |
Transmita a resposta. Envie Accept: text/event-stream para receber a resposta como eventos enviados pelo servidor, para que um cliente possa mostrar cada característica assim que o modelo a escrever. Um erro encontrado antes de o fluxo abrir, como uma requisição inválida ou créditos insuficientes, continua sendo uma resposta HTTP comum, com o corpo de erro JSON de sempre. O fluxo responde 200, e cada evento é uma linha data: com um objeto JSON, { "type", "data" }:
type | data | Significado |
|---|---|---|
field | { "field": "<picker>.<dimension>", "value" } | Uma característica detectada, enviada uma vez, assim que o modelo termina de escrevê-la. Ela é provisória: o done ainda pode corrigi-la. |
done | { jobId, pickerJson, gaps } | A mesma resposta do JSON. Ela é final. |
error | { "code": "llm_error", "message" } | A análise falhou depois que o fluxo abriu. Ela é cobrada por qualquer uso que o fabricante do modelo cobrou, e a mensagem diz quanto. Caso contrário, é reembolsada. |
- O fluxo termina depois de
doneouerror. Ignore linhas de comentário, como: keepalive. - Com um modelo Claude executado com uma profundidade de raciocínio (o Claude Opus 5.5 tem Alto por padrão), ou no Modo avançado, as características podem chegar como eventos
field. As outras execuções enviam sódone, incluindo o modelo padrão, o Gemini 3.8 Flash, e uma execução que passou para ele. - Um evento
fieldnunca traz um valor que as regras para pessoas com menos de 20 anos possam remover. Esses valores chegam só nodone. - Uma requisição é uma análise, cobrada da mesma forma que sem transmissão contínua. Ela é cobrada pelo que usou quando
donechega. Emerror, ela é cobrada por qualquer uso que o fabricante do modelo cobrou, e reembolsada caso contrário. Se o cliente se desconectar, a análise termina mesmo assim e é cobrada.
Veja Executar um único nó.
Perguntas frequentes
Quais seletores o “Descrever para seletor” consegue preencher?
Pessoa, Figurino e beleza, Enquadramento, Lente e Câmera / película. Ele preenche exatamente os que você conecta à saída dele, em uma única análise.
Quantos créditos o “Descrever para seletor” custa?
Uma execução é uma chamada de visão, cobrada pelos tokens que usou, pela tarifa do modelo selecionado. O padrão, o Gemini 3.8 Flash, é um dos modelos mais baratos, e o Claude Opus 5.5 e o Claude Fable 5 estão entre os mais caros. Cada seletor conectado deixa o prompt mais longo, então acrescenta um pouco ao preço. O botão Executar mostra uma estimativa antes da execução.
Ele vai sobrescrever as escolhas que fiz à mão?
Depende da configuração “Quando um JSON de imagem é injetado” de cada seletor. “Preencher só os vazios” nunca sobrescreve as suas escolhas. “Sobrescrever o detectado” mantém tudo o que não foi detectado. “Substituir tudo”, o padrão, também limpa tudo o que não foi detectado.
Por que nada mudou no meu seletor?
Cada seletor tem a opção “Aplicar automaticamente ao mudar”. Ela vem ativada por padrão e aplica na hora os valores de cada execução. Quando ela está desativada, clique em “Aplicar valores injetados” no seletor para aplicar os novos valores, ou ative “Aplicar automaticamente ao mudar” de novo.
Qual modelo de IA devo usar no “Descrever para seletor”?
O padrão, o Gemini 3.8 Flash, é rápido e é o que custa menos. Para a leitura mais completa, escolha o Claude Opus 5.5, que roda com esforço Alto por padrão. Ele preencheu o maior número de características por imagem na nossa Disputa de Modelos de Visão, e é um dos modelos mais caros do nó. Muito alto e Máximo deixaram as leituras mais lentas, não melhores.
Qual é a diferença entre o “Descrever para seletor” e o “Descrever imagem”?
O “Descrever imagem” escreve texto livre. O “Descrever para seletor” retorna escolhas estruturadas que existem no catálogo de cada seletor, para que os seletores possam aplicá-las diretamente.
Páginas relacionadas
Disputa de Modelos de Visão: sete modelos de IA leem quatro retratos
Pessoa
Figurino e beleza
Enquadramento
Descrever imagem
Controles criativos
Última atualização
Descrever imagem
Descreva qualquer imagem com um modelo de visão, de forma breve, detalhada ou em seções, e envie o texto para prompts, legendas ou texto alternativo.
Avaliador de imagem
Avalie imagens por realismo, anatomia, aderência ao prompt, estilo ou consistência do personagem e encaminhe-as conforme a nota, em checagens automáticas.