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 |
image_urls | Sim | Fotos para editar ou combinar. Diga no prompt o que cada uma traz. |
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 | Say what to change and what to keep. With several images, refer to them as image 1, image 2 and so on. |
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 | 1,8 | 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 P-Image 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 pruna-ai/p-image-lora/edit 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": "pruna-ai/p-image-lora/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"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 P-Image LoRA
Quanto custa a API do P-Image LoRA?
O P-Image LoRA custa a partir de 2 créditos (US$ 0,02) por imagem com Editar 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 P-Image LoRA na API?
Coloque pruna-ai/p-image-lora/text-to-image para Criar imagem; pruna-ai/p-image-lora/edit para Editar imagem no campo model de POST /jobs/createTask.
Quais LoRAs funcionam aqui?
No texto para imagem, LoRAs feitos com o treinador P-Image da Pruna e, nos nossos testes, LoRAs da comunidade treinados para o Z-Image Turbo e salvos no layout usual do diffusers. Na edição, LoRAs treinados para o Qwen-Image-Edit. Um LoRA para FLUX, para um modelo SDXL ou para o outro endpoint faz a requisição falhar em vez de carregar.
Posso carregar mais de um LoRA?
Não. Os modelos aceitam um arquivo de pesos por requisição. Se precisar de dois visuais ao mesmo tempo, una os LoRAs num único arquivo antes.
Meu LoRA está num repositório privado do Hugging Face. O que posso fazer?
Envie o arquivo .safetensors para um lugar que o sirva sem login e use esse link direto. Não aceitamos tokens de acesso de contas de terceiros.
Quais são os limites da API do P-Image LoRA?
Proporções: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3; Imagens de referência: 5; Tamanho do prompt (caracteres): 5,000; Maior upload: 10 MB. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o P-Image LoRA sem escrever código?
Dá. O Playground roda o P-Image LoRA com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.


