Expandir imagenAcerca de Image Expander
Amplía una foto a una nueva relación de aspecto: se pinta escenario nuevo alrededor del original en lugar de recortarlo o estirarlo.
Llámalo con el nombre de modelo popnow/image-expander-v1/edit en POST /jobs/createTask, desde 4 créditos por imagen (0,04 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.
Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · Por defecto: 1:1 |
image_url | Sí | La imagen de partida. |
output_format | No | Tipo de archivo del resultado. png · jpeg · webp · Por defecto: png |
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 | 3,6 | 0,036 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 4 créditos por imagen (0,04 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 Expander 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-expander-v1/edit 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-expander-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"aspect_ratio": "1:1",
"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"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 Expander
¿Cuánto cuesta la API de Image Expander?
Image Expander cuesta 4 créditos (0,04 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 Expander en la API?
Pon popnow/image-expander-v1/edit para Expandir imagen en el campo model de POST /jobs/createTask.
¿Puedo indicar qué debe aparecer en la zona nueva?
No. No hay campo de prompt; la extensión continúa lo que ya está en la foto.
¿De qué tamaño es el resultado?
El lado largo siempre mide 1536 píxeles y el corto sigue la proporción que elijas: 1536 × 864 en 16:9, 864 × 1536 en 9:16, 1536 × 1536 en 1:1.
¿Qué proporción elijo?
La que use tu destino: 16:9 para portadas de video y encabezados, 9:16 para historias y reels, 1:1 para feeds y mosaicos de marketplace, 3:2 o 2:3 para diseños de estilo impreso.
¿Qué límites tiene la API de Image Expander?
Relaciones de aspecto: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Image Expander sin escribir código?
Sí. El Playground ejecuta Image Expander con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.