Bria FIBO 2.0 Texto para Imagem e Imagem para Imagem: parâmetros, prompts e exemplos de chamada

As duas entradas de modelo do Bria FIBO 2.0

O Bria FIBO 2.0 oferece dois modelos na plataforma: Bria FIBO 2.0 Texto para Imagem (fibo-2.0/text-to-image), que gera imagens a partir de um prompt, e Bria FIBO 2.0 Imagem para Imagem (fibo-2.0/image-to-image), que edita imagens existentes seguindo instruções em linguagem natural. Ambos têm o mesmo preço de $0.0572 por imagem; a saída tem cerca de 1 milhão de pixels e, na proporção 1:1, é 1024×1024.

A Bria treina seus modelos com dados licenciados, adequados a cenários comerciais. O controle sobre elementos fotográficos como posição de câmera, iluminação, profundidade de campo e composição é bastante forte, e é exatamente isso que vale a pena aproveitar ao usá-lo: em vez de empilhar adjetivos, escreva esses elementos como descrições explícitas que possam ser ajustadas trecho a trecho.

Três tipos de trabalho adequados a ele

• Ajuste de posição de câmera e iluminação em material já existente: você tem uma foto de produto ou retrato pronta e só quer mudar o ângulo para um plongée de 45 graus ou a luz do meio-dia para o crepúsculo, sem alterar pose, roupa ou fundo. O Imagem para Imagem é bom em mudar apenas um atributo e manter o resto intacto, o que atende bem a esse tipo de demanda.
• Concept art de cenário com estilo especificado: descreva cenário, posição de câmera e iluminação de forma estruturada e escolha um estilo entre Kodak Film, Hard Flash, Hazy Dreamy e Rough Realism, para exploração inicial de direção visual.
• Substituição local com máscara: altere apenas uma região da imagem, por exemplo substituir um objeto sobre a mesa ou trocar uma placa ao fundo, delimitando a área com uma máscara preto e branco e mantendo o restante intacto.

Como usar os parâmetros

A estrutura de entrada dos dois modelos é diferente: o campo central do Texto para Imagem é prompt, e o do Imagem para Imagem é instruction. Os nomes dos campos são parecidos, mas valores e restrições diferem; analisá-los separadamente é mais seguro.

Bria FIBO 2.0 Texto para Imagem (fibo-2.0/text-to-image)

Os 21 valores de aspect_ratio incluem 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 16:10, 10:16, 2:1, 1:2, 21:9, 9:21, 3:1, 1:3, 4:1, 1:4, 5:1, 1:5. Se não for enviado, a imagem sai em 1:1. O total de saída é de cerca de 1 milhão de pixels; a proporção só altera a distribuição entre largura e altura.

style e image_url não podem coexistir, e isso deve ser validado previamente no código: envie style quando precisar de um estilo fixo e image_url quando precisar das características visuais de uma imagem de referência, escolhendo apenas um dos dois. Conflitos de parâmetros não são resolvidos automaticamente no lado da geração; interceptar antes é mais simples do que investigar depois.

Bria FIBO 2.0 Imagem para Imagem (fibo-2.0/image-to-image)

A ordem de image_urls importa: a primeira define o sujeito editado, e as demais só têm efeito quando referenciadas na instruction, escrevendo <image_1>, <image_2>. Uma imagem de referência não mencionada na instruction equivale a não ter sido usada.

Sem aspect_ratio, a proporção segue a primeira imagem; edições de imagem única mantêm sempre a proporção original. Use mask_url apenas quando precisar limitar o escopo da alteração: a máscara é uma imagem preto e branco, a área branca indica a região a alterar e as dimensões devem coincidir com a imagem original para se alinharem; com máscara, image_urls aceita apenas 1 imagem, sem possibilidade de adicionar referências.

Ao usar Imagem para Imagem, é melhor que a instrução mire apenas um atributo. Escolha um entre posição de câmera, iluminação, horário, vestuário e material, e escreva o restante como "mantenha inalterado"; assim fica mais fácil avaliar se o resultado atende ao esperado.

Como escrever o prompt

A ordem recomendada de descrição é: sujeito e ação → cenário → ângulo de câmera → iluminação e horário → profundidade de campo e foco → material e qualidade de imagem. Escrever nessas seis partes equivale a dividir a cena em seis variáveis ajustáveis de forma independente: para mudar a posição de câmera, altere só a terceira parte; para mudar o horário, altere só a quarta, mantendo o restante intacto, e a diferença causada pela mudança pode ser atribuída com clareza. O controle de elementos fotográficos é o ponto forte deste modelo, e essas seis partes basicamente cobrem seu escopo de vantagem.

Exemplo 1: prompt de Texto para Imagem

Uma mulher com sobretudo de lã cinza-escuro está numa esquina após a chuva, fechando um guarda-chuva preto de cabo longo.
Nos dois lados da rua há lojas que ainda não abriram no início da manhã, com portas de enrolar semicerradas e poças no chão.
Perspectiva de 35mm, posição de câmera ligeiramente baixa, fotografada da frente esquerda da pessoa, com a figura no terço direito do quadro.
Luz difusa de manhã nublada, temperatura de cor fria, sem luz solar direta.
f/2 com profundidade de campo rasa, rosto nítido e edifícios ao fundo desfocando gradualmente.
O tecido de lã mostra textura fina, as varetas metálicas do guarda-chuva têm leve brilho e o grão geral é fino.

No envio, especifique style como Kodak Film, aspect_ratio como 3:2 e seed como 5555. As seis partes da descrição são independentes; se depois quiser trocar para o estilo de luz dura do Hard Flash, basta mudar style e a parte de iluminação, mantendo as outras cinco linhas como estão para comparar diferenças.

Exemplo 2: instruction de Imagem para Imagem

Mude o ângulo de câmera de <image_1> para um plongée direto de cima, mantendo a pose, a roupa e a posição da pessoa inalteradas.
Use <image_2> como referência de material da roupa; trate a textura do tecido e o brilho do sobretudo conforme <image_2>.

Aqui image_urls recebe duas imagens: a primeira é a imagem original a editar e a segunda é a referência de material; por isso a instruction precisa indicar explicitamente com <image_1> e <image_2>. A instrução em si faz apenas duas coisas — mudar o ângulo de câmera e tratar o material conforme a referência —, exatamente o escopo em que o Imagem para Imagem se destaca: alterar um atributo por vez e deixar o restante o mais intacto possível. Limitar a alteração a uma única dimensão reduz retrabalho e facilita avaliar se a chamada atingiu o esperado.

Preço e segurança de conteúdo

Os dois modelos custam $0.0572 por imagem, e a regra de cobrança independe de proporção, estilo, número de imagens de referência e uso de máscara. 1:1 e 21:9 têm o mesmo preço, enviar 4 imagens ou 1 imagem custa o mesmo, com ou sem mask custa o mesmo. O custo depende apenas do número de imagens geradas: 100 imagens custam $5.72, 1000 imagens custam $57.2.

Há um ponto sobre segurança de conteúdo que é preciso saber de antemão: se a descrição contiver conteúdo não conforme, a interface não retorna erro; o modelo reescreve o prompt para um conteúdo seguro e continua a gerar a imagem. A cena reescrita pode não ter relação com sua intenção original, mas a chamada é cobrada normalmente. Portanto, revise o prompt antes de enviar, especialmente descrições sensíveis envolvendo pessoas, roupas e cenários — o problema não aparecerá como erro, mas como uma imagem não relacionada e uma cobrança.

Exemplo de chamada da API

Os dois modelos usam a interface de tarefas assíncronas: primeiro faça POST /v1/tasks para enviar a tarefa, obtenha o id da tarefa na resposta e depois consulte GET /v1/tasks/{id} para obter o endereço da imagem.

curl -X POST "$HIAPI_BASE_URL/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fibo-2.0/text-to-image",
    "input": {
      "prompt": "Uma mulher com sobretudo de lã cinza-escuro está numa esquina após a chuva, perspectiva de 35mm, posição de câmera ligeiramente baixa, luz difusa de manhã nublada, f/2 com profundidade de campo rasa, tecido de lã com textura fina.",
      "style": "Kodak Film",
      "aspect_ratio": "3:2",
      "seed": 5555
    }
  }'

curl "$HIAPI_BASE_URL/v1/tasks/{id}" \
  -H "Authorization: Bearer $HIAPI_API_KEY"

O Imagem para Imagem usa a mesma interface de tarefas, trocando apenas model e input:

curl -X POST "$HIAPI_BASE_URL/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fibo-2.0/image-to-image",
    "input": {
      "instruction": "Mude o ângulo de câmera de <image_1> para um plongée direto de cima, mantendo a pose e a roupa da pessoa inalteradas. Use <image_2> como referência de material da roupa.",
      "image_urls": [
        "https://example.com/scene.jpg",
        "https://example.com/fabric.jpg"
      ],
      "seed": 5555
    }
  }'

Perguntas frequentes

style e image_url podem ser enviados juntos?

Não. Os dois são mutuamente exclusivos e enviá-los juntos gera conflito. Use style para especificar um estilo e image_url para usar as características visuais de uma imagem de referência; escolha um dos dois.

Depois de enviar mask_url, ainda é possível enviar várias image_urls?

Não. Com máscara, image_urls só pode ter 1 imagem, que é a imagem a ser editada; a máscara em si é uma imagem preto e branco, a área branca indica a parte a alterar e as dimensões devem coincidir com a imagem original.

Como reproduzir a mesma imagem?

Fixe o seed. O intervalo vai de 0 a 2147483647, com padrão 5555; o mesmo seed com o mesmo prompt reproduz o resultado. O valor padrão de seed no Imagem para Imagem também é 5555.