मीडिया

मीडिया पुन: उपयोग योग्य फ़ाइलें हैं — वीडियो बैकग्राउंड, स्थिर इमेज, लोगो, और intro/outro क्लिप — जिन्हें आप एक बार अपलोड करते हैं और presets या project settings से संदर्भित करते हैं। इससे हर बार नया ट्रैक render करते समय उसी फ़ाइल को फिर से अपलोड करने की जरूरत नहीं पड़ती।

मीडिया के प्रकार

प्रकार	विवरण
`video`	लूप होने वाला बैकग्राउंड वीडियो।
`image`	स्थिर बैकग्राउंड इमेज।
`logo`	लोगो ओवरले।
`intro-video`	karaoke शुरू होने से पहले चलता है।
`outro-video`	karaoke खत्म होने के बाद चलता है।

एंडपॉइंट्स

Method	Path	Purpose
`GET`	`/media`	authenticated account के लिए मीडिया की सूची दिखाएँ।
`POST`	`/media`	पहले से अपलोड की गई फ़ाइल को reusable media के रूप में रजिस्टर करें।
`GET`	`/media/{mediaId}`	किसी एक मीडिया आइटम को प्राप्त करें।
`DELETE`	`/media/{mediaId}`	किसी मीडिया आइटम को हटाएँ।

पूरे request और response schemas API reference में हैं।

अपलोड फ़्लो

मीडिया आइटम बनाना दो-चरणों की प्रक्रिया है। पहले फ़ाइल bytes अपलोड करें, फिर अपलोड की गई फ़ाइल को reusable media के रूप में रजिस्टर करें।

Create an upload target

curl -X POST https://api.youka.io/hi/api/v1/uploads \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "background.mp4",
    "contentType": "video/mp4",
    "contentLength": 8421120
  }'

response में inputFileId और uploadUrl शामिल होते हैं।

PUT the file bytes

curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  --data-binary "@./background.mp4"

curl -X POST https://api.youka.io/hi/api/v1/media \
  -H "Authorization: Bearer yk_..." \
  -H "Idempotency-Key: bg-loop-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "inputFileId": "file_abc123",
    "type": "video"
  }'

response में नया mediaId और मीडिया url शामिल होता है। presets या project settings के भीतर url का उपयोग करें।

POST /media raw file uploads स्वीकार नहीं करता। इसे पहले किए गए POST /uploads + PUT कॉल से मिला inputFileId चाहिए।