Endpoints

वीडियो (एसिंक जॉब)

POST /videos से वीडियो जॉब बनाएँ, GET /videos/{id} से स्थिति पोल करें और नतीजा डाउनलोड करें। पैरामीटर, बिलिंग और त्रुटियाँ यहाँ हैं।

playground में आज़माएं

Veo 3.1, Sora 2 Pro, Kling, Seedance, Runway, Wan, Hailuo और अन्य से वीडियो बनाएँ। वीडियो जनरेशन में दसियों सेकंड से कई मिनट लगते हैं, इसलिए यह एसिंक्रोनस जॉब के रूप में चलता है: आप जॉब बनाते हैं, उसकी स्थिति पोल करते हैं, फिर नतीजा डाउनलोड करते हैं।

चरण	अनुरोध
1. बनाएँ	`POST /api/v1/videos`
2. पोल करें	`GET /api/v1/videos/{id}`
3. डाउनलोड करें	`GET /api/v1/videos/{id}/content?index=0`

जॉब बनाएँ

POST https://api14.com/api/v1/videos

पैरामीटर	प्रकार	आवश्यक	विवरण
`model`	string	हाँ	वीडियो मॉडल id, जैसे `google/veo-3.1-fast`।
`prompt`	string	हाँ	वीडियो में क्या होता है।
`duration`	number	नहीं	सेकंड में लंबाई। डिफ़ॉल्ट मॉडल की पहली समर्थित अवधि।
`resolution`	string	नहीं	जैसे `720p`, `1080p`। मॉडल द्वारा समर्थित होना चाहिए।
`aspect_ratio`	string	नहीं	जैसे `16:9`, `9:16`।
`generate_audio`	boolean	नहीं	जहाँ समर्थित हो साउंडट्रैक बनाएँ (डिफ़ॉल्ट `true`)।
`image`	string	नहीं	पहला फ़्रेम, URL या `data:` URI के रूप में (image-to-video)।

हर मॉडल के लिए समर्थित अवधि, रेज़ोल्यूशन और आस्पेक्ट रेशियो: GET /videos/models (सार्वजनिक) या मॉडल पेज।

बैलेंस जाँच

जॉब सबमिट होने से पहले गेटवे उसकी कीमत का अनुमान अवधि × अनुरोधित रेज़ोल्यूशन (और ऑडियो विकल्प) की प्रति सेकंड कीमत के रूप में लगाता है। यदि आपका बैलेंस अनुमान से कम है तो अनुरोध 402 insufficient_balance के साथ विफल होता है और कुछ शुरू नहीं होता।

प्रतिक्रिया

{
  "id": "vid_01JABCDEF",
  "status": "queued",
  "polling_url": "/api/v1/videos/vid_01JABCDEF"
}

जॉब पोल करें

GET https://api14.com/api/v1/videos/{id}

{
  "id": "vid_01JABCDEF",
  "status": "completed",
  "generation_id": "gen-1791100000-abc",
  "unsigned_urls": ["/api/v1/videos/vid_01JABCDEF/content?index=0"],
  "usage": { "cost": 1.2 }
}

`status`	अर्थ
`queued`	प्रोवाइडर की प्रतीक्षा में।
`in_progress`	रेंडर हो रहा है।
`completed`	पूरा; `unsigned_urls` में आउटपुट सूचीबद्ध हैं।
`failed`, `cancelled`, `expired`	बिना आउटपुट के समाप्त; `error` देखें। आपसे शुल्क नहीं लिया जाता।

हर 5-10 सेकंड में पोल करें। जॉब केवल उसे बनाने वाला खाता पढ़ सकता है; अन्य id 404 not_found लौटाते हैं।

नतीजा डाउनलोड करें

GET https://api14.com/api/v1/videos/{id}/content?index=0

आपकी API कुंजी के साथ वीडियो बाइट (आमतौर पर video/mp4) लौटाता है। आउटपुट URL हमेशा गेटवे की ओर इशारा करते हैं, कभी अपस्ट्रीम प्रोवाइडर की ओर नहीं। यदि फ़ाइल तैयार नहीं है या समाप्त हो चुकी है तो content_unavailable मिलता है।

उदाहरण

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

// Video generation is asynchronous: submit, then poll until completed.
let job = await client.post("/videos", { body: {
  "model": "google/veo-3.1-fast",
  "prompt": "A drone shot over turquoise ocean waves at sunrise",
  "duration": 8,
  "resolution": "720p",
  "aspect_ratio": "16:9"
} });
while (!["completed", "failed"].includes(job.status)) {
  await new Promise((r) => setTimeout(r, 5000));
  job = await client.get(`/videos/${job.id}`);
}
console.log(job.status, job.unsigned_urls);

बिलिंग

आपसे एक बार शुल्क लिया जाता है, जब जॉब completed पर पहुँचता है, प्रोवाइडर की वास्तविक लागत पर। विफल, रद्द और समाप्त जॉब मुफ़्त हैं। जॉब बैकग्राउंड में भी पूरे होते हैं, इसलिए जिस जॉब को आपने कभी पोल नहीं किया वह भी सेटल होता है और उपयोग में दिखता है।

त्रुटियाँ

स्टेटस	कोड	कब
402	`insufficient_balance`	बैलेंस जॉब की अनुमानित कीमत से कम है।
403	`plan_required`	आपके प्लान में वीडियो मॉडल शामिल नहीं हैं।
404	`model_not_found` / `not_found`	अज्ञात मॉडल, या जॉब id आपका नहीं।
502	`upstream_unavailable`	स्थिति पढ़ी नहीं जा सकी; रीट्राई करें।

देखें त्रुटियाँ।