जनरेशन टेम्पलेट्स

टेम्प्लेट /v1/images/generations और /v1/videos/generations के लिए पूर्व-क्यूरेटेड “रचनात्मक प्रभाव” व्यंजन हैं। प्रत्येक टेम्पलेट एक अनुशंसित मॉडल, समर्थित मॉडलों की एक सूची, डिफ़ॉल्ट पैरामीटर और आवश्यक इनपुट नियम भेजता है। अनुरोध निकाय में template: "<slug>" पास करें और EmpirioLabs आपके द्वारा प्रदान की जाने वाली किसी भी चीज़ के साथ प्रभाव लागू करता है, आपके लिए सबसे अच्छा समर्थित मॉडल चुनता है, और कार्यकर्ता को कॉल अग्रेषित करता है।

वही टेम्पलेट कैटलॉग खेल के मैदान में टेम्पलेट्स बटन को शक्ति प्रदान करता है।

सूची टेम्पलेट्स

1
curl https://api.empiriolabs.ai/v1/templates \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

पूर्ण छवि और वीडियो कैटलॉग के लिए सामान्य समापन बिंदु का उपयोग करें, या तौर-तरीका-विशिष्ट समापन बिंदु का उपयोग करें जब आप पहले से ही पीढ़ी के प्रकार को जानते हों।

$
curl https://api.empiriolabs.ai/v1/templates?modality=image \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

वीडियो टेम्पलेट्स की सूची बनाएं

1
curl https://api.empiriolabs.ai/v1/videos/templates \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

फिल्टर

• category: viral, cinematic, motion, transform, social, extend, product, edit, portrait
• modality: video या image
• model: केवल उन टेम्पलेट्स को लौटाएं जो किसी विशिष्ट मॉडल स्लग का समर्थन करते हैं
• featured: केवल फ़ीचर्ड टेम्पलेट्स को फ़िल्टर करने का true करें

$
curl https://api.empiriolabs.ai/v1/videos/templates?category=viral \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

प्रतिक्रिया आकार

1
{
2
  "object": "list",
3
  "template_count": 11,
4
  "data": [
5
    {
6
      "slug": "baseball-stadium",
7
      "display_name": "Stadium",
8
      "category": "viral",
9
      "description": "Customer-facing description shown in the playground card.",
10
      "recommended_model": "kling-o3",
11
      "supported_models": ["kling-o3"],
12
      "default_params": { "aspect_ratio": "16:9", "duration": 10 },
13
      "required_inputs": { "image": true, "min_images": 1, "max_images": 1 },
14
      "cover_image_url": "https://media.empiriolabs.ai/assets/template-posters/baseball-stadium.jpg",
15
      "preview_video_url": "https://media.empiriolabs.ai/assets/template-previews/baseball-stadium.mp4",
16
      "modality": "video",
17
      "is_featured": true,
18
      "display_order": 10
19
    }
20
  ]
21
}

छवि टेम्पलेट्स की सूची बनाएं

1
curl https://api.empiriolabs.ai/v1/images/templates \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

$
curl https://api.empiriolabs.ai/v1/images/templates?model=seedream-5-0-lite \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

एक एकल टेम्पलेट प्राप्त करें

1
curl https://api.empiriolabs.ai/v1/templates/studio-product-shot \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

$
curl https://api.empiriolabs.ai/v1/templates/studio-product-shot \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

स्लग मौजूद नहीं होने पर code: "template_not_found" के साथ 404 लौटाता है।

एक टेम्पलेट के साथ एक वीडियो बनाएं

template: "<slug>" को सामान्य /v1/videos/generations कॉल में जोड़ें। आपको टेम्पलेट की आवश्यकता (required_inputs) प्रदान करनी होगी, आमतौर पर एक संदर्भ छवि।

$
curl https://api.empiriolabs.ai/v1/videos/generations \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "template": "baseball-stadium",
>
    "image_url": "https://example.com/me.jpg"
>
  }'

व्यवहार:

• मॉडल चयन: यदि आप model पास नहीं करते हैं, तो टेम्पलेट के recommended_model का उपयोग किया जाता है। यदि आप ऐसा करते हैं, तो अधिकांश टेम्पलेट पुष्टि करते हैं कि यह supported_models में है और अन्यथा 400 template_model_unsupported लौटाते हैं। metadata.force_recommended_model: true वाले टेम्पलेट्स को प्रभाव निष्ठा के लिए recommended_model पर पिन किया जाता है।
• तौर-तरीके जांच: छवि टेम्पलेट केवल /v1/images/generations पर लागू होते हैं; वीडियो टेम्प्लेट केवल /v1/videos/generations पर लागू होते हैं।
• प्रॉम्प्ट मिश्रण: आपकी prompt (यदि कोई हो) को टेम्पलेट की अंतर्निहित स्टाइल के साथ जोड़ा जाता है ताकि उत्पन्न आउटपुट आपके अनुरोध और प्रभाव के सौंदर्य दोनों से मेल खाता हो। एक छोटा दिशात्मक संकेत भेजें; EmpirioLabs बाकी को संभालता है।
• डिफ़ॉल्ट पैराम्स: टेम्पलेट से default_params केवल उन कुंजियों के लिए मर्ज करते हैं जिन्हें आपने स्पष्ट रूप से सेट नहीं किया था।
• आवश्यक इनपुट: \{ "image": true \} मतलब है कि यदि कोई image_url/image/images प्रदान नहीं किया जाता है तो कॉल 400 template_missing_image लौटाती है।

टेम्पलेट के साथ एक छवि उत्पन्न करें

$
curl https://api.empiriolabs.ai/v1/images/generations \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "template": "background-swap",
>
    "prompt": "Place this product on a brushed steel studio plinth",
>
    "image": ["https://example.com/product.jpg"]
>
  }'

प्रतिक्रिया एक सामान्य वीडियो पीढ़ी के रूप में एक ही एसिंक जॉब लिफाफा है:

1
{
2
  "job_id": "abc123...",
3
  "status": "processing",
4
  "poll_url": "/v1/jobs/abc123..."
5
}

पोल टर्मिनल तक GET /v1/jobs/\{job_id\}।

पहले का वीडियो बढ़ाएं

/v1/videos/generations पिछली पीढ़ी को जारी रखने के लिए extend_from भी स्वीकार करता है। EmpirioLabs आपके लिए पूर्व-क्लिप वायरिंग को संभालता है और एक समझदार निरंतरता संकेत का उपयोग करता है जब तक कि आप अपना स्वयं का प्रदान नहीं करते।

$
curl https://api.empiriolabs.ai/v1/videos/generations \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "extend_from": { "job_id": "<prior_job_id>" }
>
  }'

आप एक सीधा URL भी पास कर सकते हैं:

1
{ "extend_from": { "video_url": "https://media.empiriolabs.ai/..." } }

विस्तार टेम्पलेट्स के साथ रचना कर सकते हैं:

1
{
2
  "template": "action-hero",
3
  "extend_from": { "job_id": "<prior>" }
4
}

प्रत्येक वीडियो मॉडल पर काम बढ़ाएँ

किसी भी समर्थित वीडियो मॉडल के साथ extend_from पास करें। यदि आप model को छोड़ देते हैं, तो EmpirioLabs विस्तार के लिए एक समझदार डिफ़ॉल्ट चुनता है।

त्रुटि कोड