FLUX 3 Image Klein

Exemplo rápido

Envie uma requisição de imagem, salve o id retornado e consulte até a tarefa estar completed ou failed. Esta API usa tarefas assíncronas e saídas em URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

Endpoint e cabeçalhos

POST https://api.seedrouter.ai/v1/images/generations

Mantenha a chave no servidor. Um sucesso HTTP confirma uma tarefa; não significa que a imagem está pronta.

Parâmetros

São aceitos 11 campos. Só model e prompt são obrigatórios. Omita os opcionais para usar os padrões; null não é aceito.

Proporções: auto, 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.

O Playground tem modelo fixo e dez controles, incluindo n fixo em 1. Valores de segurança acima de 2 são exclusivos da API, exceto para administradores.

Modos e restrições

Sem referências, a geração é por texto. Uma referência permite editar; várias permitem compor com diversas imagens. Com auto, a edição segue a proporção da primeira referência. Só com texto, o prompt define o quadro; se não for possível determinar, usa 1:1. A resolução padrão é 1k em todos os modos.

As faixas representam escala aproximada: 768sq equivale a cerca de 768 × 768; 1K a 1 MP; 1.5K a 2 MP; 2K a 4 MP; 4K a 16 MP. Confira as dimensões reais no arquivo retornado.

Este endpoint não aceita width, height, dimensões em pixels em size, negative_prompt, guidance, grounding, prompt_upsampling, mask ou mask_url. Campos desconhecidos retornam HTTP 400 antes da cobrança. Não há saída WebP, entrada base64, streaming ou callbacks.

Imagens de referência e edições por região

Envie as referências para uma URL pública antes de submeter. O corpo contém URLs, nunca bytes de arquivos ou data URLs.

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

Troque as URLs de exemplo por suas imagens acessíveis. As referências têm ordem: ref_image_0 é a primeira. Instruções de caixas delimitadoras pertencem à string prompt, não a um campo separado. As coordenadas usam [y1, x1, y2, x2], normalizadas para 0–1000. Um objeto de layout pode conter id, bbox e desc; uma edição pode usar id, from, src_bbox, tgt_bbox e desc. Codifique a requisição inteira em JSON para escapar as aspas do prompt corretamente.

Cobrança

Uma requisição bem-sucedida produz uma imagem. Só a resolução escolhida define o preço; etapas, seed, proporção, referências e formato não adicionam taxas. Texto para imagem e edição têm a mesma tarifa. Requisições com falha não são cobradas. Veja os preços atuais.

Resposta da tarefa e consulta

Envio:

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Tarefa concluída (URL ilustrativa):

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

Leia output.data[0].url. Reserve até dez minutos para geração, especialmente em 4K. A consulta é somente leitura; um timeout do cliente não autoriza outra requisição paga. Respostas públicas não incluem custos ou saldos da conta.

Erros

Erros HTTP usam {"error": {"code": integer, "message": string}}. Veja o diretório comum de erros. Uma tarefa com falha expõe o erro junto a status: "failed". Corrija parâmetros inválidos antes de reenviar; guarde o ID ao consultar requisições já enviadas.

Dicas e guias relacionados

Use descrições positivas e indique regiões ou detalhes a preservar. Reduzir etapas pode alterar a qualidade sem baixar o preço. Compare uma mudança por vez.

• FLUX 3 Image Klein Playground
• Guia de download, pesos e ComfyUI
• Ciclo de vida das tarefas