Guia da API FLUX 3 Image Klein: preços em cinco faixas de resolução, parâmetros e exemplos de chamada

O que é o FLUX 3 Image Klein

FLUX 3 Image Klein é o modelo de imagem leve da série FLUX 3 da Black Forest Labs. No HiAPI há apenas um ID de modelo: flux-3-image-klein, usado tanto para gerar imagens a partir de texto quanto para edição com imagem de referência. Apenas com o prompt, é geração texto-para-imagem; adicionando image_urls, é edição da cena com base em imagens de referência ou fusão do estilo de várias imagens.

Sua vantagem é ser barato e ter muitas faixas: de 768 a 4K, são cinco faixas de resolução, adequadas para geração em lote e para o fluxo de testar com imagens pequenas e depois finalizar com imagens grandes.

Preço: por faixa de resolução, cobrado por imagem

• 768: $0.0092 / imagem
• 1K (padrão): $0.0103 / imagem
• 1.5K: $0.0126 / imagem
• 2K: $0.016 / imagem
• 4K: $0.0412 / imagem

Imagens de referência não são cobradas à parte; 1 ou 10 imagens custam o mesmo. Reduzir steps também não deixa mais barato; o preço depende apenas de resolution. Tarefas com falha são reembolsadas integralmente.

Por exemplo: testar 50 imagens de estilo na faixa 768 custa $0.46; escolher 5 e gerar a versão final em 4K custa $0.206.

Parâmetros

Exceto model e prompt, todos são parâmetros opcionais:

• prompt: obrigatório, 1–5000 caracteres.
• resolution: 768, 1K, 1.5K, 2K, 4K; padrão 1K.
• aspect_ratio: 16 valores possíveis, incluindo 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21 e auto (padrão).
• image_urls: 1–10 imagens de referência acessíveis publicamente; se omitido, é geração puramente texto-para-imagem.
• steps: 1–16, padrão 16. Menos passos geram mais rápido, mas podem reduzir detalhes.
• seed: 0–4294967295. Com a seed fixa, os mesmos parâmetros tentam reproduzir resultados semelhantes; se omitido, é aleatório.
• safety_tolerance: 0–4, padrão 2. Quanto maior o número, mais permissiva é a moderação.
• output_format: jpeg (padrão) ou png.

Exemplos de requisição

Tarefas de imagem são assíncronas: primeiro crie a tarefa, depois consulte o resultado. model fica no nível superior e os demais parâmetros vão em input.

Texto para imagem, 2K, retrato 4:5, seed fixa:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image-klein",
    "input": {
      "prompt": "Uma caneca de cerâmica sobre uma mesa de madeira iluminada pela luz da manhã, profundidade de campo rasa, tons quentes, fotografia de produto",
      "resolution": "2K",
      "aspect_ratio": "4:5",
      "seed": 42
    }
  }'

Esta imagem custa $0.016.

Edição com imagem de referência, fundindo o estilo de duas imagens:

{
  "model": "flux-3-image-klein",
  "input": {
    "prompt": "Mantenha a estrutura arquitetônica da primeira imagem e redesenhe com as pinceladas de aquarela e a paleta da segunda imagem",
    "image_urls": [
      "https://example.com/building.jpg",
      "https://example.com/watercolor.jpg"
    ],
    "resolution": "1.5K",
    "output_format": "png"
  }
}

Após a criação bem-sucedida, use o ID da tarefa retornado para consultar GET https://api.hiapi.ai/v1/tasks/{taskId} em polling; quando concluída, obtenha o endereço da imagem na saída.

Recomendações de uso

• Primeiro pequeno, depois grande: teste o prompt com 768 ou 1K e seed fixa; quando estiver satisfeito, altere apenas resolution para 2K ou 4K e gere novamente.
• Variações em lote: use o mesmo prompt com seed diferentes para obter um conjunto de candidatos com composições distintas e estilo consistente.
• Ao editar imagens, especifique claramente o que manter: com imagens de referência, indique no prompt o que deve ser mantido e o que deve ser alterado; isso é mais estável do que apenas descrever a cena desejada.

Limitações atuais

• Cada chamada retorna uma imagem.
• No máximo 10 imagens de referência, que devem ser endereços http(s) públicos.
• Não há opção de fundo transparente; png é apenas um formato sem perdas alternativo.