API ডকুমেন্টেশন

Nordic Layers হলো https://app.layers.nordicbyte.co.uk-এ HTTPS-এর ওপর একটি REST API। প্রজেক্ট হলো লেয়ারের একটি JSON ডকুমেন্ট; আপনি অপারেশন দিয়ে সেটি বদলান এবং ছবি হিসেবে এক্সপোর্ট করেন। ব্রাউজার এডিটর একই API ব্যবহার করে।

অথেনটিকেশন

আপনার অ্যাকাউন্ট প্যানেলে একটি API কী বানান এবং প্রতিটি /v1 রিকোয়েস্টে পাঠান। কী nl_key_ দিয়ে শুরু হয়।

Authorization: Bearer nl_key_…

সাধারণ প্রক্রিয়া

আপলোড করুন প্রতিটি ছবি POST /v1/assets দিয়ে, ফাইলটি সরাসরি রিকোয়েস্ট বডি হিসেবে (PNG, JPEG, WebP, GIF, BMP বা TIFF)। উত্তরে তার id থাকে।
তৈরি করুন একটি প্রজেক্ট POST /v1/projects দিয়ে, width, height ও background-সহ। প্রথম steps একই কলে দিতে পারেন।
এডিট করুন POST /v1/projects/{id}/run দিয়ে: একটি অপারেশন {"op": …} হিসেবে বা কয়েকটি {"steps": [...]} হিসেবে। GET /v1/projects/{id}/preview দিয়ে দেখুন, যা বিনামূল্যে।
এক্সপোর্ট করুন POST /v1/projects/{id}/export দিয়ে। উত্তরে ফাইলের URL থাকে, বা "response": "image" দিলে ছবিটিই।

প্রথম রিকোয়েস্ট

গ্রেডিয়েন্ট ও শিরোনামসহ ১০৮০×১০৮০ প্রজেক্ট বানান, তারপর 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
  }'

এন্ডপয়েন্ট

মেথড	পাথ	কী করে
`GET`	`/health`	সার্ভিসের অবস্থা
`GET`	`/v1/ops`	প্রতিটি অপারেশন ও তার প্যারামিটারের ক্যাটালগ (সর্বজনীন)
`POST`	`/v1/assets?name=photo.jpg`	ছবি আপলোড করুন; বডিই ফাইল
`GET`	`/v1/assets`	আপনার ছবির তালিকা এবং কোনো প্রজেক্ট সেগুলো ব্যবহার করছে কি না
`DELETE`	`/v1/assets/{id}`	ছবি মুছুন
`POST`	`/v1/projects`	প্রজেক্ট তৈরি করুন (ক্যানভাস, বা পুরো ডকুমেন্ট, সঙ্গে ঐচ্ছিক স্টেপ)
`GET`	`/v1/projects`	আপনার প্রজেক্টের তালিকা
`GET`	`/v1/projects/{id}`	একটি প্রজেক্ট তার ডকুমেন্টসহ
`PUT`	`/v1/projects/{id}/document`	পুরো ডকুমেন্ট প্রতিস্থাপন করুন
`POST`	`/v1/projects/{id}/run`	একটি অপারেশন বা স্টেপের তালিকা প্রয়োগ করুন
`POST`	`/v1/projects/{id}/undo`	শেষ পরিবর্তন আনডু করুন
`POST`	`/v1/projects/{id}/redo`	রিডু
`GET`	`/v1/projects/{id}/preview?size=1024`	বিনামূল্যে PNG প্রিভিউ, লম্বা দিক `size` px পর্যন্ত
`POST`	`/v1/projects/{id}/export`	PNG, JPEG বা WebP এক্সপোর্ট; শুধু এই ফাইলের জন্য ঐচ্ছিক স্টেপ
`POST`	`/v1/render`	পুরো ডকুমেন্টের স্টেটলেস রেন্ডার
`GET`	`/v1/exports`	আপনার এক্সপোর্টের তালিকা
`GET`	`/v1/exports/{id}/file`	এক্সপোর্ট ডাউনলোড করুন
`DELETE`	`/v1/projects/{id}`	প্রজেক্ট মুছুন

অপারেশন

প্রতিটি অপারেশন হলো op ও তার প্যারামিটারসহ একটি অবজেক্ট। লেয়ারকে id বা নাম দিয়ে চেনানো হয়; layer না দিলে সক্রিয় লেয়ার ব্যবহার হয়। নামে বড়-ছোট হাতের অক্ষর ও স্পেস উপেক্ষা করা হয়, তাই "Linear Dodge (Add)" আর "linearDodge" একই ব্লেন্ড মোড। steps দিলে সেগুলো ক্রমানুসারে চলে এবং প্রথম ত্রুটিতে থামে (যদি না "stopOnError": false হয়); তার আগের স্টেপগুলো প্রয়োগ থাকে।

লেয়ার
টেক্সট
শেপ
ট্রান্সফর্ম
লেয়ারে অ্যাডজাস্টমেন্ট
ফিল্টার
অ্যাডজাস্টমেন্ট লেয়ার
লেয়ার মাস্ক
লেয়ার ইফেক্ট
ক্যানভাস
প্রজেক্ট

লেয়ার

অপারেশন	প্যারামিটার	কী করে
`layer.add`	`color, name`	Alias of layer.addFill (the web has no empty pixel layers).
`layer.addFill`	`color \| gradient {colors: [..], angle, type: linear\|radial}, name, above, atBottom`	A colour or gradient layer the size of the canvas.
`layer.addImage`	`asset_id \| color, name, rect \| origin \| center, width, height, fit (stretch\|contain\|cover), fitCanvas (contain\|cover), above, atBottom, opacity, blendMode`	Add an uploaded image (asset_id) or a solid colour (color).
`layer.clip`	`layer`	Clip a layer to the one below it (clipping mask).
`layer.delete`	`layer \| layers`	Delete layers.
`layer.duplicate`	`layer, name`	Copy a layer above itself.
`layer.get`	`layer`	One layer with all its settings.
`layer.list`	—	Layers from bottom to top.
`layer.move`	`layer, above \| below (layer), toTop, atBottom, index, offset`	Reorder a layer.
`layer.rename`	`layer, name`	Rename a layer.
`layer.select`	`layer`	Make a layer the active one.
`layer.setBlendMode`	`layer \| layers, blendMode (normal, darken, multiply, colorBurn, linearBurn, lighten, screen, colorDodge, linearDodge, overlay, softLight, hardLight, difference, exclusion, subtract, divide, hue, saturation, color, luminosity)`	Blend mode.
`layer.setFill`	`layer, color \| gradient`	Change a fill layer's colour or gradient.
`layer.setImage`	`layer, asset_id, fit (stretch\|contain\|cover)`	Replace a layer's image and keep its box (templates).
`layer.setOpacity`	`layer \| layers, opacity`	Layer opacity, 0 to 1.
`layer.setVisible`	`layer \| layers, visible`	Show or hide layers.
`layer.unclip`	`layer`	Release a clipping mask.

টেক্সট

অপারেশন	প্যারামিটার	কী করে
`text.add`	`content, fontName, fontSize, color, alignment, leading, bold, italic, boxWidth, origin \| center, name`	Add a text layer.
`text.defaults`	—	Fonts on the server and whether complex scripts are shaped.
`text.set`	`layer, content, fontName, fontSize, color, alignment, leading, bold, italic, boxWidth`	Change a text layer.

শেপ

অপারেশন	প্যারামিটার	কী করে
`shape.add`	`shape, rect \| from+to, color, cornerRadius, lineWidth, name`	Add a rectangle, ellipse or line.
`shape.set`	`layer, color, cornerRadius, lineWidth`	Change a shape layer.

ট্রান্সফর্ম

অপারেশন	প্যারামিটার	কী করে
`transform.flip`	`layer \| layers, axis (horizontal\|vertical)`	Flip horizontally or vertically.
`transform.move`	`layer \| layers, dx, dy \| to [x, y]`	Move by dx/dy or to a point.
`transform.rotate`	`layer \| layers, angle`	Rotate by an angle (degrees, clockwise).
`transform.scale`	`layer \| layers, factor \| percent \| width \| height`	Scale around each layer's centre.
`transform.set`	`layer \| layers, x, y, width, height, rotation, flipX, flipY`	Box, rotation and flips.

লেয়ারে অ্যাডজাস্টমেন্ট

অপারেশন	প্যারামিটার	কী করে
`adjust.blackWhite`	`layer \| layers, reds, yellows, greens, cyans, blues, magentas, tint, tintHue, tintSaturation`	Non-destructive blackWhite on a layer (adds it or updates it).
`adjust.brightnessContrast`	`layer \| layers, brightness, contrast`	Non-destructive brightnessContrast on a layer (adds it or updates it).
`adjust.clear`	`layer \| layers`	Remove every adjustment and filter from a layer.
`adjust.colorBalance`	`layer \| layers, shadows, midtones, highlights, preserveLuminosity`	Non-destructive colorBalance on a layer (adds it or updates it).
`adjust.curves`	`layer \| layers, rgb, red, green, blue`	Non-destructive curves on a layer (adds it or updates it).
`adjust.exposure`	`layer \| layers, exposure, offset, gamma`	Non-destructive exposure on a layer (adds it or updates it).
`adjust.gradientMap`	`layer \| layers, shadows, highlights, reversed`	Non-destructive gradientMap on a layer (adds it or updates it).
`adjust.grain`	`layer \| layers, amount, size, seed`	Non-destructive grain on a layer (adds it or updates it).
`adjust.hueSaturation`	`layer \| layers, hue, saturation, lightness, colorize`	Non-destructive hueSaturation on a layer (adds it or updates it).
`adjust.invert`	`layer \| layers, no settings`	Non-destructive invert on a layer (adds it or updates it).
`adjust.levels`	`layer \| layers, black, white, gamma, outputBlack, outputWhite`	Non-destructive levels on a layer (adds it or updates it).
`adjust.remove`	`layer \| layers, kind`	Remove one adjustment or filter from a layer.

ফিল্টার

অপারেশন	প্যারামিটার	কী করে
`filter.addNoise`	`layer \| layers, amount, gaussian, monochromatic, seed`	Non-destructive addNoise on a layer (adds it or updates it).
`filter.gaussianBlur`	`layer \| layers, radius`	Non-destructive gaussianBlur on a layer (adds it or updates it).
`filter.motionBlur`	`layer \| layers, angle, distance`	Non-destructive motionBlur on a layer (adds it or updates it).
`filter.pixelate`	`layer \| layers, size`	Non-destructive pixelate on a layer (adds it or updates it).
`filter.sharpen`	`layer \| layers, amount, radius, threshold`	Non-destructive sharpen on a layer (adds it or updates it).
`filter.vignette`	`layer \| layers, amount, midpoint, roundness, feather, color`	Non-destructive vignette on a layer (adds it or updates it).

অ্যাডজাস্টমেন্ট লেয়ার

অপারেশন	প্যারামিটার	কী করে
`adjustmentLayer.add`	`kind, settings…, name, above`	An adjustment layer: changes everything below it.
`adjustmentLayer.get`	`layer`	An adjustment layer's settings.
`adjustmentLayer.set`	`layer, settings…`	Change an adjustment layer (partial).

লেয়ার মাস্ক

অপারেশন	প্যারামিটার	কী করে
`mask.add`	`layer, reveal \| hide \| rect \| ellipse (rect) \| gradient (from, to) \| asset_id (+ rect), feather, invert, cornerRadius`	Add or replace a layer mask.
`mask.blur`	`layer, radius`	Feather the layer mask.
`mask.delete`	`layer`	Remove the layer mask.
`mask.invert`	`layer`	Invert the layer mask.
`mask.setEnabled`	`layer, enabled`	Turn the layer mask on or off.

লেয়ার ইফেক্ট

অপারেশন	প্যারামিটার	কী করে
`effects.copy`	`from, layer \| layers`	Copy effects from one layer to others.
`effects.get`	`layer`	A layer's effects.
`effects.remove`	`layer \| layers, kinds`	Remove effects (all, or the ones named).
`effects.set`	`layer \| layers, shadow {…}, stroke {…}, outerGlow {…}, colorOverlay {…}`	Set effects (partial): shadow, outerGlow, stroke, colorOverlay.
`effects.setEnabled`	`layer, kind, enabled`	Turn one effect on or off.

ক্যানভাস

অপারেশন	প্যারামিটার	কী করে
`canvas.crop`	`rect [x, y, width, height]`	Crop the canvas to a rectangle.
`canvas.imageSize`	`width and/or height, or percent`	Scale the whole document.
`canvas.setBackground`	`color`	Background colour, or null for transparent.
`canvas.size`	`width, height, anchor (topLeft…bottomRight, default center)`	Change the canvas without scaling layers.

প্রজেক্ট

অপারেশন	প্যারামিটার	কী করে
`project.state`	—	The whole document.

ব্লেন্ড মোড

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

ত্রুটি

ত্রুটি JSON-এ একটি স্থির code ও আপনার অ্যাকাউন্টের ভাষায় detail বার্তাসহ আসে। ব্যর্থ স্টেপ জানায় কোন প্যারামিটার ভুল ছিল। প্ল্যানের রেন্ডার শেষ হলে API 402 ও quota_renders দিয়ে সাড়া দেয়।

সীমা

আপলোড 50 MB এবং প্রতি দিকে 12,000 px পর্যন্ত।
ক্যানভাস প্রতি দিকে 20,000 px পর্যন্ত, আপনার প্ল্যানের মেগাপিক্সেলের মধ্যে।
প্রতি কলে 200টি পর্যন্ত স্টেপ।
প্রিভিউ লম্বা দিকে 2,048 px পর্যন্ত।
মেগাপিক্সেল, লেয়ার, প্রজেক্ট, স্টোরেজ ও মাসিক রেন্ডার প্ল্যানের ওপর নির্ভর করে: মূল্য দেখুন।