Skip to main content
POST
वीडियो बनाएँ
वर्कस्पेस में पूर्वावलोकन सुविधा का ऐक्सेस आवश्यक है। सेटअप, वेबहुक और परिणामों को संभालने के लिए वीडियो और बैच कार्य देखें।

प्राधिकरण

Authorization
string
header
आवश्यक

Bearer टोकन से प्रमाणीकरण

बॉडी

application/json
model
string
आवश्यक
prompt
string
आवश्यक
duration
integer

वांछित अवधि सेकंड में (प्रदाता/मॉडल पर निर्भर)।

input_video_duration
number<double>

स्रोत वीडियो की अवधि सेकंड में। जब प्रदाता स्रोत वीडियो की अवधि को उत्पन्न आउटपुट से अलग बिल करता है तब आवश्यक।

आवश्यक सीमा: 0 < x <= 3600
input_audio_duration
number<double>

स्रोत ऑडियो की घोषित अवधि सेकंड में, प्रदाता की सीमा जाँचने के लिए। आधिकारिक उपयोग न बताने वाले प्रदाता अपनी समर्थित इनपुट-अवधि की अधिकतम सीमा पर बिल कर सकते हैं।

आवश्यक सीमा: 2 <= x <= 20
size
string

स्पष्ट आयाम (जैसे 1280x720)। resolution या aspect_ratio के साथ नहीं दिया जा सकता।

resolution
string

480p, 720p, 1080p, 1K, 2K, 4K। aspect_ratio के साथ दिया जा सकता है। size के साथ नहीं दिया जा सकता।

aspect_ratio
string

आस्पेक्ट अनुपात जैसे 16:9, 9:16, 1:1। resolution के साथ दिया जा सकता है। size के साथ नहीं दिया जा सकता।

seed
integer
sample_count
integer
आवश्यक सीमा: 1 <= x <= 4
negative_prompt
string
generate_audio
boolean
enhance_prompt
boolean
compression_quality
integer
person_generation
string
resize_mode
string
input_references
object[]

जनरेशन को निर्देशित करने वाले HTTPS चित्र, ऑडियो या वीडियो इनपुट। समर्थित प्रकार, भूमिकाएँ, संख्या और संयोजन चुने गए मॉडल पर निर्भर हैं। जॉब भेजने से पहले GET /videos/models देखें। इस स्कीमा में छोड़ा गया एकवचन संगतता alias input_reference एक multipart चित्र या file_id और image_url में से ठीक एक वाला ऑब्जेक्ट स्वीकार करता है। समर्थन प्रदाता पर निर्भर है।

प्रकार सहित HTTPS मीडिया इनपुट। चित्रों के लिए image_url और ऑडियो या वीडियो के लिए media_url उपयोग करें। भूमिकाएँ बताती हैं कि मॉडल इनपुट का कैसे उपयोग करे; समर्थन प्रदाता और मॉडल के अनुसार बदलता है।

frame_images
object[]

पहले/अंतिम फ़्रेम के HTTPS चित्र। हर frame_type एक बार आ सकता है। साथ में input_reference या input_references में फ़्रेम भूमिकाएँ न दें।

Required array length: 1 - 2 elements
provider_params
object

केवल प्रदाता-विशिष्ट एक्सटेंशन। पूरे अनुरोध का passthrough और दोहराए गए रूटिंग, prompt, callback या बिलिंग फ़ील्ड अस्वीकार किए जाते हैं।

provider_options
object

कैनोनिकल प्रदाता ID (जैसे atlascloud या byteplus) से पहचाने जाने वाले एक्सटेंशन। केवल चुने गए प्रदाता के विकल्प आगे भेजे जाते हैं। provider_params के साथ नहीं दिया जा सकता। रूटिंग, prompt, callback, अवधि, रिज़ॉल्यूशन और आउटपुट-संख्या के लिए सत्यापित शीर्ष-स्तरीय फ़ील्ड उपयोग करने होंगे।

output
object
webhook
object
provider
object

गेटवे चयन के लिए प्रदाता रूटिंग प्राथमिकताएँ।

प्रतिक्रिया

202 - application/json

वीडियो का जवाब

id
string
polling_url
string
websocket_url
string<uri>

एसिंक्रोनस जॉब के सामान्यीकृत जीवनचक्र अपडेट की सदस्यता लेने के लिए WebSocket URL।

model
string
request_id
string
session_id
string
status
enum<string>
उपलब्ध विकल्प:
queued,
processing,
completed,
failed,
cancelled,
expired
lifecycle_status
enum<string>

पोलिंग, WebSocket और webhook उपभोक्ताओं के लिए सामान्यीकृत एसिंक्रोनस जीवनचक्र स्थिति।

उपलब्ध विकल्प:
pending,
running,
completed,
failed,
cancelled,
expired
cancel_url
string<uri> | null

संगतता के लिए आरक्षित; वर्तमान में हमेशा null।

output_access
enum<string>
उपलब्ध विकल्प:
bytes,
signed_url,
both
generation_id
string | null
native_video_id
string | null

प्रदाता का मूल वीडियो/जॉब ID, जब वह गेटवे के स्वामित्व वाले ID से अलग हो।

created_at
started_at
completed_at
object
string
उदाहरण:

"video"

poll_after_seconds
integer
उदाहरण:

20

provider
string
seconds
number
size
string
audio
boolean
content_url
string

जब output_access में bytes शामिल हों तब मौजूद (प्रमाणित एंडपॉइंट)।

download_url
string | null

स्थिति completed होने पर सीधे डाउनलोड के लिए प्रथम-पक्ष हस्ताक्षरित URL।

expires_at
integer | null

हस्ताक्षरित download_url की समय-सीमा समाप्त होने का Unix टाइमस्टैम्प (सेकंड)।

progress
integer | null
progress_source
string
asset
object | null
outputs
object[]
billing
object
webhook
object

सुरक्षित रूप से साफ़ किया गया एसिंक्रोनस webhook कॉन्फ़िगरेशन और डिलीवरी स्थिति। सीक्रेट कभी नहीं लौटाए जाते; has_secret बताता है कि हस्ताक्षरित डिलीवरी सक्षम हैं या नहीं। हस्ताक्षरित डिलीवरी में x-phaseo-signature, x-phaseo-timestamp, x-phaseo-event-id, x-phaseo-event-type, x-phaseo-delivery-key, x-phaseo-attempt और x-phaseo-max-attempts हेडर शामिल होते हैं।

next_webhook_retry_at
string | null

अगले निर्धारित उपयोगकर्ता-webhook पुनः प्रयास का ISO टाइमस्टैम्प, यदि कतार में हो।

last_webhook_progress
number | null

webhook उपभोक्ताओं को भेजा गया सबसे हालिया मोटा प्रगति स्तर।

last_webhook_progress_at
string | null

सबसे हालिया webhook प्रगति स्तर भेजे जाने का ISO टाइमस्टैम्प।

last_webhook_dispatched_at
string | null

सबसे हालिया webhook भेजने के प्रयास का ISO टाइमस्टैम्प।

usage
object
error
unknown
अंतिम संशोधन 2 अक्टूबर 2026