Skip to main content
प्रीसेट एक पुन: उपयोग योग्य रेंडर कॉन्फ़िगरेशन है — बैकग्राउंड, सबटाइटल स्टाइल, लेआउट — जिसे आप किसी भी प्रोजेक्ट या एक्सपोर्ट पर लागू कर सकते हैं। जब आपको कई ट्रैक्स में एक जैसा लुक चाहिए, तब प्रीसेट्स का उपयोग करें। पूरा preset shape और हर enum-backed विकल्प के लिए Render settings reference देखें।

​
प्रीसेट कब उपयोग करें

प्रीसेट तब इस्तेमाल करें जब…

आपको कई प्रोजेक्ट्स में एक जैसा लुक चाहिए और उसे एक ही जगह से अपडेट करने की जरूरत हो।

प्रोजेक्ट सेटिंग्स तब इस्तेमाल करें जब…

आपको प्रोजेक्ट-लोकल overrides चाहिए जिन्हें साझा करना उचित नहीं है।

​
एंडपॉइंट्स

MethodPathPurpose
GET/presetsauthenticated अकाउंट के लिए प्रीसेट्स की सूची देखें।
POST/presetsनया प्रीसेट बनाएं।
GET/presets/{presetId}एकल प्रीसेट प्राप्त करें।
PATCH/presets/{presetId}नाम अपडेट करें, body अपडेट करें, या डिफ़ॉल्ट सेट करें।
DELETE/presets/{presetId}एक प्रीसेट हटाएं।
पूरा request और response schemas साइडबार में API reference के अंतर्गत उपलब्ध हैं।

​
एक प्रीसेट बनाएं

curl -X POST https://api.youka.io/hi/api/v1/presets \
  -H "Authorization: Bearer yk_..." \
  -H "Idempotency-Key: create-neon-night-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Neon Night",
    "preset": {
      "background": {
        "type": "gradient",
        "colors": ["#12001f", "#2f0a57"],
        "angle": 90
      },
      "singerTextStyles": {
        "0": {
          "fontFamily": "Inter",
          "textColor": "#00f5ff",
          "effectColor": "#ff4fd8"
        }
      }
    },
    "isDefault": false
  }'
response में नया presetId शामिल होता है। इसे सहेजें और प्रोजेक्ट्स या एक्सपोर्ट्स से इसे reference करें।
हर POST के साथ एक idempotency key जोड़ें। उसी key को उसी payload के साथ दोबारा उपयोग करने पर डुप्लिकेट बनाने के बजाय मूल प्रीसेट लौटाया जाता है।

​
वैध प्रीसेट फ़ील्ड्स खोजें

प्रीसेट्स को server-side पर KaraokePresetSchema के खिलाफ validate किया जाता है। SDK इस schema को export करता है ताकि आप runtime पर इसे JSON Schema में बदल सकें: 
import { KaraokePresetSchema } from "@youka/sdk";

const jsonSchema = KaraokePresetSchema.toJSONSchema();
CLI से: 
youka preset schema --json
Agent authors को प्रीसेट्स mutate करने से पहले यह कॉल करना चाहिए ताकि मॉडल को हर वैध field और value type पता हो। Human-readable reference:

​
एक प्रीसेट अपडेट करें

curl -X PATCH https://api.youka.io/hi/api/v1/presets/preset_abc123 \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Neon Night v2",
    "preset": {
      "singerTextStyles": {
        "0": {
          "textColor": "#ff2a2a"
        }
      }
    }
  }'
name और preset में से कोई भी subset पास करें। जो फ़ील्ड्स आप शामिल नहीं करते, वे अपरिवर्तित रहती हैं।

​
डिफ़ॉल्ट प्रीसेट सेट करें

हर अकाउंट में अधिकतम एक डिफ़ॉल्ट प्रीसेट होता है, जो नए प्रोजेक्ट्स पर अपने-आप लागू हो जाता है। 
curl -X PATCH https://api.youka.io/hi/api/v1/presets/preset_abc123 \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "isDefault": true
  }'
नया डिफ़ॉल्ट सेट करने पर पिछला डिफ़ॉल्ट अपने-आप unset हो जाता है।

​
एक प्रीसेट लागू करें

तीन जगहों पर प्रीसेट को reference करें:
WhereField
प्रोजेक्ट बनाते समयPOST /projects में presetId
किसी भी समय प्रोजेक्ट परPATCH /projects/{projectId}/settings में presetId
एक्सपोर्ट समय परPOST /projects/{projectId}/exports में presetId
एक्सपोर्ट पर उदाहरण: 
curl -X POST https://api.youka.io/hi/api/v1/projects/prj_abc/exports \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "presetId": "preset_abc123",
    "resolution": "1080p",
    "quality": "high"
  }'

​
एक प्रीसेट हटाएं

curl -X DELETE https://api.youka.io/hi/api/v1/presets/preset_abc123 \
  -H "Authorization: Bearer yk_..." \
  -H "Idempotency-Key: delete-preset_abc123"
प्रीसेट हटाने से उन प्रोजेक्ट्स या एक्सपोर्ट्स पर असर नहीं पड़ता जो पहले इससे रेंडर किए जा चुके हैं। हटाए गए प्रीसेट को reference करने वाले भविष्य के एक्सपोर्ट्स विफल हो जाएंगे।

​
आगे क्या

  • Render settings reference — सभी shared field paths और enum values
  • Media — प्रीसेट bodies से referenced
  • Project settings — किसी प्रोजेक्ट पर प्रीसेट लागू करें
  • CLI presets — टर्मिनल से वही flow
  • SDK presets — TypeScript में वही endpoints