Listar modelos

Modelos de imagen

GET/v1/models

Gratis · sin scope

Parámetros de consulta

Parámetro	Tipo	Por defecto	Descripción
page	number	1	Página.
pageSize	number	10	Resultados por página (máx. 200).
teamId	string		ID de tu equipo, para excluir modelos bloqueados para él.
includeInactive	boolean	false	Incluye modelos inactivos.

curl "https://api.beta.pictulab.com/v1/models?pageSize=200" \
  -H "Authorization: Bearer $PICTULAB_API_KEY"

Respuesta

{
  "rows": [
    {
      "model_id": "gemini-2.5-flash-image",
      "provider": "gemini",
      "display_name": "Nano Banana",
      "is_active": true,
      "supports_reference_images": true,
      "supports_editing": true,
      "max_reference_images": 4,
      "max_reference_mb": 10,
      "supported_reference_formats": ["image/png", "image/jpeg", "image/webp"],
      "max_prompt_length": 2000,
      "supported_aspect_ratios": ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9"],
      "max_resolution": "1K",
      "supports_resolution": true,
      "custom_size": null,
      "created_at": "…"
    }
  ],
  "total": 18,
  "page": 1,
  "pageSize": 200,
  "totalPages": 1
}

Los valores del ejemplo son ilustrativos. custom_size es null o un objeto { multiple, max_edge, max_ratio, min_pixels, max_pixels } para modelos que aceptan tamaño exacto.

Modelos de reescalado

GET/v1/upscale/models

Gratis · sin scope

{
  "rows": [
    { "id": "fal-clarity-upscaler", "provider": "falai", "label": "…", "description": "…", "speedSec": 15 },
    { "id": "fal-aura-sr", "provider": "falai", "label": "…", "description": "…", "speedSec": 3 },
    { "id": "fal-ccsr", "provider": "falai", "label": "…", "description": "…", "speedSec": 6 },
    { "id": "fal-recraft-crisp", "provider": "falai", "label": "…", "description": "…", "speedSec": 8 }
  ]
}

speedSec es el tiempo aproximado de procesamiento en segundos.