Introducción
La API de Pictulab permite integrar la generación de imágenes con IA en tu producto: generar imágenes, reescalarlas, lanzar trabajos asíncronos y ejecutar los workflows que hayas creado en el panel.
URL base
Sección titulada «URL base»https://api.beta.pictulab.comLos endpoints viven bajo dos prefijos:
/v1: generación síncrona, catálogo de modelos, precios y consulta de workflows./v2: trabajos asíncronos (jobs) y ejecución de workflows.
Formato
Sección titulada «Formato»- Peticiones y respuestas en JSON (
Content-Type: application/json). Cuerpo máximo: 10 MB en/v1y 5 MB en/v2. - Las respuestas correctas devuelven el objeto directamente, sin envoltorio.
- Los errores siguen un formato común. Ver Errores.
- Cada respuesta incluye la cabecera
X-Request-Id. Puedes enviar tu propio UUID en esa cabecera para correlacionar peticiones.
Endpoints
Sección titulada «Endpoints»| Método | Endpoint | Descripción |
|---|---|---|
POST |
/v1/generate/image |
Genera imágenes (síncrono) |
POST |
/v1/upscale/image |
Reescala una imagen |
GET |
/v1/models |
Modelos de imagen disponibles |
GET |
/v1/upscale/models |
Modelos de reescalado |
GET |
/v1/pricing/image |
Coste de una generación |
GET |
/v1/pricing/upscale |
Coste de un reescalado |
POST |
/v2/jobs |
Crea un job asíncrono |
GET |
/v2/jobs/:jobId |
Estado y resultado de un job |
GET |
/v2/jobs |
Lista los jobs del equipo |
POST |
/v2/jobs/:jobId/cancel |
Cancela un job en cola |
GET |
/v1/teams/:teamId/workflows/:workflowId/schema |
Entradas que acepta un workflow |
POST |
/v2/workflows/:workflowId/run |
Ejecuta un workflow |
GET |
/v1/teams/:teamId/workflows/:workflowId/runs/:id |
Estado de una ejecución |