API 문서

Nordic Layers는 https://app.layers.nordicbyte.co.uk에서 제공되는 HTTPS 기반 REST API입니다. 프로젝트는 레이어로 이루어진 JSON 문서이며, 작업으로 수정하고 이미지로 내보냅니다. 브라우저 편집기도 같은 API를 사용합니다.

인증

계정 패널에서 API 키를 만들고 모든 /v1 요청에 함께 보내세요. 키는 nl_key_로 시작합니다.

Authorization: Bearer nl_key_…

일반적인 흐름

1. 업로드: POST /v1/assets로 각 이미지를 업로드합니다. 파일을 그대로 요청 본문으로 보냅니다(PNG, JPEG, WebP, GIF, BMP, TIFF). 응답에 id가 들어 있습니다.
2. 생성: POST /v1/projects에 width, height, background를 담아 프로젝트를 만듭니다. 같은 호출에서 첫 steps를 함께 보낼 수도 있습니다.
3. 편집: POST /v1/projects/{id}/run으로, 작업 하나는 {"op": …}, 여러 개는 {"steps": [...]}로 보냅니다. 무료인 GET /v1/projects/{id}/preview로 결과를 확인하세요.
4. 내보내기: POST /v1/projects/{id}/export. 응답에 파일 URL이 담기며, "response": "image"를 지정하면 이미지 자체가 반환됩니다.

첫 번째 요청

그라디언트와 제목이 있는 1080×1080 프로젝트를 만들고 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
  }'

엔드포인트

작업

모든 작업은 op와 그 매개변수를 가진 객체입니다. 레이어는 id 또는 이름으로 지정하며, layer를 생략하면 활성 레이어가 사용됩니다. 이름은 대소문자와 공백을 무시하므로 "Linear Dodge (Add)"와 "linearDodge"는 같은 블렌드 모드입니다. steps를 쓰면 순서대로 실행되며 첫 번째 오류에서 멈춥니다("stopOnError": false인 경우 제외). 그 앞의 단계는 적용된 상태로 남습니다.

• 레이어
• 텍스트
• 도형
• 변형
• 레이어 보정
• 필터
• 보정 레이어
• 레이어 마스크
• 레이어 효과
• 캔버스
• 프로젝트

레이어

텍스트

도형

변형

레이어 보정

필터

보정 레이어

레이어 마스크

레이어 효과

캔버스

프로젝트

블렌드 모드

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

글꼴 패밀리

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

템플릿

내보내기 호출에 steps를 넘기면 프로젝트의 사본에 적용되어 해당 파일에만 반영됩니다. 템플릿 하나로 여러 파일을: text.set으로 텍스트를, layer.setImage로 사진을 바꾸면 레이어의 상자는 그대로 유지됩니다.

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"}
    ]
  }'

상태 비저장 렌더링

POST /v1/render는 document 전체(project.document로 반환되는 것), 선택적 steps, 내보내기 옵션을 받으며 프로젝트를 저장하지 않습니다. "response": "image"를 지정하면 응답은 이미지 파일입니다.

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

오류

오류는 고정된 code와 계정 언어로 된 detail 메시지가 담긴 JSON으로 반환됩니다. 실패한 단계는 어떤 매개변수가 잘못되었는지 알려 줍니다. 요금제의 렌더링을 모두 사용하면 API는 402와 quota_renders로 응답합니다.

제한

• 업로드는 50 MB, 한 변 12,000 px까지.
• 캔버스는 한 변 20,000 px까지이며 요금제의 메가픽셀 한도 이내.
• 호출당 최대 200단계.
• 미리보기는 긴 변 기준 2,048 px까지.
• 메가픽셀, 레이어, 프로젝트, 저장 공간, 월 렌더링 횟수는 요금제에 따라 다릅니다. 요금을 확인하세요.