Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La imagen de partida. |
output_format | No | Tipo de archivo del resultado. jpeg · png · webp · Por defecto: jpeg |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 2k · 4k · 8k · Por defecto: 4k |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por imagen | ≈ USD |
|---|---|---|
| Estándar | 1,8 | 0,018 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 2 créditos por imagen (0,02 US$).
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de Image Upscaler en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model popnow/image-upscaler-v1/upscale y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 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"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de Image Upscaler
¿Cuánto cuesta la API de Image Upscaler?
Image Upscaler cuesta 2 créditos (0,02 US$) por imagen. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Image Upscaler en la API?
Pon popnow/image-upscaler-v1/upscale para Mejorar imagen en el campo model de POST /jobs/createTask.
¿Qué significan 2k, 4k y 8k?
Son presupuestos de píxeles, no lienzos fijos: la imagen conserva su proporción y se lleva a unos 4, 17 o 67 megapíxeles. Una foto de 1024×1536 volvió en 1672×2508, 3344×5017 y 6689×10033.
¿Puede quedar más pequeña mi imagen?
Sí, si el nivel está por debajo del original. Una imagen de 3344×5017 enviada en 2k volvió en 1672×2509. Elige un nivel por encima de los píxeles actuales de tu imagen.
¿Cambia lo que se ve en la imagen?
No. La composición, los colores y el sujeto quedan como los enviaste; los bordes y las texturas se afinan y se completa el detalle fino. Si quieres cambiar el contenido, pasa primero por un modelo de edición y escala el resultado al final.
¿Qué formato de salida conviene?
jpeg, el formato predeterminado, mantiene archivos manejables: nuestra prueba en 8k pesó unos 8 MB. png no tiene pérdida, pero pesa varias veces más; un png en 4k de una foto normal ya ronda los 16 MB. webp queda en medio.
¿Puede rescatar un texto diminuto o una cara borrosa?
Solo en parte. Afina lo que contiene el original; el detalle que nunca se captó se inventa, así que unas letras ilegibles pueden volver como formas verosímiles en lugar de las palabras originales. Empieza por la versión más limpia que tengas.
¿Qué límites tiene la API de Image Upscaler?
Resoluciones: 2K · 4K · 8K. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Image Upscaler sin escribir código?
Sí. El Playground ejecuta Image Upscaler con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.

