Black Forest Labs

FLUX.2 Klein 9B

flux-2-klein-9b/text-to-image

Modelo de imagem de fluxo retificado com 9 bilhões de parâmetros, com destilação de passos reduzida a 4, unificando texto-para-imagem e edição com uma ou várias imagens de referência em uma arquitetura compacta, voltado para cenários de geração em tempo real com baixa latência

flux-2-klein-9b/image-to-image flux-2-klein-9b/text-to-image

Experimentar flux-2-klein-9b/text-to-image

Entrada

Criações

Ver todas as criações

Saída

image

Preencha os parâmetros e gere — os resultados aparecerão aqui.

Preços

flux-2-klein-9b/text-to-image per image

Preço unitário	$0.00858

Visão geral

Rota de geração puramente texto-para-imagem do FLUX.2 klein 9B, lançada pela Black Forest Labs, focada no equilíbrio entre qualidade e latência. Ela gera imagens diretamente a partir de prompts de texto, oferece seleção de proporção de aspecto de 1:1 a 16:9 e três formatos de saída: jpeg, png e webp; o número de etapas de inferência pode ser definido entre 4 e 8, e o padrão de 4 etapas já conclui a geração. É adequada para produção em lote de conteúdo sensível à velocidade de geração, ilustrações de marketing e exploração visual em fase de prototipagem; desenvolvedores podem integrá-la por meio da interface unificada do HiAPI.ai.

Destaques principais

Inferência com poucas etapas, voltada a cenários sensíveis à latência — o design de destilação de etapas permite concluir a geração em 4 etapas, com o parâmetro ajustável entre 4 e 8, facilitando o trade-off entre velocidade e detalhes.
Seed fixo para geração reproduzível — oferece o parâmetro seed; combinações iguais de prompt e seed reproduzem o resultado, o que facilita testes de regressão e comparação de versões.
Parâmetros de saída alinhados ao pipeline de engenharia — as proporções de aspecto cobrem as composições usuais 1:1, 4:3, 3:4, 16:9 e 9:16, e a saída pode ser escolhida diretamente entre jpeg, png ou webp, dispensando transcodificação adicional.

Descrição das capacidades

Geração de texto para imagem: basta enviar um prompt de texto para obter a imagem correspondente, sem imagem de referência obrigatória; apenas o prompt é necessário, pois os demais parâmetros têm valores padrão, o que reduz o custo de integração.

Controle de etapas de inferência e seed: num_inference_steps pode ser ajustado entre 4 e 8 para alterar o nível de refinamento da geração, e seed serve para fixar a aleatoriedade, sendo adequado a avaliações e depurações que exigem reprodução estável.

Proporção de composição e formato de saída: aspect_ratio cobre cinco proporções verticais, horizontais e quadradas, e output_format aceita jpeg, png e webp, permitindo que o resultado gerado atenda diretamente aos requisitos de posicionamento na página e de armazenamento.

Cenários de aplicação

Produção em lote de ilustrações para equipes de conteúdo — gerar ilustrações em lote a partir de descrições de produtos ou temas e, após especificar proporção e formato de saída, usá-las diretamente em artigos, landing pages e materiais para redes sociais.
Exploração de rascunhos visuais para protótipos de produto — usar prompts curtos para gerar rapidamente várias propostas de composição e, com seed fixo, reproduzir estilos candidatos para triagem de direções antes da revisão de design.
Integração em aplicações com geração em tempo real ou de alta frequência — para funcionalidades online sensíveis à latência, gerar imagens com a inferência padrão de 4 etapas e ajustar as etapas conforme necessário para controlar qualidade e tempo de execução.

Limitações e recomendações de seleção

Esta rota gera imagens apenas a partir de texto e não aceita imagens de referência; para editar imagens existentes ou alterar estilo, deve-se usar a rota imagem-para-imagem da mesma série. As etapas de inferência suportam apenas de 4 a 8, sem ajuste de amostragem prolongada mais refinado; além do prompt, não há parâmetros como prompt negativo. O model card impõe restrições a usos fora do escopo, e é necessário verificar o texto original da licença antes do uso comercial. Se a tarefa exigir saídas de outras modalidades, como vídeo ou áudio, este modelo não se aplica.

Perguntas frequentes

Ver todas as perguntas →

Quantas imagens de referência o FLUX.2 [klein] 9B de edição de imagens suporta?

Atualmente suporta 1 imagem de referência em JPEG, PNG ou WebP. image_urls deve ser um array contendo apenas uma URL pública de imagem.
Para quais tarefas de edição é adequado?

Adequado para limpeza de imagens de produtos, substituição de fundo, reescrita de texto na imagem, alteração de esquema de cores e retoque comercial que exige preservar o sujeito e o enquadramento da câmera.
Como configurar o número de etapas de inferência?

num_inference_steps aceita números inteiros de 4 a 8, com padrão 4. O preço atual não varia com o número de etapas de inferência.
Quais proporções e formatos são suportados?

As proporções suportadas são 1:1, 4:3, 3:4, 16:9 e 9:16; os formatos suportados são JPEG, PNG e WebP.

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: flux-2-klein-9b/text-to-image

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para flux-2-klein-9b/text-to-image e a rota default — veja a tabela de parâmetros abaixo.

seedintegerOpcional

Semente aleatória, usada para a reprodutibilidade do resultado gerado; assume um número inteiro.

promptstringObrigatório

Prompt de texto usado para a geração da imagem; assume uma string.

aspect_ratiostringOpcionalPadrão: "4:3"

Proporção largura-altura da imagem gerada; assume o formato de string. Padrão 4:3.

Opções:1:14:33:416:99:16

output_formatstringOpcionalPadrão: "png"

Formato de saída da imagem gerada; assume o formato de string. Padrão png.

Opções:jpegpngwebp

num_inference_stepsintegerOpcionalPadrão: 4min 4max 8

Número de etapas de inferência; assume um número inteiro entre 4 e 8. Padrão 4.

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-2-klein-9b/text-to-image",
  "input": {
    "prompt": "…",
    "aspect_ratio": "4:3",
    "output_format": "png",
    "num_inference_steps": 4
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "flux-2-klein-9b/text-to-image",
    input: {
      "prompt": "…",
      "aspect_ratio": "4:3",
      "output_format": "png",
      "num_inference_steps": 4
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "flux-2-klein-9b/text-to-image",
        "input": {
          "prompt": "…",
          "aspect_ratio": "4:3",
          "output_format": "png",
          "num_inference_steps": 4
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}