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 இலிருந்து ஒவ்வொரு கோப்பையும் பதிவிறக்குங்கள்.

Endpoint-கள்

முறைபாதைஎன்ன செய்கிறது
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.

வரம்புகள்