Llumi Cut · Nordic Byte

API डॉक्युमेंटेशन

Llumi Cut ही एक HTTP सेवा आहे. तुम्ही मीडिया अपलोड करता, JSON टाइमलाइन पाठवता आणि निकाल डाउनलोड करता. हे पान फील्डचा सारांश देते; संपूर्ण, तपासलेली स्कीमा प्रत्येक इन्स्टॉलेशनवर /openapi.json येथे आहे.

ऑथेंटिकेशन

प्रत्येक इन्स्टॉलेशनची स्वतःची key असते. ती प्रत्येक /v1 रूटवर पाठवा:

Authorization: Bearer <तुमची-key>

प्रक्रिया

  1. प्रत्येक फाइल POST /v1/assets?kind=image|video|audio ने अपलोड करा, फाइल बायनरी बॉडीमध्ये पाठवा. हे {"id": "…"} परत देते.
  2. एडिट POST /v1/renders ने, टाइमलाइन JSON स्वरूपात पाठवून रांगेत टाका. Idempotency-Key हेडर वापरा, म्हणजे पुन्हा प्रयत्न केल्यावर दुसरा रेंडर तयार होणार नाही.
  3. status चे मूल्य completed होईपर्यंत GET /v1/renders/{id} पोल करा, नंतर result.files मधून प्रत्येक फाइल डाउनलोड करा.

एंडपॉइंट

मेथडपाथहे काय करते
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.

मर्यादा