Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | A imagem de partida. |
output_format | Não | Tipo de arquivo do resultado. jpeg · png · webp · Padrão: jpeg |
resolution | Não | Tamanho de saída. Maior fica mais nítido e custa mais. 2k · 4k · 8k · Padrão: 4k |
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 Image Upscaler 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 popnow/image-upscaler-v1/upscale 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": "popnow/image-upscaler-v1/upscale",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "4k",
"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 Image Upscaler
Quanto custa a API do Image Upscaler?
O Image Upscaler custa 2 créditos (US$ 0,02) 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 Image Upscaler na API?
Coloque popnow/image-upscaler-v1/upscale para Melhorar imagem no campo model de POST /jobs/createTask.
O que significam 2k, 4k e 8k?
São orçamentos de pixels, não telas fixas: a imagem mantém a proporção e vai para cerca de 4, 17 ou 67 megapixels. Uma foto de 1024×1536 voltou em 1672×2508, 3344×5017 e 6689×10033.
Minha imagem pode ficar menor?
Sim, se o nível estiver abaixo da original. Uma imagem de 3344×5017 enviada em 2k voltou em 1672×2509. Escolha um nível acima da quantidade de pixels atual da sua imagem.
O conteúdo da imagem muda?
Não. Composição, cores e assunto ficam como você enviou; bordas e texturas ficam mais nítidas e os detalhes finos são completados. Para mudar o conteúdo, passe antes por um modelo de edição e faça o upscale do resultado por último.
Qual formato de saída escolher?
jpeg, o padrão, mantém os arquivos administráveis: nosso teste em 8k ficou com cerca de 8 MB. png não tem perda, mas é várias vezes maior; um png em 4k de uma foto comum já passa de 16 MB. webp fica no meio.
Ele recupera texto minúsculo ou um rosto borrado?
Só em parte. Ele deixa mais nítido o que existe na original; o detalhe que nunca foi capturado é inventado, então letras ilegíveis podem voltar como formas plausíveis em vez das palavras originais. Comece pela versão mais limpa que você tiver.
Quais são os limites da API do Image Upscaler?
Resoluções: 2K · 4K · 8K. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o Image Upscaler sem escrever código?
Dá. O Playground roda o Image Upscaler com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.