Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
seed | Não | Repetir o mesmo número dá um resultado reproduzível. ≥ 0 · ≤ 2147483647 |
prompt | Sim | Describe the subject, setting, light and style in plain sentences. |
resolution | Não | Tamanho de saída. Maior fica mais nítido e custa mais. 1k · 2k · Padrão: 1k |
aspect_ratio | Não | O formato do quadro: horizontal, quadrado ou vertical. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Padrão: 1:1 |
Preços
Os preços são em créditos, os mesmos que você usa no site (1 crédito = US$ 0,01). O valor é reservado quando a tarefa é aceita e acertado pelo custo real quando ela termina; tarefas com falha são reembolsadas.
| Opção | Créditos por imagem | ≈ USD |
|---|---|---|
| resolution 1K | 1,65 | US$ 0,017 |
| resolution 2K | 1,83 | US$ 0,018 |
Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 2 créditos por imagem (US$ 0,02).
Para saber o valor exato antes de rodar, envie o mesmo corpo para POST /jobs/quote.
Início rápido da API
Chame a API do FLUX.2 Klein 9B em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow- e usam os mesmos créditos do site.
- Envie a requisição. Faça POST /jobs/createTask com model black-forest-labs/flux-2-klein-9b/text-to-image e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-2-klein-9b/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"resolution": "1k"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do FLUX.2 Klein 9B
Quanto custa a API do FLUX.2 Klein 9B?
O FLUX.2 Klein 9B custa a partir de 2 créditos (US$ 0,02) por imagem com Criar imagem, a tarefa mais barata. Preços por opção: 1K 1,65 crédito por imagem, 2K 1,83 crédito por imagem. Os créditos são os mesmos do site (1 crédito = US$ 0,01), contas novas ganham 30 créditos grátis e tarefas que falham são reembolsadas.
Qual é o nome de modelo do FLUX.2 Klein 9B na API?
Coloque black-forest-labs/flux-2-klein-9b/text-to-image para Criar imagem; black-forest-labs/flux-2-klein-9b/edit para Editar imagem no campo model de POST /jobs/createTask.
Ele escreve texto nas imagens?
Textos curtos entre aspas costumam funcionar: nosso lookbook saiu com o título e as quatro legendas escritos corretamente, e um letreiro de neon saiu limpo na terceira seed que testamos. Não é confiável todas as vezes, então planeje testar algumas seeds.
Ele segue códigos de cor hexadecimais?
Mais ou menos. Um fundo cor de areia pedido saiu na direção certa, mas não no valor exato, então não o use onde for preciso uma cor de marca precisa.
Quantas imagens de referência posso usar?
De uma a três numa edição. Mencione-as no prompt na ordem em que as enviou.
Quais são os limites da API do FLUX.2 Klein 9B?
Resoluções: 1K · 2K; Proporções: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Tamanho do prompt (caracteres): 5,000. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o FLUX.2 Klein 9B sem escrever código?
Dá. O Playground roda o FLUX.2 Klein 9B com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.
Todos os modelos FLUX
- API do FLUX.2 MaxFLUX topo de linha: luz fotorrealista e cores de marca exatasA partir de 11 créditos por imagem
- API do FLUX 3Vídeo com som sincronizado e um nível de rascunho rápidoA partir de 45 créditos por um clipe de 5 segundos
- API do FLUX.2 Klein 9B LoRAFLUX.2 Klein 9B rápido que carrega até três LoRAs seusA partir de 3 créditos por imagem
- API do FLUX.2 Klein Base 9B LoRAKlein 9B sem destilação para visuais variados com seus LoRAsA partir de 4 créditos por imagem
- API do FLUX.2 Klein 4B LoRAFLUX.2 Klein 4B pequeno e rápido com seus próprios LoRAsA partir de 3 créditos por imagem
- API do FLUX.2 Klein Base 4B LoRAKlein 4B sem destilação que carrega seus LoRAsA partir de 3 créditos por imagem
- API do FLUX.2 Klein 9BEdições rápidas com FLUX que preservam rostos e posesA partir de 2 créditos por imagem
- API do FLUX.2 Klein 4BO FLUX menor e mais rápido, para rascunhos ágeisA partir de 2 créditos por imagem
- API do FLUX.2 Dev LoRAImagens e edições com FLUX.2 Dev e seus próprios LoRAsA partir de 4 créditos por imagem
- API do FLUX.2 ProImagens fotorrealistas com texto legível e controle de cor hexA partir de 5 créditos por imagem
- API do FLUX.2 FlexEscreve títulos e rótulos exatamente como você digitouA partir de 9 créditos por imagem
- API do FLUX.2 DevFLUX de pesos abertos que junta várias pessoas em uma cenaA partir de 2 créditos por imagem
- API do FLUX.1 Krea Dev LoRAFLUX.1 Krea fotográfico com seus próprios LoRAsA partir de 4 créditos por imagem
- API do FLUX.1 Dev ControlNet LoRAControle de pose, profundidade ou contornos no FLUX.1, com seus LoRAsA partir de 6 créditos por imagem
- API do FLUX.1 Fill Dev LoRAInpainting com máscara no FLUX.1 Fill e seus próprios LoRAsA partir de 7 créditos por imagem
- API do FLUX.1 Dev LoRAO clássico FLUX.1 Dev com até três LoRAs seusA partir de 3 créditos por imagem
- API do FLUX.1 Schnell LoRAFLUX.1 Schnell rápido que carrega seus próprios LoRAsA partir de 1 crédito por imagem

