📚 API Documentation

Versión 1.0 · Endpoint base: https://studio.leizer.com.mx/api

¿Qué es esta API?

Leizer Studio API te permite usar 45 servicios de IA (quitar fondo, mejorar resolución, restaurar fotos antiguas, generar imágenes con texto, etc.) desde tu app, tienda online, plugin o cualquier sistema vía REST.

Diferencias clave: en español, facturación en MXN, soporte por WhatsApp, pago por uso sin contratos. Más barato que jugadores grandes (Picsart, Cloudinary, Stability) y con la misma calidad porque por debajo usamos los mejores modelos open source (Real-ESRGAN, GFPGAN, Flux, etc.).

Quick start

1. Crea una API key en el panel de developer.

2. Llámanos con tu key vía Bearer:

# Quitar fondo a una imagen curl -X POST "https://studio.leizer.com.mx/api/studio/v1/quitar-fondo" \ -H "Authorization: Bearer lz_sk_TUS_CHARS_AQUI" \ -H "Content-Type: application/json" \ -d '{"input_urls":["https://ejemplo.com/foto.jpg"]}'

3. Recibe el resultado en JSON:

{ "job_id": 12345, "status": "succeeded", "output": ["https://studio.leizer.com.mx/uploads/.../result.png"], "price_cents": 80 }

Autenticación

Todos los endpoints requieren un header Authorization: Bearer YOUR_KEY. Las keys se crean en el panel developer con formato lz_sk_ seguido de 40 caracteres hex.

Importante: la key se muestra solo UNA vez al crearla. Guárdala en variables de entorno, nunca en código del cliente o repos públicos. Si se filtra, revócala desde tu panel y crea una nueva.

Rate limits

Cada API key tiene 2 límites configurables:

Calls por minuto (default 60)
Calls por día (default 10,000)

Si excedes, recibes HTTP 429 Too Many Requests. Los límites se pueden subir desde el panel developer o contactando soporte para volúmenes > 100K calls/día.

Códigos de error

HTTP	Significado	Acción
`200`	OK — el job se procesó	—
`400`	Input inválido (URL mala, faltan params)	Revisa el body
`401`	API key inválida o expirada	Revisa Authorization
`403`	API key no tiene scope para este servicio	Genera key con scope adecuado
`404`	Servicio o job no existe	Verifica el slug
`409`	Servicio aún no disponible (coming soon)	Espera anuncio
`429`	Rate limit excedido	Backoff exponencial
`502`	Replicate falló	Reintenta en 30 seg

Lista de endpoints

POST/api/studio/v1/{slug}

Ejecutar un servicio. Body: { input_urls: [], input_params: {} }. Devuelve job_id + output URLs.

GET/api/studio/v1/jobs/{id}

Consultar status de un job (polling).

Ejecutar un servicio

POST /api/studio/v1/{slug} — reemplaza {slug} con el identificador del servicio (ej. quitar-fondo, upscale-4x). Lista completa en /catalogo.html.

Body

Campo	Tipo	Req	Descripción
`input_urls`	array<string>	Sí*	URLs HTTPS públicas de las imágenes de entrada. *Solo requerido si el servicio acepta imagen.
`input_params`	object	Sí*	Parámetros como `prompt` para servicios de texto. *Solo si el servicio requiere texto.

Respuesta exitosa (200)

{ "job_id": 12345, "status": "succeeded", "output": [ "https://studio.leizer.com.mx/uploads/u42/results/12345_0.png" ], "price_cents": 80 }

Consultar status de un job

GET /api/studio/v1/jobs/{id} — útil para servicios largos (video, packs de 10 imágenes) si el primer POST devuelve pending.

📌 Quitar fondo (`quitar-fondo`)

Recorta el sujeto principal de cualquier foto y deja la imagen con transparencia (PNG con alpha). Excelente para vendedores Mercado Libre / Amazon / Shopify.

curl -X POST "https://studio.leizer.com.mx/api/studio/v1/quitar-fondo" \ -H "Authorization: Bearer YOUR_KEY" \ -d '{"input_urls":["https://ejemplo.com/producto.jpg"]}'

📌 Mejorar resolución (`upscale-4x`)

Aumenta 4× la resolución de fotos pequeñas o borrosas. También disponible upscale-8x.

curl -X POST "https://studio.leizer.com.mx/api/studio/v1/upscale-4x" \ -H "Authorization: Bearer YOUR_KEY" \ -d '{"input_urls":["https://ejemplo.com/foto-pequena.jpg"]}'

📌 Restaurar foto antigua (`restaurar-antigua`)

Repara fotos antiguas, descoloridas o dañadas usando GFPGAN. Excelente para fotos familiares.

📌 Generar imagen (`generar-imagen-rapida`)

Crea imágenes desde texto usando Flux Schnell. Versión HD: generar-imagen-hd.

curl -X POST "https://studio.leizer.com.mx/api/studio/v1/generar-imagen-rapida" \ -H "Authorization: Bearer YOUR_KEY" \ -d '{"input_params":{"prompt":"gato astronauta estilo Pixar, fondo galaxia"}}'

Ejemplos: cURL

Ver ejemplos en cada endpoint arriba ☝️

Ejemplos: Node.js (con fetch)

Ejemplos: PHP

// Con curl nativo, sin dependencias $ch = curl_init('https://studio.leizer.com.mx/api/studio/v1/quitar-fondo'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . $_ENV['LZ_API_KEY'], 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'input_urls' => ['https://ejemplo.com/foto.jpg'] ]), ]); $response = json_decode(curl_exec($ch), true); curl_close($ch); echo $response['output'][0];

Ejemplos: Python (requests)

import requests, os response = requests.post( 'https://studio.leizer.com.mx/api/studio/v1/quitar-fondo', headers={ 'Authorization': f'Bearer {os.environ["LZ_API_KEY"]}', 'Content-Type': 'application/json' }, json={'input_urls': ['https://ejemplo.com/foto.jpg']} ) data = response.json() print(data['output'][0])

Precios B2B (por call)

Pago por uso con descuentos automáticos por volumen mensual. Sin contratos, sin mínimos.

Volumen	Quitar fondo	Mejorar res	Restaurar	Generar IA
< 200 calls	$0.80	$1.40	$3.80	$1.00
200-999	$0.68	$1.19	$3.23	$0.85
1,000-4,999	$0.52	$0.91	$2.47	$0.65
5,000+	$0.40	$0.70	$1.90	$0.50

Precios en MXN sin IVA. El descuento se aplica automáticamente al subir tu volumen mensual.

Facturación

Te enviamos factura CFDI al cierre de cada mes con el detalle de calls + monto a pagar. Pago vía MercadoPago, transferencia o tarjeta con cargo recurrente. Sin sorpresas — ves el costo acumulado en tiempo real desde el panel developer.

¿Listo para integrar?

Crea tu API key, prueba en 5 minutos y solo paga lo que uses.

Crear API key →