Llumi Cut · Nordic Byte

API డాక్యుమెంటేషన్

Llumi Cut ఒక HTTP సర్వీస్. మీరు మీడియాను అప్‌లోడ్ చేసి, JSON టైమ్‌లైన్ పంపి, ఫలితాన్ని డౌన్‌లోడ్ చేస్తారు. ఈ పేజీ ఫీల్డ్‌లను సంక్షిప్తంగా వివరిస్తుంది; ధృవీకరించిన పూర్తి schema ప్రతి ఇన్‌స్టలేషన్‌లో /openapi.json వద్ద ఉంటుంది.

ఆథెంటికేషన్

ప్రతి ఇన్‌స్టలేషన్‌కు సొంత key ఉంటుంది. ప్రతి /v1 route లో దాన్ని పంపండి:

Authorization: Bearer <మీ-key>

ప్రక్రియ

  1. ప్రతి ఫైల్‌ను POST /v1/assets?kind=image|video|audio తో, ఫైల్‌ను బైనరీ body గా పెట్టి అప్‌లోడ్ చేయండి. ఇది {"id": "…"} ను తిరిగి ఇస్తుంది.
  2. టైమ్‌లైన్‌ను JSON గా పెట్టి POST /v1/renders తో ఎడిట్‌ను క్యూలో చేర్చండి. రీట్రై రెండో రెండర్‌ను సృష్టించకుండా ఉండటానికి Idempotency-Key header ఉపయోగించండి.
  3. status విలువ completed అయ్యే వరకు GET /v1/renders/{id} ను చెక్ చేస్తూ ఉండండి, తర్వాత result.files నుంచి ప్రతి ఫైల్‌ను డౌన్‌లోడ్ చేయండి.

Endpoints

మెథడ్పాత్ఏమి చేస్తుంది
GET/healthసర్వీస్ స్టేటస్
POST/v1/assets?kind=image|video|audioబైనరీ ఫైల్‌ను అప్‌లోడ్ చేసి దాని ID ని ఇస్తుంది
POST/v1/rendersటైమ్‌లైన్‌ను ధృవీకరించి క్యూలో చేరుస్తుంది
GET/v1/rendersతాజా 100 రెండర్‌లు
GET/v1/renders/{id}స్టేటస్, పురోగతి, ఈవెంట్‌లు మరియు ఎర్రర్‌లు
POST/v1/renders/{id}/cancelక్యూలో ఉన్న లేదా నడుస్తున్న రెండర్‌ను రద్దు చేస్తుంది
POST/v1/renders/{id}/retryఆగిపోయిన రెండర్‌ను మళ్లీ ప్రయత్నిస్తుంది
DELETE/v1/renders/{id}ఆగిపోయిన రెండర్‌ను, దాని ఫైల్స్‌ను తొలగిస్తుంది
GET/v1/renders/{id}/files/{name}ఒక అవుట్‌పుట్‌ను డౌన్‌లోడ్ చేస్తుంది
POST/v1/maintenance/purge?older_than_days=NN రోజుల కంటే పాత ఆగిపోయిన రెండర్‌లను తొలగిస్తుంది

టైమ్‌లైన్

title, duration మరియు clips మాత్రమే తప్పనిసరి. షాట్‌ల నిడివుల మొత్తం duration కు సమానంగా ఉండాలి.

ఫీల్డ్విలువలు
duration3–600 s
width · aspect640, 1280 లేదా 1920 (పొడవైన వైపు) · 16:9, 9:16, 1:1
fps24 లేదా 30
backgroundలెటర్‌బాక్స్ బార్‌ల రంగు, #RRGGBB
transition · transition_durationcut, fade, fadeblack, fadewhite, dissolve, slideleft, slideright, wipeleft, wiperight, smoothleft, smoothright, circleopen, circleclose · 0.1–2 s
image_motionnone, zoom_in, zoom_out, pan_left, pan_right, auto
fade_in · fade_outమొత్తం వీడియోకు, దాని సౌండ్‌కు ఫేడ్, 0–5 s
audio_asset_id · pausesఐచ్ఛిక ప్రధాన పాట మరియు గరిష్ఠంగా పది డిజిటల్ నిశ్శబ్ద విరామాలు

షాట్‌లు (clips[])

ఫీల్డ్విలువలు
asset_id · durationఇమేజ్ లేదా వీడియో · గరిష్ఠంగా 60 s
trim_start · speedసోర్స్‌లో ప్రారంభ సెకను · 0.25–4
volumeక్లిప్ సొంత సౌండ్, 0–2 (0 అంటే మ్యూట్)
fitcontain (బార్‌లతో) లేదా cover (క్రాప్ చేసి నింపుతుంది)
freeze · motionమొదటి ఫ్రేమ్‌ను ఫ్రీజ్ చేస్తుంది · Ken Burns కదలిక
effectsgrayscale, sepia, vintage, noir, warm, cool, blur, sharpen, vignette, invert, mirror, flip లో గరిష్ఠంగా ఆరు
brightness · contrast · saturation−0.5–0.5 · 0.3–2 · 0–3
transition · transition_durationమునుపటి షాట్ నుంచి ట్రాన్సిషన్

సౌండ్ (audio_tracks[])

asset_id, start, trim_start, duration, volume (0–2), fade_in, fade_out, loop మరియు duck. duck: true ఉన్న ట్రాక్, పాట, వాయిస్ లేదా క్లిప్ సౌండ్ ప్లే అవుతున్నప్పుడు సుమారు 10 dB తగ్గుతుంది.

టైటిల్స్ (texts[])

text (గరిష్ఠంగా ఐదు లైన్లు), start, end, position (తొమ్మిది స్థానాలు) లేదా ఫ్రేమ్ భిన్నాలుగా x/y, size, color, outline_color, outline, box, box_color, box_opacity, font, bold, italic మరియు animation (none, fade, slide_up, slide_left, pop, typewriter).

లేయర్‌లు (overlays[])

asset_id (ఇమేజ్ లేదా వీడియో), start, end, position లేదా x/y, width, height (రెండూ ఇస్తే బాక్స్ నిండుతుంది: స్ప్లిట్ స్క్రీన్ మరియు గ్రిడ్‌లు), margin, opacity, trim_start, volume, fade, border మరియు border_color.

సబ్‌టైటిల్స్ (captions[])

start, end మరియు text. ఇవి SRT మరియు WebVTT గా ఎగుమతి అవుతాయి; burn_subtitles: true ఉంటే చిత్రంలోనే ముద్రించబడతాయి.

అవుట్‌పుట్‌లు

video.mp4 (H.264 + AAC), audio.wav (తుది సౌండ్‌ట్రాక్), song.wav (ప్రధాన పాట ఉంటేనే), subtitles.srt, subtitles.vtt, qc.json (నిడివి, రిజల్యూషన్, సౌండ్ సోర్స్‌లు, హెచ్చరికలు) మరియు manifest.json.

పరిమితులు