Lanzamos workflowsPruébalo ahora

API REST

Genera imágenes
desde tu código

API REST con SDK oficial, webhooks y pricing transparente. Integra Pictulab en tu producto en minutos.

curl https://api.beta.pictulab.com/v1/generate/image \
  -H "Authorization: Bearer $PICTULAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Foto producto fondo blanco, estilo Amazon",
    "model_id": "gemini-2.5-flash-image",
    "aspectRatio": "1:1",
    "resolution": "2k"
  }'
Producción · Beta abierta

Todo lo que esperas de una API moderna

Diseñada para que integrarla sea trivial y operarla en producción no te dé sustos.

Latencia baja, alta concurrencia

Endpoints sync para resultados instantáneos y queue async para batch sin esperar.

Webhooks nativos

Recibe eventos image.generated, run.completed y más en tu endpoint, con firma HMAC-SHA256.

API keys por equipo

Genera múltiples keys con scopes y rate limits independientes desde el dashboard.

Métricas y logs

Histórico completo de llamadas con coste por petición, errores y trazas para debug.

Endpoints principales

Todo el catálogo en la documentación.

POST/v1/generate/image

Genera imágenes con cualquier modelo IA disponible.

POST/v1/upscale/image

Aumenta resolución hasta 6K con fal.ai Clarity y Aura SR.

POST/v1/herramientas/quitar-fondo

Background remover con IA, sin marca de agua.

POST/v1/workflows/:id/run

Dispara un workflow del usuario por ID o webhook.

GET/v1/pricing/image

Consulta el coste estimado en tokens antes de generar.

GET/v1/runs/:id

Estado y outputs de una ejecución asíncrona.

Pricing transparente

Pagas lo que usas

La API se factura por tokens, igual que el dashboard. Sin tarifa fija mensual en el plan Business — solo pagas las llamadas que ejecutan correctamente.

FAQ

Preguntas frecuentes

Crea una cuenta en cloud.pictulab.com, ve a Developers → API Keys y genera una key. Disponible desde el plan Business.

Cada llamada consume tokens según el modelo y la resolución. El endpoint GET /pricing/image te da el coste exacto antes de ejecutar. Las llamadas fallidas (4xx, 5xx) no consumen tokens.

Por defecto, 60 req/min en el plan Business y custom en Enterprise. Cualquier rate limit puede ampliarse bajo demanda.

Sí. Desde el dashboard puedes rotar o revocar keys al instante. Las claves antiguas dejan de aceptar nuevas llamadas.

SDK Node.js y Python en beta. SDKs Go, Ruby y PHP en roadmap. Mientras tanto, cualquier cliente HTTP estándar funciona.

Empieza a integrar hoy

Crea tu API key, lee la documentación y haz tu primera llamada en menos de 5 minutos.