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 |
size | Não | Output image size in pixels, written as width*height. All values are native SDXL shapes. 1024*1024 · 896*1152 · 1152*896 · 832*1216 · 1216*832 · 768*1344 · 1344*768 · Padrão: 1024*1024 |
prompt | Sim | Describe the image as comma-separated tags: quality tags first, then subject and wardrobe, then lighting and lens. |
output_format | Não | Tipo de arquivo do resultado. png · jpeg · webp · Padrão: png |
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 | 2,25 | US$ 0,023 |
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 Prefect Pony XL 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/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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"size": "1024*1024",
"output_format": "png"
}
}'
# 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
Quanto custa a API do Prefect Pony XL?
O Prefect Pony XL custa 3 créditos (US$ 0,03) 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 na API?
Coloque prefect/pony-xl/text-to-image para Criar imagem no campo model de POST /jobs/createTask.
Como devo escrever os prompts?
Em estilo tag, separadas por vírgula, tags de qualidade primeiro. Ele foi treinado do jeito que se treinam os checkpoints SDXL locais, então os hábitos de prompt daquele ecossistema se transferem direto. Frases descritivas longas funcionam, mas conduzem mais fraco do que as tags.
Consigo a mesma imagem duas vezes?
Sim — passe a mesma seed com o mesmo prompt e o mesmo tamanho. Deixe a seed de fora e cada chamada devolve um quadro diferente. Guarde a seed junto de qualquer quadro que você queira poder reconstruir.
Posso enviar uma imagem de referência?
Não. Este endpoint é apenas text-to-image; não há entrada de imagem, nem inpainting, nem condicionamento em estilo ControlNet. Para edições guiadas por imagem, use um dos endpoints image-to-image do catálogo.
Quais tamanhos estão disponíveis e por que estes?
Sete tamanhos, todos na contagem de pixels nativa do SDXL: 1024*1024, 896*1152, 1152*896, 832*1216, 1216*832, 768*1344 e 1344*768. Pedir uma proporção fora do treino em um modelo SDXL é onde a anatomia costuma desmoronar, então o endpoint expõe as formas treinadas em vez de largura e altura arbitrárias.
Quais são os limites da API do Prefect Pony XL?
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 sem escrever código?
Dá. O Playground roda o Prefect Pony XL com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.

