Documentação Experience Platform Um tutorial técnico do Adobe

1.1.4 API de modelos personalizados do Firefly

Last update: Wed Sep 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

Iniciante
Desenvolvedor

1.1.4.1 O que são Modelos personalizados do Firefly?

Com os modelos personalizados do Firefly, você pode gerar variações de imagem que se alinham à sua marca usando o recurso Texto para imagem. Ao treinar esses modelos com suas próprias imagens, você pode gerar conteúdo que reflete a identidade da sua marca.
Transforme seu estilo ou assunto para explorar novas ideias, visualizar diferentes ambientes, gerar conteúdo inovador e adaptar o conteúdo a segmentos específicos.

Com os Modelos personalizados do Firefly você pode…

Criar ideias e conceitos na marca
Produzir temas de caracteres com estilos consistentes
Crie estilos de marca consistentes para expandir campanhas rapidamente

Para isso, os Modelos personalizados do Firefly são compatíveis:

Modelos de assunto personalizados
Modelos de estilo personalizados

Modelos de assunto personalizados

Ao treinar modelos personalizados em um assunto específico — sejam objetos ou caracteres — o objetivo é identificar os recursos essenciais do assunto e ajudar o modelo a replicá-los em vários contextos e posições.

Procure imagens com as seguintes características ao treinar um modelo de assunto:

Consistência do objeto: forneça imagens da mesma marca e modelo que o assunto, garantindo que o assunto não pareça muito diferente entre as imagens. Evite misturar várias cores e garanta um tema ou padrão comum entre as imagens. No entanto, o assunto pode variar entre cenas, poses, roupas e fundo.
Foco do objeto: Use imagens do assunto em foco claro sem distrações desnecessárias. Mantenha o assunto próximo ao centro da imagem e certifique-se de que ele ocupe pelo menos 25% da área da imagem.
Contexto ambiental: Forneça imagens do assunto em diferentes pontos de vista e contextos, mostrando-o em uma variedade de condições de iluminação. Embora imagens com fundo branco ou transparente possam ser usadas, é melhor misturar com ambientes mais complexos também.
Evitar outros objetos: Evite itens grandes no plano de fundo ou associados ao caractere. Qualquer item grande exibido nas imagens é memorizado pelo modelo e aparecerá nas imagens geradas, de modo semelhante ao mesmo item no conjunto de dados de treinamento.

Modelos de estilo personalizados

Modelos personalizados treinados em um estilo identificarão a aparência dos ativos para gerar imagens semelhantes quando solicitado.

Para treinar um modelo de estilo efetivo:

Proporcionar estética semelhante: inclua imagens que mostrem várias cenas e objetos, mantendo a mesma aparência.
Usar várias imagens: use o máximo de imagens possível para impedir que o modelo se concentre muito em objetos ou assuntos indesejados.
Evite frases fixas: um padrão fixo tem um peso maior do que outras frases. Por exemplo, se cada legenda contiver "O fundo é preto sólido" ou "estilos de desenhos animados fofos", o modelo dependerá dessa frase e qualquer prompt de teste sem ele não gerará os resultados desejados.

1.1.4.2 Configurar seu modelo personalizado

Ir para https://firefly.adobe.com/. Clique em Modelos personalizados.

Modelos personalizados do Firefly {modal="regular"}

Você poderá ver esta mensagem. Se você fizer isso, clique em Concordar para continuar.

Modelos personalizados do Firefly {modal="regular"}

Você deverá ver isso. Clique em Treinar um modelo.

Modelos personalizados do Firefly {modal="regular"}

Configure os seguintes campos:

Nome: use --aepUserLdap-- - Citi Signal Router Model
Modo de treinamento: selecione Assunto (visualização técnica)
Conceito: digite router
Salvar em: abra a lista suspensa e clique em + Criar novo projeto

Modelos personalizados do Firefly {modal="regular"}

Dê um nome ao novo projeto: --aepUserLdap-- - Custom Models. Clique em Criar.

Modelos personalizados do Firefly {modal="regular"}

Você deverá ver isso. Clique em Continuar.

Modelos personalizados do Firefly {modal="regular"}

Agora é necessário fornecer as imagens de referência para o Modelo personalizado ser treinado. Clique em Selecionar imagens do computador.

Modelos personalizados do Firefly {modal="regular"}

Baixe as imagens de referência aqui. Descompacte o arquivo de download, que fornecerá isso.

Modelos personalizados do Firefly {modal="regular"}

Navegue até a pasta que contém os arquivos de imagem baixados. Selecione todas e clique em Abrir.

Modelos personalizados do Firefly {modal="regular"}

Você verá que suas imagens estão sendo carregadas.

Modelos personalizados do Firefly {modal="regular"}

Após alguns minutos, as imagens são carregadas corretamente. Você pode ver que algumas imagens têm um erro, isso ocorre porque a legenda da imagem não foi gerada ou não é longa o suficiente. Revise cada imagem com um erro e insira uma legenda que atenda aos requisitos e descreva a imagem.

Modelos personalizados do Firefly {modal="regular"}

Depois que todas as imagens tiverem legendas que atendam aos requisitos, ainda será necessário fornecer um prompt de amostra. Digite qualquer prompt que use a palavra 'roteador'. Depois de fazer isso, você pode começar a treinar seu modelo. Clique em Treinamento.

Modelos personalizados do Firefly {modal="regular"}

Você verá isso. O treinamento do seu modelo pode levar de 20 a 30 minutos ou mais.

Modelos personalizados do Firefly {modal="regular"}

Após 20-30min, seu modelo agora é treinado e pode ser publicado. Clique em Publicar.

Modelos personalizados do Firefly {modal="regular"}

Clique novamente em Publicar.

Modelos personalizados do Firefly {modal="regular"}

Feche o pop-up Compartilhar modelo personalizado.

Modelos personalizados do Firefly {modal="regular"}

1.1.4.3 Usar seu modelo personalizado na interface

Ir para https://firefly.adobe.com/cme/train. Clique no modelo personalizado para abri-lo.

Modelos personalizados do Firefly {modal="regular"}

Clique em Visualizar e testar.

Modelos personalizados do Firefly {modal="regular"}

Você verá o prompt de amostra inserido antes de ser executado.

Modelos personalizados do Firefly {modal="regular"}

1.1.4.4 Habilitar seu Modelo personalizado para a API de Modelos personalizados do Firefly Services

Depois que o modelo personalizado for treinado, ele também poderá ser usado por meio da API. No exercício 1.1.1, você já configurou o projeto do Adobe I/O para interação com o Firefly Services por meio da API.

Ir para https://firefly.adobe.com/cme/train. Clique no modelo personalizado para abri-lo.

Modelos personalizados do Firefly {modal="regular"}

Clique nos 3 pontos … e em Compartilhar.

Modelos personalizados do Firefly {modal="regular"}

Para acessar um Modelo personalizado do Firefly, o Modelo personalizado precisa ser compartilhado com o Email da conta técnica do seu projeto do Adobe I/O.

Para recuperar seu Email de Conta Técnica, vá para https://developer.adobe.com/console/projects. Clique para abrir seu projeto, que se chama --aepUserLdap-- One Adobe tutorial.

Modelos personalizados do Firefly {modal="regular"}

Clique em Servidor a Servidor OAuth.

Modelos personalizados do Firefly {modal="regular"}

Clique para copiar o Email da Conta Técnica.

Modelos personalizados do Firefly {modal="regular"}

Cole seu Email de Conta Técnica e clique em Convidar para editar.

Modelos personalizados do Firefly {modal="regular"}

O Email da Conta Técnica agora deve poder acessar o Modelo Personalizado.

Modelos personalizados do Firefly {modal="regular"}

1.1.4.5 Interagir com a API de Modelos personalizados do Firefly Services

No Exercício 1.1.1 Introdução ao Firefly Services, você baixou este arquivo: postman-ff.zip no desktop local e importou essa coleção no Postman.

Abra o Postman e vá para a pasta FF - API de Modelos Personalizados.

Modelos personalizados do Firefly {modal="regular"}

Abra a solicitação 1. FF - getCustomModels e clique em Enviar.

Modelos personalizados do Firefly {modal="regular"}

Você deve ver o Modelo personalizado criado antes, chamado --aepUserLdap-- - Citi Signal Router Model, como parte da resposta. O campo assetId é o identificador exclusivo do seu Modelo personalizado, que será referenciado na próxima solicitação.

Modelos personalizados do Firefly {modal="regular"}

Abra a solicitação 2. Gerar Imagens Assíncronas. Neste exemplo, você solicitará duas variações a serem geradas com base no seu Modelo personalizado. Você pode atualizar o prompt que, neste caso, é a white router on a volcano in Africa.

Clique em Enviar.

Modelos personalizados do Firefly {modal="regular"}

A resposta contém um campo jobId. O trabalho para gerar essas 2 imagens agora está em execução e você pode verificar o status usando a próxima solicitação.

Modelos personalizados do Firefly {modal="regular"}

Abra a solicitação 3. Obtenha o Status de CM e clique em Enviar. Você deverá ver que o status está definido como em execução.

Modelos personalizados do Firefly {modal="regular"}

Após alguns minutos, clique em Enviar novamente para a solicitação 3. Obter Status de CM. Você deverá ver que o status mudou para êxito e deverá ver duas URLs de imagem como parte da saída. Clique em para abrir ambos os arquivos.

Modelos personalizados do Firefly {modal="regular"}