Conectá tu próximo proyecto.
Creá y editá diseños desde scripts, automatizaciones o asistentes compatibles. Cada clave accede únicamente a los proyectos de su cuenta.
Tus claves
Copiá tu clave ahora
Solo se muestra una vez. Guardala en los secretos de tu herramienta; no la publiques ni la pegues en un chat.
Hasta 10 claves activas. Revocar una clave corta su acceso sin borrar tus proyectos.
De una clave a un diseño.
Guardá la clave como variable de entorno LUMA_API_KEY en tu servidor o herramienta. Reemplazá BASE por esta dirección:
1. Verificar acceso
curl "$BASE/api/v1/me" \ -H "Authorization: Bearer $LUMA_API_KEY"
2. Crear un proyecto
Requiere una clave con lectura y escritura. La respuesta incluye el id del proyecto.
curl "$BASE/api/v1/projects" \
-H "Authorization: Bearer $LUMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Mi primer diseño"}'3. Leer el documento
curl "$BASE/api/v1/projects/ID_DEL_PROYECTO" \ -H "Authorization: Bearer $LUMA_API_KEY"
Para editar, obtené primero la revisión actual y el identificador de la página. Enviá un opId único por operación y expectedRevision con la revisión que leíste.
curl -X PATCH "$BASE/api/v1/projects/ID_DEL_PROYECTO" \
-H "Authorization: Bearer $LUMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"opId":"UUID_UNICO","expectedRevision":0,"ops":[
{"kind":"node","id":"titulo","create":true,"patch":{
"id":"titulo","type":"text","page":"ID_DE_PAGINA",
"x":80,"y":100,"w":800,"h":100,
"text":"Hola Luma","fontSize":64,"fill":"#6554ed"
}}]}'Abrí el resultado en /studio.html?project=ID_DEL_PROYECTO. Para mostrarlo con los nombres ocultos, agregá &componentNames=hide o &frameNames=hide.
Lo que podés hacer
| Método | Ruta | Acción |
|---|---|---|
| GET | /api/v1/me | Permisos, vigencia y límites |
| GET / POST | /api/v1/projects | Listar / crear proyectos |
| GET / PATCH | /api/v1/projects/:id | Leer / editar un documento |
| POST | /api/v1/projects/:id/assets | Subir imagen o fuente como cuerpo binario |
| GET | /api/v1/projects/:id/assets/:asset | Descargar un recurso |
| GET | /api/v1/frame-presets | Formatos y dimensiones del editor |
| GET / POST | /api/v1/folders | Listar y crear carpetas. PATCH o DELETE en /folders/:id |
| POST | /api/v1/projects/:id/organize, /duplicate, /trash | Mover a carpeta o marcar favorito con {folder,starred}, duplicar, enviar a papelera o recuperar con {trashed} |
| GET | /api/v1/projects/:id/thumbnail, /versions, /versions/:version | Documento de miniatura e historial |
| GET / POST / PATCH | /api/v1/projects/:id/comments | Leer, comentar, responder, editar o resolver comentarios |
| GET / POST | /api/v1/calendars | Listar y crear calendarios con una clave habilitada. GET o PATCH en /calendars/:id para leer o editar |
| POST | /api/v1/calendars/:id/prepare, /research, /assessment, /generate, /write | Preparar la investigación, analizar contenido orgánico, evaluar la marca, generar el plan y desarrollar una pieza. Creá el calendario con {"brief":{"store":"https://tutienda.com"}}. En generate enviá {"month":"2026-11","count":12}, y en write, {"pieceId":"ID"}. Se aplican los cupos de la cuenta. |
Recursos: PNG, JPEG, WebP, WOFF, WOFF2, TTF y OTF. Para recursos grandes usá la carga por partes de hasta 8 MiB, con un total de hasta 1 GB. El documento conserva las rutas internas de recursos; para descargarlos por API, usá el prefijo /api/v1/.
Importar un archivo .fig desde la API
Descargá el importador de Figma para Node 22.13 o superior. Con una clave de escritura en LUMA_API_KEY, ejecutá node importar-figma.mjs archivo.fig. Usa el mismo conversor de capas del editor y admite archivos de hasta 1 GB. Devuelve el enlace al proyecto y las advertencias del archivo. El texto conserva sus contornos si Figma los incluye. Para editarlo, vinculá la fuente desde Studio.
Asistentes y clientes MCP
Los clientes que admiten un encabezado Bearer pueden conectarse a /api/v1/mcp. Consultá tools/list para obtener el esquema vigente. Podés trabajar con vectores, máscaras, imágenes cargadas, componentes, efectos, degradados y texto enriquecido. luma_edit_document también acepta operaciones nativas de páginas, estilos y capas. Las claves de lectura solo exponen las herramientas de consulta.
Esta clave no reemplaza el inicio de sesión OAuth que pide la pantalla de complementos de ChatGPT. Esa conexión se configura por separado.
Límites y errores
60 solicitudes por minuto por clave, 120 por minuto y 2.000 por día por cuenta. Las claves anteriores conservan el acceso a Studio. Para usar Calendarios, creá una clave con «Incluir mis calendarios».
401: clave inválida o vencida. 403: permiso insuficiente. 409: conflicto de revisión; volvé a leer el proyecto. 428: falta expectedRevision. 429: límite alcanzado; respetá Retry-After.
Usá la API desde un servidor o cliente de escritorio. No está habilitada para exponer claves desde sitios web externos.