वीडियो बनाना

Seedance, Kling, Omni, Wan, Grok, Veo, Vidu, PixVerse और MiniMax से प्रॉम्प्ट, पहले फ़्रेम (और चाहें तो आखिरी फ़्रेम), या रेफ़रेंस इमेज, वीडियो और ऑडियो के आधार पर वीडियो बनाएँ। वीडियो बनने में कुछ मिनट लगते हैं, इसलिए पहले उसे शुरू करें और फिर स्थिति देखें।

शुरू करें, पोल करें, डाउनलोड करें

import os, time, requests
API = "https://api.zurelay.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"}
# 1. Start the video
response = requests.post(f"{API}/videos", headers=HEADERS, json={
    "model": "seedance-2.0",
    "prompt": "A paper boat drifting down a rain-soaked street at night, neon reflections, slow dolly shot",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
})
response.raise_for_status()  # a 4xx says what to fix
job = response.json()
# 2. Poll until it's done (usually 2 to 6 minutes)
while job["status"] in ("queued", "in_progress"):
    time.sleep(10)
    job = requests.get(f"{API}/videos/{job['id']}", headers=HEADERS).json()
if job["status"] == "failed":
    raise SystemExit(job["error"]["message"])
# 3. Download the MP4
video = requests.get(f"{API}/videos/{job['id']}/content", headers=HEADERS)
open("boat.mp4", "wb").write(video.content)

हर वीडियो मॉडल एक ही तरह से काम करता है: model बदलें, अनुरोध वही रहता है। मॉडल गाइड बताती हैं कि कौन-सा मॉडल किस काम में सबसे अच्छा है: Seedance, Kling, Wan, Grok Imagine, Omni Flash, MiniMax H3, Veo, Vidu और PixVerse।

पैरामीटर

इमेज से शुरुआत

पहला और आखिरी फ़्रेम

स्थिर इमेज को ऐनिमेट करें: वीडियो ठीक first_frame से शुरू होता है। last_frame जोड़ें, तो वीडियो उस इमेज पर खत्म होता है। इससे शॉट की शुरुआत और अंत, दोनों आपके नियंत्रण में रहते हैं। इसके बजाय रेफ़रेंस इमेज से MiniMax starts।

{
  "model": "seedance-2.0",
  "first_frame": "https://example.com/storefront-day.jpg",
  "last_frame": "https://example.com/storefront-night.jpg",
  "prompt": "Time passes from afternoon to night; lights come on inside the shop.",
  "seconds": 6,
  "resolution": "720p"
}

रेफ़रेंस इमेज

ज़्यादा से ज़्यादा 10 इमेज (Seedance up to 9, Kling up to 10, Omni up to 10, Wan up to 10, Grok up to 3, MiniMax up to 9; Veo, Vidu और PixVerse take none) दें और प्रॉम्प्ट में उनका ज़िक्र क्रम से करें (@Image1, @Image2…): उनमें मौजूद लोग, प्रोडक्ट और जगहें वीडियो में दिखाई देंगी।

{
  "model": "seedance-2.5",
  "reference_images": [
    "https://example.com/chef.jpg",
    "https://example.com/kitchen.jpg",
    "https://example.com/dish.jpg"
  ],
  "prompt": "The chef from @Image1 plates the dish from @Image3 in the kitchen from @Image2, close-up, warm light.",
  "seconds": 8,
  "resolution": "720p",
  "aspect_ratio": "9:16"
}

रेफ़रेंस वीडियो और ऑडियो

किसी व्यक्ति का रूप और हावभाव, कैमरे की मूवमेंट या कोई दृश्य लेने के लिए वीडियो दें। आवाज़, धुन या साउंड इफ़ेक्ट के लिए ऑडियो दें। इमेज की तरह प्रॉम्प्ट में इनका ज़िक्र क्रम से करें: @Video1, @Audio1। इन्हें रेफ़रेंस इमेज के साथ इस्तेमाल किया जा सकता है, लेकिन पहले फ़्रेम के साथ नहीं।

{
  "model": "seedance-2.5",
  "reference_images": ["https://example.com/singer.jpg"],
  "reference_videos": ["https://example.com/dance-moves.mp4"],
  "reference_audio": ["https://example.com/chorus.mp3"],
  "prompt": "The singer from @Image1 performs the dance from @Video1 on a rooftop at dusk, singing to @Audio1.",
  "seconds": 8,
  "resolution": "720p"
}

मॉडल रेफ़रेंस वीडियो का हर सेकंड पढ़ता है, इसलिए उन सेकंड का भी शुल्क लगता है, जो प्रति सेकंड की कीमत का एक हिस्सा होता है: 10 s के रेफ़रेंस के साथ 5 s के वीडियो की कीमत में उसके 5 सेकंड और रेफ़रेंस के 10 सेकंड शामिल होते हैं। रेफ़रेंस ऑडियो का कोई अतिरिक्त शुल्क नहीं है। हर वीडियो ऑब्जेक्ट में रेफ़रेंस के वे सेकंड दिखते हैं जिनका शुल्क लगा है (reference_seconds)।

वीडियो में बदलाव करना और उसे बढ़ाना

रेफ़रेंस वीडियो में बदलाव करने के लिए (किसी व्यक्ति या चीज़ को बदलना, कुछ जोड़ना या हटाना, संगीत बदलना) reference_mode को edit पर सेट करें। उसे आगे या पीछे बढ़ाने के लिए इसे extend पर सेट करें। प्रॉम्प्ट में बताएं कि क्या करना है: “@Video1 की कार को @Image1 वाली कार से बदलें”, “@Video1 को आगे बढ़ाएं, जिसमें डांसर मंच से जा रहा हो”।

• बदलाव करने पर वीडियो का आकार और अवधि वही रहती है, इसलिए aspect_ratio और seconds न दें। शुल्क सबसे लंबे रेफ़रेंस वीडियो की अवधि के हिसाब से लगता है, जिसकी अवधि 4 से 30 सेकंड होनी चाहिए।
• वीडियो बढ़ाने पर उसका आकार वही रहता है; seconds तय करता है कि नए वीडियो की अवधि कितनी होगी।
• reference_mode के बिना मॉडल प्रॉम्प्ट के आधार पर तय करता है। अगर प्रॉम्प्ट में बदलाव करने को कहा गया हो और seconds या aspect_ratio सेट हो, तो वीडियो बनाना विफल हो सकता है (विफल वीडियो का कोई शुल्क नहीं लगता)।

इमेज के लिए नियम

• PNG, JPEG या WebP, सार्वजनिक https लिंक या डेटा URL के रूप में, अधिकतम 10 MB।
• हर तरफ़ 300 से 6000 पिक्सल, और चौड़ाई या ऊंचाई का अनुपात 5:2 से ज़्यादा नहीं होना चाहिए। इन सीमाओं से बाहर के डेटा URL शुरुआत में ही अस्वीकार कर दिए जाते हैं और वजह बताने वाला मैसेज दिखता है। लिंक वीडियो शुरू होने पर पढ़े जाते हैं: अगर लिंक पर इस्तेमाल करने लायक इमेज नहीं है, तो वीडियो invalid_image के साथ विफल हो जाता है और कोई शुल्क नहीं लगता।
• एक अनुरोध में फ़्रेम या रेफ़रेंस दें, दोनों नहीं।
• अनुरोध JSON में होते हैं: इमेज लिंक या डेटा URL के रूप में दें, मल्टीपार्ट अपलोड के रूप में नहीं।

वीडियो ऑब्जेक्ट

{
  "id": "video_abc123",
  "object": "video",
  "model": "seedance-2.0",
  "status": "completed",
  "progress": 100,
  "created_at": 1790870400,
  "completed_at": 1790870562,
  "expires_at": 1793462400,
  "seconds": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "size": "1280x720",
  "generate_audio": true,
  "url": "https://...signed link...",
  "url_expires_at": 1790956962,
  "cost": 1.035,
  "error": null
}

अन्य एंडपॉइंट

वीडियो का भुगतान

वीडियो की कीमत उसकी प्रति सेकंड दर (रिज़ॉल्यूशन के हिसाब से) को उसकी अवधि से गुणा करके तय होती है; बिना आवाज़ के हर सेकंड Kling और PixVerse cost कम; रेफ़रेंस वीडियो की अवधि के लिए इस दर के एक हिस्से के हिसाब से अतिरिक्त शुल्क लगता है। वीडियो बनाना शुरू करने पर, यह रकम आपके बैलेंस में रोक ली जाती है; वीडियो बन जाने पर काटी जाती है और न बन पाने पर वापस उपलब्ध हो जाती है। वीडियो न बन पाने पर कोई शुल्क नहीं लगता।