Documentación de la API

Nordic Layers es una API REST sobre HTTPS en https://app.layers.nordicbyte.co.uk. Un proyecto es un documento JSON de capas; lo modificas con operaciones y lo exportas como imagen. El editor del navegador usa la misma API.

Autenticación

Crea una clave de API en el panel de tu cuenta y envíala en cada petición a /v1. Las claves empiezan por nl_key_.

Authorization: Bearer nl_key_…

El flujo habitual

1. Sube cada imagen con POST /v1/assets y el archivo como cuerpo de la petición (PNG, JPEG, WebP, GIF, BMP o TIFF). La respuesta incluye su id.
2. Crea un proyecto con POST /v1/projects y un width, height y background. Puedes pasar los primeros steps en la misma llamada.
3. Edítalo con POST /v1/projects/{id}/run: una operación como {"op": …} o varias como {"steps": [...]}. Míralo con GET /v1/projects/{id}/preview, que es gratis.
4. Exporta con POST /v1/projects/{id}/export. La respuesta trae la URL del archivo, o la propia imagen con "response": "image".

Una primera petición

Crea un proyecto de 1080×1080 con un degradado y un título, y expórtalo como WebP:

curl -X POST https://app.layers.nordicbyte.co.uk/v1/projects \
  -H "Authorization: Bearer $NL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "First post",
    "width": 1080,
    "height": 1080,
    "steps": [
      {"op": "layer.addFill", "gradient": {"colors": ["#1E3A5F", "#64B5F6"], "angle": 135}},
      {"op": "text.add", "content": "Hello, layers", "fontName": "Segoe UI", "fontSize": 110, "bold": true, "color": "#FFFFFF"},
      {"op": "effects.set", "shadow": {"opacity": 0.4, "distance": 12, "size": 24}}
    ]
  }'

# → {"project": {"id": "…", …}}

curl -X POST https://app.layers.nordicbyte.co.uk/v1/projects/$PROJECT_ID/export \
  -H "Authorization: Bearer $NL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "webp",
    "quality": 90
  }'

Endpoints

Operaciones

Cada operación es un objeto con op y sus parámetros. Las capas se referencian por id o por nombre; sin layer, se usa la capa activa. Los nombres ignoran mayúsculas y espacios, así que "Linear Dodge (Add)" y "linearDodge" son el mismo modo de fusión. Con steps, se ejecutan en orden y se detienen en el primer error (salvo "stopOnError": false); los pasos anteriores quedan aplicados.

• Capas
• Texto
• Formas
• Transformar
• Ajustes en una capa
• Filtros
• Capas de ajuste
• Máscaras de capa
• Efectos de capa
• Lienzo
• Proyecto

Capas

Texto

Formas

Transformar

Ajustes en una capa

Filtros

Capas de ajuste

Máscaras de capa

Efectos de capa

Lienzo

Proyecto

Modos de fusión

• normal
• darken
• multiply
• colorBurn
• linearBurn
• lighten
• screen
• colorDodge
• linearDodge
• overlay
• softLight
• hardLight
• difference
• exclusion
• subtract
• divide
• hue
• saturation
• color
• luminosity

Familias tipográficas

• Arial
• Segoe UI
• Calibri
• Verdana
• Tahoma
• Trebuchet MS
• Georgia
• Times New Roman
• Courier New
• Consolas
• Impact
• Comic Sans MS

Plantillas

Pasa steps a la llamada de exportación y se aplican a una copia del proyecto solo para ese archivo. Una plantilla, muchos archivos: cambia el texto con text.set y la foto con layer.setImage, que conserva la caja de la capa.

curl -X POST https://app.layers.nordicbyte.co.uk/v1/projects/$TEMPLATE_ID/export \
  -H "Authorization: Bearer $NL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "png",
    "steps": [
      {"op": "text.set", "layer": "Title", "content": "Nueva colección"},
      {"op": "layer.setImage", "layer": "Photo", "asset_id": "photo_dunes"}
    ]
  }'

Render sin estado

POST /v1/render recibe un document completo (tal como lo devuelve project.document), steps opcionales y las opciones de exportación, y no guarda ningún proyecto. Con "response": "image" la respuesta es el archivo de imagen.

curl -X POST https://app.layers.nordicbyte.co.uk/v1/render \
  -H "Authorization: Bearer $NL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document": {"width": 1200, "height": 630, "background": "#1E3A5F", "layers": ["…"]},
    "format": "png",
    "response": "image"
  }' \
  -o card.png

Errores

Los errores llegan como JSON con un code estable y un mensaje detail en el idioma de tu cuenta. Un paso que falla indica qué parámetro era incorrecto. Cuando se agotan los renders de un plan, la API responde 402 con quota_renders.

Límites

• Subidas de hasta 50 MB y 12,000 px por lado.
• Lienzo de hasta 20,000 px por lado, dentro de los megapíxeles de tu plan.
• Hasta 200 pasos por llamada.
• Vistas previas de hasta 2,048 px en el lado largo.
• Los megapíxeles, capas, proyectos, almacenamiento y renders al mes dependen del plan: consulta Precios.