Skip to main content
POST

Modelos compatíveis

Os três modelos permitem gerar imagens a partir de texto ou de imagens de referência.

Autenticação

string
obrigatório
Todos os endpoints exigem autenticação com token Bearer.Obtenha uma chave de API em Gerenciamento de chaves de API e adicione-a ao cabeçalho da requisição:

Corpo da requisição

string
obrigatório
Nome do modelo:
  • flux-2-flex
  • flux-2-pro
  • flux-2-max
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de imagem.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Descrição textual da imagem a ser gerada ou da edição a ser aplicada às imagens de referência.
string
padrão:"2MP"
Predefinição da resolução de saída. Valores compatíveis:
  • 1MP
  • 2MP (padrão)
  • 3MP
  • 4MP
Aqui, 1MP corresponde a 1,048,576 pixels.Para compatibilidade com integrações antigas, os seguintes aliases também são aceitos: 512, 512P e 1M equivalem a 1MP; 1K e 1024, a 2MP; 2K e 2048, a 3MP; 4K, a 4MP. Outros valores são rejeitados.A predefinição determina as dimensões de saída quando size contém uma proporção. Ela é substituída quando dimensões exatas em pixels são fornecidas por size ou por width e height.
string
padrão:"1:1"
Proporção ou dimensões em pixels da imagem de saída.size também aceita auto: quando image_urls é fornecido, a proporção da imagem de referência é seguida mantendo o nível atual de resolution; sem imagem de referência, é usado o padrão 1:1.Opções de tamanho compatíveis:
  • 1:1 (padrão)
  • 4:3
  • 3:4
  • 16:9
  • 9:16
  • 3:2
  • 2:3
  • 21:9
  • 9:21
  • auto - seguir a proporção da imagem de referência
Também é possível informar uma string de dimensões, como 1024x1536. As dimensões exatas em pixels estão sujeitas aos mesmos limites de width e height.A prioridade é: o par width + height, uma string de pixels em size, resolution + proporção em size e, por fim, o padrão 2MP + 1:1 (1440×1440).
integer
Largura exata da saída em pixels. Se for informada, height também será obrigatório. Cada dimensão deve ter pelo menos 64 pixels. Informar apenas uma das dimensões faz a tarefa falhar.Um par completo de width e height tem a maior prioridade e substitui resolution e size.
integer
Altura exata da saída em pixels. Se for informada, width também será obrigatório. Cada dimensão deve ter pelo menos 64 pixels. Informar apenas uma das dimensões faz a tarefa falhar.A saída não pode ultrapassar 4 MP (width × height ≤ 4,194,304), e a soma da saída com todas as imagens de referência não pode ultrapassar 9 MP.
array
Imagens de referência para geração a partir de imagens. Forneça-as por URL acessível publicamente ou em Base64.
  • Máximo: 8 imagens
  • A soma da saída com todas as imagens de referência não pode ultrapassar 9 MP
string
padrão:"jpeg"
Formato da imagem de saída: jpeg, png ou webp. O padrão é jpeg.
integer
padrão:"1"
Número de imagens geradas. Somente o valor 1 é aceito.
integer
Semente aleatória. Reutilize a mesma semente e os mesmos parâmetros para obter resultados reproduzíveis; omita-a para usar uma semente aleatória.
boolean
padrão:"false"
Indica se o prompt deve ser aprimorado e reescrito antes da geração. O padrão é false; defina como true para ativar esse recurso. Envie false explicitamente para desativar a reescrita do prompt.
integer
padrão:"2"
Tolerância de segurança de 0 a 5. Valores mais altos são mais permissivos.
integer
padrão:"50"
Número de etapas de amostragem, de 1 a 50. Valores mais altos podem melhorar os detalhes, mas aumentam o tempo de processamento.Este parâmetro só é compatível com flux-2-flex. Não o envie com flux-2-pro ou flux-2-max.
number
padrão:"5.0"
Intensidade de orientação do prompt, de 1.5 a 10. Valores mais altos seguem o prompt com mais fidelidade.Este parâmetro só é compatível com flux-2-flex. Não o envie com flux-2-pro ou flux-2-max.

Tabela de referência de resoluções

Exemplos de uso

Geração de texto para imagem

Geração a partir de imagens de referência

Dimensões exatas de saída

Controles do FLUX.2 Flex

Resposta

integer
Código de status da resposta.
array
Array com o resultado do envio.

Recuperar o resultado

Consulte GET /v1/tasks/{task_id} até que a tarefa atinja o status completed ou failed. Consulte a API de status de tarefas para ver o esquema completo da resposta. Uma tarefa concluída contém uma imagem gerada:
A URL da imagem está em data.result.images[0].url[0]. A expiração é definida pelo timestamp Unix em data.result.images[0].expires_at; baixe a imagem antes desse momento.

Status da tarefa

Exemplo de uma tarefa com falha:
Parâmetros de modelo inválidos não retornam um erro 400 síncrono. O envio retorna HTTP 200 e um task_id; durante a consulta, a tarefa passa para failed. O motivo específico está sempre em error.message, enquanto error.code é task_failed. Tarefas que falham são reembolsadas integralmente.

Observações

  1. As tarefas são processadas de forma assíncrona. A resposta ao envio retorna um task_id para consultar o status.
  2. O parâmetro n deve ser 1; cada requisição gera exatamente uma imagem.
  3. As imagens de referência podem ser fornecidas por URL acessível publicamente ou em Base64.
  4. São permitidas até 8 imagens de referência, respeitando o limite combinado de 9 MP para a entrada e a saída.
  5. As dimensões exatas de saída podem ser definidas com size em pixels ou com width e height fornecidos juntos. Nesse segundo caso, cada dimensão deve ter pelo menos 64 pixels; a saída é limitada a 4 MP.
  6. A expiração da URL do resultado é determinada pelo valor de expires_at retornado na resposta da tarefa.
  7. prompt_upsampling é false por padrão.