Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
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 |
guidance_scale | Não | O quão à risca o modelo segue o prompt. ≥ 1 · ≤ 20 · Padrão: 3.5 |
loras | Não | Carregue seus arquivos LoRA para fixar um estilo ou personagem. Padrão: [] |
output_format | Não | Tipo de arquivo do resultado. jpeg · png · webp · Padrão: jpeg |
prompt | Sim | Comma-separated tags with score tags first. Put LoRA trigger words at the start. |
seed | Não | Repetir o mesmo número dá um resultado reproduzível. ≥ 0 · ≤ 2147483647 |
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 |
|---|---|---|
| Padrão | 3,6 | US$ 0,036 |
Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 4 créditos por imagem (US$ 0,04).
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 Prefect Pony XL LoRA 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 prefect/pony-xl-lora/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": "prefect/pony-xl-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 Prefect Pony XL LoRA
Quanto custa a API do Prefect Pony XL LoRA?
O Prefect Pony XL LoRA custa 4 créditos (US$ 0,04) 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 Prefect Pony XL LoRA na API?
Coloque prefect/pony-xl-lora/text-to-image para Criar imagem no campo model de POST /jobs/createTask.
Quais LoRAs funcionam aqui?
Arquivos treinados para checkpoints SDXL da família Pony, passados como link de download direto do arquivo .safetensors. LoRAs feitos para outras bases, como Z-Image, FLUX ou Anima, não se transferem: no nosso teste, um deles carregou sem erro e não mudou nada.
Qual a diferença para o Prefect Pony XL?
Este endpoint acrescenta um espaço para LoRA, um controle de guidance e nove proporções. A página do Prefect Pony XL oferece o Prefect Pony XL sem espaço para LoRA. Os dois usam o mesmo estilo de prompt, com as score tags primeiro.
Por que só nove tamanhos?
Os checkpoints SDXL são treinados com um conjunto fixo de formatos em torno de um megapixel. Nos nossos testes, tamanhos maiores desenharam pessoas duplicadas, então o endpoint expõe apenas os tamanhos nativos.
Quais são os limites da API do Prefect Pony XL 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 Prefect Pony XL LoRA sem escrever código?
Dá. O Playground roda o Prefect Pony XL LoRA com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.


