Paletas e painéis de inspiração

Uma paleta é o seu próprio conjunto de cores, e um painel de inspiração é o seu próprio conjunto de imagens de referência com uma descrição. Você os salva uma vez e depois orienta qualquer execução do Gerar imagem com um deles. Eles funcionam como os looks de cor e os estilos integrados, mas com as suas cores e as suas imagens.

Você cria paletas e painéis de inspiração pela API REST, pelo SDK, pela CLI ou por um assistente de IA via MCP. O editor não tem uma tela para criá-los ou editá-los. Eles funcionam em todas as edições.

O que cada um contém

Os dois pertencem só a você. O id de outra pessoa responde 404, como um id que não existe.

Como uma paleta orienta uma imagem

Uma execução nomeia cada cor da paleta no prompt, na sua ordem, como color palette: <name> <hex>, …. Cada cor recebe o nome do dia a dia mais próximo, porque um modelo segue uma cor nomeada com mais confiabilidade, e o código hex exato. A nota da paleta é para você e não é adicionada ao prompt.

As palavras vão para onde iria um look de cor integrado, na seção de estilo no fim do prompt. Quando um prompt passa do limite do modelo, essas palavras são removidas primeiro. O seu próprio prompt e as suas referências nunca são cortados.

Como um painel de inspiração orienta uma imagem

Um painel de inspiração adiciona a descrição dele ao prompt como você a escreveu. Um painel de inspiração sem descrição envia só as imagens.

As imagens vão para o modelo como imagens de referência. Cada imagem vem com uma linha curta que diz ao modelo para aproveitar dela as cores, a luz, a textura e o clima, e não o assunto nem a composição. A legenda dela é adicionada quando existe.

• As suas próprias referências vêm primeiro. As imagens que você mesmo envia, e um personagem conectado, mantêm os lugares deles. As imagens do painel de inspiração preenchem só as vagas de referência que sobram depois deles.
• Nunca mais do que o modelo aceita. Cada modelo aceita um número definido de imagens de referência. As imagens que não cabem, na ordem do seu painel de inspiração, não são enviadas. Um modelo que não aceita imagens de referência não recebe nenhuma, mas a descrição ainda entra.
• Proporção em Automático mantém o formato da primeira imagem que a execução envia. Quando você não envia nenhuma imagem sua, essa é a primeira imagem do painel de inspiração.

O aviso quando imagens não são enviadas

Quando algumas imagens não cabem, a execução segue e a resposta traz um aviso com o código moodboard_images_not_sent. A mensagem diz quantas imagens não foram enviadas e por quê. A tarefa guarda o mesmo aviso. Por exemplo:

5 of the 12 images of moodboard "Nordic calm" were not sent as style references: the model (nano-banana-pro) takes at most 8 reference images, and your own references come first.

Limites

• Links de imagens, não cópias. Cada imagem é um link público http ou https de até 2.048 caracteres, e uma legenda tem até 200 caracteres. Um link para uma rede privada é recusado. Uma imagem que você exclui, ou que a retenção de mídia do seu plano remove, também some do painel de inspiração.
• Só no Gerar imagem. Uma requisição de vídeo que nomeia uma paleta ou um painel de inspiração responde 400.
• Não com uma predefinição na mesma requisição. Uma chamada que aplica uma predefinição (presetId) não pode usar uma paleta nem um painel de inspiração e responde 400. Isso inclui uma predefinição salva com um deles na direção.
• A versão mais recente é usada. Uma execução registra os ids, não uma cópia. Mude uma paleta e a próxima execução usa as novas cores. Exclua-a, e uma execução que ainda a nomeia responde 404.
• Os erros vêm antes de qualquer cobrança. Um id malformado responde 400, e um id que não é seu ou que não existe mais responde 404. Um id integrado desconhecido é ignorado, mas a sua própria paleta ou o seu painel de inspiração nunca é ignorado em silêncio.

Quanto custa

Salvar, listar e mudar paletas e painéis de inspiração é gratuito. As imagens de um painel de inspiração são referências, então uma execução tem o preço de qualquer execução com esse número de referências. Um modelo de texto para imagem com referências é executado na versão de imagem para imagem dele, e um modelo com preço por imagem de referência as conta. O preço verificado antes da execução conta só as imagens que são realmente enviadas.

Em um workflow

Um nó Gerar imagem cuja direção nomeia uma paleta ou um painel de inspiração é resolvido a cada execução do workflow, incluindo execuções de apps, agendamentos e webhooks. Um nó assim é escrito no workflow por código ou por um assistente de IA.

• A visualização Final mostra uma nota onde a paleta ou o painel de inspiração vai entrar, porque as palavras dele são adicionadas quando a execução começa.
• Execute o workflow, não o nó. O botão de execução do próprio nó recusa um nó assim, sem nada enviado nem cobrado. A mensagem termina com “Execute o workflow para usá-la — nenhum crédito foi cobrado.”
• Em um app publicado, uma paleta ou um painel de inspiração salvo no workflow é procurado entre os do criador. Um que a pessoa que executa o app fornece é procurado entre os dela, então ela nunca pode nomear as outras paletas ou painéis de inspiração do criador.
• Uma paleta ou um painel de inspiração que não pode ser encontrado faz esse nó falhar antes de qualquer coisa ser criada ou cobrada.

Criar e usar por código