krea/2-large/text-to-imageA partir de 9 créditos por imagem

O Krea 2 Large é a faixa de maior detalhe da linha Krea 2: um único endpoint text-to-image, prompts de 5.000 caracteres e oito proporções, incluindo a anamórfica 2.35:1. Feito para o quadro que vai ser entregue.

Chame com o nome de modelo krea/2-large/text-to-image em POST /jobs/createTask, a partir de 9 créditos por imagem (US$ 0,09). Contas novas ganham 30 créditos grátis para você testar primeiro no Playground.

  • Criar imagem
  • Até 10 imagens de referência
  • 8 proporções

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 · 4:3 · 3:2 · 16:9 · 2.35:1 · 4:5 · 2:3 · 9:16 · Padrão: 1:1
promptSimDescribe the image to generate: subject, composition, style, and lighting.
reference_image_urlsNãoImagens das pessoas, roupas ou lugares que o resultado deve manter.
reference_strengthNãoHow strongly the reference images shape the result, from 0 to 1. At 1 the composition can carry over too; lower values mostly keep the palette and texture. ≥ 0 · ≤ 1 · Padrão: 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çãoCréditos por imagem≈ USD
Padrão9US$ 0,09

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 Krea 2 Large 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 krea/2-large/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": "krea/2-large/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1"
  }
}'

# 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 Krea 2 Large

Quanto custa a API do Krea 2 Large?

O Krea 2 Large custa 9 créditos (US$ 0,09) 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 Krea 2 Large na API?

Coloque krea/2-large/text-to-image para Criar imagem no campo model de POST /jobs/createTask.

Qual a diferença entre o Large e o Krea 2 Medium e o Medium Turbo?

Os três recebem um prompt e devolvem uma imagem. O Large é o mais lento e tem o teto mais alto de detalhe e material. O Medium Turbo é a faixa rápida e divide com o Large as oito proporções, 2.35:1 incluída, e as referências de estilo. O Medium tem cinco proporções e nenhuma entrada de referência, mas deixa você escolher png ou jpeg.

Por que não existe seed neste endpoint?

A API da própria Krea tem um, mas este endpoint não o expõe, então nada aqui pode ser fixado. O quadro que você quer manter precisa ser guardado — armazene o prompt com o ativo, porque rodar de novo vai desenhar outra coisa.

Posso passar uma imagem de referência?

Sim, até dez, e o campo é opcional. Com a reference_strength padrão de 1, elas trazem a própria composição além da paleta, do grão, do material e da luz; diminua o valor para ficar principalmente com a cor e a textura — em 0,2 a disposição segue em grande parte o prompt, embora o estilo continue bem visível. As dez pesam igual, então dois ou três ângulos de um mesmo visual rendem mais que uma pilha de quadros quase idênticos.

Existe controle de criatividade ou de aderência?

Não. A chave de criatividade da Krea é uma categoria discreta de quatro níveis sem mapeamento confiável para uma escala numérica conhecida, e um controle apontando para o lado errado é pior que nenhum. A faixa padrão é usada.

Qual o tamanho máximo de um prompt?

Até 5.000 caracteres. Gaste em filme, lente, direção de luz e material; encher de adjetivos é onde uma descrição começa a brigar consigo mesma nesta faixa.

Quais são os limites da API do Krea 2 Large?

Proporções: 1:1 · 4:3 · 3:2 · 16:9 · 2.35:1 · 4:5 +2; Imagens de referência: 10; Tamanho do prompt (caracteres): 5,000. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.

Dá para testar o Krea 2 Large sem escrever código?

Dá. O Playground roda o Krea 2 Large 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 Krea

O Krea 2 Medium Turbo aceita os mesmos prompts e referências, muito mais rápido e barato, e por isso é o lugar para explorar. O Large é para o quadro final.

Mais sobre o Krea 2 Large