वीडियो जनरेशन API कॉल दस्तावेज़ीकरण

kozeai, OpenAI Sora के साथ संगत वीडियो जनरेशन इंटरफ़ेस प्रदान करता है, जो **अतुल्यकालिक कार्य** मोड का उपयोग करता है: पहले `task_id` प्राप्त करने के लिए कार्य सबमिट करें, फिर कार्य की स्थिति की जाँच करें, और कार्य पूरा होने पर वीडियो सामग्री डाउनलोड करें।

प्रमाणीकरण

सभी अनुरोधों का प्रमाणीकरण `Authorization: Bearer ` का उपयोग करके किया जाता है।

कंसोल में API टोकन बनाने के बाद इसका उपयोग करें।

export KOZEAI_API_KEY="sk-your-token"
export KOZEAI_BASE_URL="https://api.kozeai.com"

इंटरफ़ेस अवलोकन

<टेबल> <शीर्षक> विधि पथ उद्देश्य पोस्ट /v1/videos/generations वीडियो कार्य बनाएँ गेट /v1/videos/{task_id} क्वेरी कार्य स्थिति प्राप्त करें /v1/videos/{task_id}/content ऑनलाइन चलाएं या mp4 डाउनलोड करें

सबमिशन इंटरफ़ेस द्वारा लौटाया गया task_12345 के रूप में टास्क आईडी केवल वर्तमान उपयोगकर्ता से संबंधित है।

---

1. वीडियो कार्य बनाएं

curl "$KOZEAI_BASE_URL/v1/videos/generations" \

-H "Authorization: Bearer $KOZEAI_API_KEY" \

-H "Content-Type: application/json" \

-d '{

"model": "video-ds-2.0",

"प्रॉम्प्ट": "गर्म धूप में दौड़ती हुई बिल्ली का एक सिनेमाई 9:16 मिनट का वीडियो",

"सेकंड": 15,

"आस्पेक्ट रेशियो": "9:16"


} 

अनुरोध पैरामीटर

यूआरएल <टीआर> <टीडी><कोड>ऑडियो <टीडी>एरे <टीडी>नहीं <टीडी>संदर्भ ऑडियो यूआरएल <ब्लॉककोट> <पी>विभिन्न अपस्ट्रीम मॉडल अलग-अलग पैरामीटर का समर्थन कर सकते हैं। सूचीबद्ध न किए गए पैरामीटर अपस्ट्रीम प्रोटोकॉल के अनुसार पास किए जाएंगे।

छवि-जनित वीडियो (संदर्भ छवियों के साथ)

संदर्भ छवियों के आधार पर वीडियो जनरेट करने के लिए images ऐरे पास करें:

curl "$KOZEAI_BASE_URL/v1/videos/generations" \

-H "Authorization: Bearer $KOZEAI_API_KEY"

-H "Content-Type: application/json"

-d '{

"model": "video-ds-2.0",

"prompt": "संदर्भ छवि शैली का उपयोग करें और एक सहज उत्पाद वीडियो बनाएं",

"seconds": 15,

"आस्पेक्ट_रेशियो": "9:16",

"वीडियो": ["https://example.com/input.mp4"],

audios: [https://example.com/input.mp3]

}

• images इमेज यूआरएल या बेस64 को सपोर्ट करता है।
• videos / audios वैकल्पिक संदर्भ सामग्री हैं।
• चैट ऑटो-कंप्लीट इंटरफ़ेस (लेख के अंत में देखें) के माध्यम से कॉल करते समय, बस इमेज को मैसेज में अटैच करें; सिस्टम इसे स्वचालित रूप से images पैरामीटर में बदल देगा।

प्रतिक्रिया (सबमिशन सफल)

{

"id": "task_12345",

"task_id": "task_12345",

"object": "वीडियो",

"मॉडल": "वीडियो-डीएस-2.0",

"स्थिति": "कतार में",

"प्रगति": 0,

"created_at": 

}

स्थिति मान: कतार में (कतार में), प्रगति में (प्रगति में), पूर्ण (पूर्ण), असफल (असफल)।

---

2. पोलिंग टास्क स्टेटस

सबमिशन द्वारा लौटाए गए id का उपयोग पोल करने के लिए करें, अनुशंसित अंतराल 3-5 सेकंड का है।

curl "$KOZEAI_BASE_URL/v1/videos/task_12345" \
-H "Authorization: Bearer $KOZEAI_API_KEY"

प्रतिक्रिया (जनरेट हो रही है)

{

"id": "task_12345",

"object": "video",

"model": "video-ds-2.0",

"स्थिति": "प्रगति में",
"प्रगति": 45,

"बनाया गया": 1751000000
}

प्रतिक्रिया (पूर्ण)

{

"id": "task_12345",

"object": "video",

"model": "video-ds-2.0",

"status": 

पूरा होने के बाद, `metadata.content_url` सीधे एक्सेस करने योग्य वीडियो का पता प्रदान करता है; इसे नीचे दिए गए कंटेंट इंटरफ़ेस का उपयोग करके डाउनलोड भी किया जा सकता है।`

प्रतिक्रिया (असफल)

{

"id": "task_12345",

"object": "video",

"status": "failed",

"त्रुटि": { "संदेश": "विफलता का कारण" }
}

---

3. वीडियो सामग्री डाउनलोड करें

curl -L "$KOZEAI_BASE_URL/v1/videos/task_12345/content" \

-H "Authorization: Bearer $KOZEAI_API_KEY" \

-o result.mp4


कार्य पूरा न होने पर (अभी भी कतार में/उत्पन्न हो रहा है) 409 कॉन्फ्लिक्ट त्रुटि देता है।

खंडित का समर्थन करता है  अनुरोध हेडर का उपयोग करके डाउनलोड/ड्रैग-एंड-ड्रॉप प्लेबैक।

यह  लौटाता है।


पूर्ण उदाहरण
जावास्क्रिप्ट (फ़ेच + पोलिंग)
const BASE = process.env.KOZEAI_BASE_URL;

const KEY = process.env.KOZEAI_API_KEY;

const हेडर = { प्राधिकरण: `धारक ${KEY}` };


// 1. कार्य सबमिट करें
const सबमिट = await फ़ेच(`${BASE}/v1/videos/generations`, {

method: POST,

headers: { ...headers, Content-Type: } class="hljs-string">'application/json' },

body: JSON.stringify({

model: 'video-ds-2.0',

prompt: 'कांच पर इत्र की बोतल का एक सहज व्यावसायिक वीडियो',

seconds: 15,

aspect_ratio: '9:16',

});

const task = await submit.json();

const taskId = task.id;

// 2. पूर्ण होने तक पोल करें
एसिंक्रोनस फ़ंक्शन `पोल()` {

जब तक (सही) {

स्थिरांक res = प्रतीक्षा करें fetch(`${BASE}/v1/videos/` `{taskId}`, { हेडर });

const data = await res.json();

if (data.status === 'completed') return data;

यदि (data.status === 'असफल') तो 'थ्रो' करें और 'नया' त्रुटि उत्पन्न करें (data.error?.message || 'असफल');

await new Promise((r) = > setTimeout(r, 5000));

}
}
const done = await poll();


// 3. वीडियो का पता प्राप्त करें
console.log(वीडियो पता:, done.metadata?.content_url
|| `${BASE}/v1/videos/${taskId}/content` );


पायथन (अनुरोध + मतदान)
आयात os, time, requests

BASE = os.environ["KOZEAI_BASE_URL"]
KEY = os.environ["KOZEAI_API_KEY"]
headers = {"Authorization": f"Bearer {KEY}"}

# 1. कार्य सबमिट करें
resp = requests.post(
f"{BASE}/v1/videos/generations",
headers=headers,
json={
"model": "video-ds-2.0",

"प्रॉम्प्ट": "गर्म धूप में दौड़ती बिल्ली का एक सिनेमाई 9:16 मिनट का वीडियो",

"सेकंड": 15,

"आस्पेक्ट रेशियो": "9:16",

},
)
task_id = resp.json()["id"]

# 2. पोलिंग
while True:
data = requests.get(f"{BASE}/v1/videos/{task_id}", headers=headers).json()
if data["status"] == "पूर्ण":
ब्रेक
यदि data["स्थिति"] == "असफल":
रनटाइम त्रुटि उत्पन्न करें (data.get("त्रुटि", {}).get("संदेश", "असफल"))
time.sleep(5)

# 3. डाउनलोड
mp4 = requests.get(f"{BASE}/v1/videos/{task_id}/content", headers=headers)
with open("result.mp4", "wb") as f: f.write(mp4.content)


चैट पूर्णता इंटरफ़ेस में कॉल किया गया (संगत उपयोग)

वीडियो मॉडल को /v1/chat/completions के माध्यम से भी कॉल किया जा सकता है, जिससे चैट क्लाइंट का पुन: उपयोग आसान हो जाता है।
 अनुरोध करते समय, `model` में वीडियो मॉडल का नाम पास करें, और सिस्टम स्वचालित रूप से इसे वीडियो टास्क में परिवर्तित कर देगा:

curl $KOZEAI_BASE_URL/v1/chat/completions
 \
-H Authorization: Bearer $KOZEAI_API_KEY \
-H Content-Type: application/json \
-d {
Model: } `
returns` "video-ds-2.0
,

"messages: [{"role: "user, "content: "धूप में दौड़ती हुई बिल्ली, सिनेमाई, 9:16}]

}

चैट पूर्णता लौटाता है
 प्रारूप `message.content` है, जिसमें कार्य की स्थिति और एक लिंक `/v1/videos/{task_id}` शामिल है। यह लिंक वीडियो पूरा होने पर उसे चलाएगा। चैट लॉबी पेज इस विधि का उपयोग करता है।



दोनों प्रवेश बिंदु (/v1/videos/generations और /v1/chat/completions) एक ही कार्य प्रणाली साझा करते हैं और एक दूसरे के साथ टकराव नहीं करते हैं। सीधे एकीकरण के लिए, मानक `/v1/videos/*` इंटरफ़ेस का उपयोग करने की अनुशंसा की जाती है।
 






त्रुटि कोड

पैरामीटर	प्रकार	आवश्यक	विवरण
मॉडल	स्ट्रिंग	हाँ	वीडियो मॉडल का नाम, जैसे video-ds-2.0
प्रॉम्प्ट	स्ट्रिंग	हाँ	वीडियो सामग्री विवरण
सेकंड	पूर्णांक	नहीं	वीडियो की अवधि (सेकंड), अपस्ट्रीम मॉडल समर्थन सीमा के आधार पर
आस्पेक्ट रेशियो	स्ट्रिंग	नहीं	आस्पेक्ट रेशियो, आमतौर पर इस्तेमाल किया जाता है 9:16, 16:9, 1:1
छवियां	सरणी	नहीं	संदर्भ छवियों का URL या base64
वीडियो	सरणी	नहीं	संदर्भ वीडियो

स्थिति कोड	अर्थ
401	टोकन गायब है, समाप्त हो गया है, या अमान्य
403	अपर्याप्त शेष राशि, या वर्तमान समूह के पास इस मॉडल के लिए अनुमति नहीं है
404	कार्य आईडी मौजूद नहीं है, या वर्तमान उपयोगकर्ता से संबंधित नहीं है; या मॉडल कॉन्फ़िगर नहीं किया गया है।
409	वीडियो सामग्री तैयार नहीं है (कार्य अभी भी कतार में है/उत्पन्न हो रहा है)
429	रेट लिमिट ट्रिगर हो रही है
502	अपस्ट्रीम आपूर्तिकर्ता विफल रहा या अमान्य लौटाया परिणाम