Pegue sua chave de API

da Black Forest Labs

O clássico FLUX.1 Dev com até três LoRAs seus

black-forest-labs/flux-1-dev-lora/text-to-imageA partir de 3 créditospor imagem · US$ 0,03
  • 9 proporções
  • Carrega seus próprios LoRAs
  • Criar imagem
  • Editar imagem

Sobre o FLUX.1 Dev LoRA

O FLUX.1 Dev LoRA roda o FLUX.1 [dev] da Black Forest Labs, um modelo de 12 bilhões de parâmetros, com até três arquivos LoRA seus por requisição. Há mais de mil LoRAs da comunidade no Hugging Face feitos para esta base, de realismo de cinema e visuais de moda a estilos de desenho animado e personagens.

Chame com o nome de modelo black-forest-labs/flux-1-dev-lora/text-to-image em POST /jobs/createTask, a partir de 3 créditos por imagem (US$ 0,03). Contas novas ganham 30 créditos grátis para você testar primeiro no Playground.

Por enquanto este guia está só em inglês. →

Parâmetros da requisição

ParâmetroObrigatórioDescrição
aspect_ratioNãoO 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
guidance_scaleNãoO quão à risca o modelo segue o prompt. ≥ 0 · ≤ 20 · Padrão: 3.5
lorasNãoCarregue seus arquivos LoRA para fixar um estilo ou personagem. Padrão: []
output_formatNãoTipo de arquivo do resultado. jpeg · png · webp · Padrão: jpeg
promptSimDescribe the subject, composition and lighting. If a LoRA has a trigger word, put it first.
seedNãoRepetir o mesmo número dá um resultado reproduzível. ≥ 0 · ≤ 2147483647
stepsNãoMais etapas trazem mais detalhe, mas demoram mais. ≥ 1 · ≤ 50 · Padrão: 28

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çãoCréditos por imagem≈ USD
Padrão2,7US$ 0,027

Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 3 créditos por imagem (US$ 0,03).

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.1 Dev LoRA em três passos

  1. 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.
  2. Envie a requisição. Faça POST /jobs/createTask com model black-forest-labs/flux-1-dev-lora/text-to-image e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
  3. 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-1-dev-lora/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "output_format": "jpeg"
  }
}'

# 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.1 Dev LoRA

Quanto custa a API do FLUX.1 Dev LoRA?

O FLUX.1 Dev LoRA custa a partir de 3 créditos (US$ 0,03) por imagem com Criar imagem, a tarefa mais barata. 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.1 Dev LoRA na API?

Coloque black-forest-labs/flux-1-dev-lora/text-to-image para Criar imagem; black-forest-labs/flux-1-dev-lora/edit para Editar imagem no campo model de POST /jobs/createTask.

Quais LoRAs funcionam aqui?

LoRAs treinados para o FLUX.1 [dev], que formam o maior grupo de LoRAs de imagem da comunidade. Passe um link de download direto para o arquivo .safetensors. LoRAs de SDXL, Z-Image ou Qwen-Image não se transferem.

Posso usar as imagens comercialmente?

A licença do FLUX.1 [dev] da Black Forest Labs permite usar as imagens geradas para fins pessoais, científicos e comerciais. A licença de cada LoRA que você carrega é definida pelo autor dele, então confira a página do modelo.

O que o guidance faz?

Define o quanto a imagem segue o prompt à risca. O padrão 3,5 serve para a maioria dos LoRAs; LoRAs de realismo costumam ficar mais naturais um pouco abaixo, por volta de 2 a 3.

Quais são os limites da API do FLUX.1 Dev LoRA?

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.1 Dev LoRA sem escrever código?

Dá. O Playground roda o FLUX.1 Dev LoRA 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

Mais sobre o FLUX.1 Dev LoRA