Reescalar imagen

POST/v1/upscale/image

Scope: images:generate · consume tokens

Aumenta la resolución de una imagen con un modelo de super-resolución.

Cuerpo

Parámetro	Tipo	Por defecto	Descripción
`imageUrl`	`string`		Obligatorio. URL de la imagen.
`modelId`	`string`		Obligatorio. Modelo de reescalado. Ver `GET /v1/upscale/models`.
`scaleFactor`	`integer`	`4`	Factor de escala, de 2 a 16. `fal-recraft-crisp` lo ignora.
`targetWidth`	`number`		Ancho final (256–16384). Con `targetHeight`, recorta al tamaño exacto.
`targetHeight`	`number`		Alto final (256–16384).
`prompt`	`string`		Guía para el modelo. Solo `fal-clarity-upscaler`.
`creativity`	`number`	`0.35`	De 0 a 1. Solo `fal-clarity-upscaler`.

Ejemplo

curl https://api.beta.pictulab.com/v1/upscale/image \
  -H "Authorization: Bearer $PICTULAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "https://cdn.pictulab.com/…/imagen.png",
    "modelId": "fal-aura-sr",
    "scaleFactor": 4
  }'

Respuesta

{
  "success": true,
  "id": "…",
  "url": "https://cdn.pictulab.com/…",
  "width": 4096,
  "height": 4096,
  "mimeType": "image/png",
  "fileSize": 12582912,
  "tokensUsed": 2,
  "model": "fal-aura-sr",
  "provider": "falai"
}

Si el proveedor falla, los tokens se devuelven.