वीडियो जनरेशन टास्क सबमिट करें

Felo API Support

MIT

सर्वर

https://openapi.felo.ai

क्लाइंट लाइब्रेरी

Shell Curl

वीडियो जनरेशन टास्क सबमिट करें

एक async वीडियो जनरेशन टास्क बनाता है और तुरंत task_id लौटाता है (HTTP 202)। GET /api/v1/videos/generations/{task_id} को सफल होने तक पोल करें। request बॉडी को फ़्लैट ({model, prompt, ...}) या नेस्टेड ({model, input: {prompt, ...}}) रूप में दिया जा सकता है; मौजूद होने पर input ऑब्जेक्ट को प्राथमिकता मिलती है। callback फ़ील्ड (callBackUrl / callback_url / callbackUrl) अनदेखे किए जाते हैं।

तीन परस्पर अनन्य input मोड:

text-to-video: केवल prompt;
image-to-video (पहला/अंतिम फ़्रेम): first_frame_url (+ वैकल्पिक last_frame_url);
omni-reference: reference_image_urls / reference_video_urls / reference_audio_urls. पहले/अंतिम फ़्रेम को किसी भी मल्टीमॉडल reference input के साथ मिलाने पर 400 invalid_request_error लौटता है।

headers

X-Request-Id
टाइप: string

वैकल्पिक caller request ID, जो डायग्नोस्टिक्स के लिए वापस भेजी जाती है।
X-Felo-Channel
टाइप: string

क्रमबद्ध, कॉमा से अलग किए गए सार्वजनिक चैनल कोड। default का उपयोग करने के लिए यह header छोड़ दें; default अकेले ही इस्तेमाल होना चाहिए। वॉलेट मोड में, default मॉडल के प्रभावी सार्वजनिक चैनल क्रम को उल्टे क्रम में स्कैन करता है, अप्रकाशित या अनुपलब्ध चैनल छोड़ देता है, और पहले उपलब्ध चैनल का प्रोवाइडर चुनता है। इसमें उसी upstream मॉडल ID और service tier वाले उस प्रोवाइडर के उपलब्ध endpoints शामिल होते हैं। स्पष्ट रूप से दिए गए चैनल client द्वारा निर्दिष्ट क्रम में सत्यापित होते हैं; केवल पहले चैनल का प्रोवाइडर समूह सबमिट किया जाता है। अन्य प्रोवाइडर पर स्वचालित fallback नहीं होता। पुराने प्रोवाइडर headers चैनल रूटिंग को ओवरराइड नहीं कर सकते।

बॉडी·VideoGenerationRequest

आवश्यक

application/json

वीडियो जनरेशन input। या तो फ़्लैट ({model, prompt, ...}) या नेस्टेड ({model, input: {...}})। input को प्राथमिकता मिलती है। ठीक एक input मोड का उपयोग करना चाहिए; पहले/अंतिम फ़्रेम को मल्टीमॉडल reference inputs के साथ मिलाना अस्वीकार किया जाता है।

model
टाइप: string
आवश्यक

Felo के लिए मॉडल नाम, जैसे seedance-2.0-mini।
aspect_ratio
टाइप: string enum
मान
- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
- 21:9
- adaptive
duration
टाइप: integer
न्यूनतम:
4
अधिकतम:
15

Integer numbers.
first_frame_url
टाइप: string फ़ॉर्मेट: uri
generate_audio
टाइप: boolean
input
टाइप: object

वैकल्पिक नेस्टेड input ऑब्जेक्ट; मौजूद होने पर इसके फ़ील्ड सहोदर फ़ील्ड पर प्राथमिकता लेते हैं।
- aspect_ratio
  टाइप: string enum
  
  output आस्पेक्ट अनुपात; adaptive input इमेज के अनुपात का पालन करता है।
  
  मान
  16:9
  9:16
  1:1
  4:3
  3:4
  21:9
  adaptive
- duration
  टाइप: integer
  न्यूनतम:
  4
  अधिकतम:
  15
  
  output अवधि सेकंड में।
- first_frame_url
  टाइप: string फ़ॉर्मेट: uri
  
  पहले फ़्रेम की इमेज URL (image-to-video मोड)।
- generate_audio
  टाइप: boolean
  
  सिंक किया गया ऑडियो ट्रैक जनरेट करना है या नहीं।
- last_frame_url
  टाइप: string फ़ॉर्मेट: uri
  
  अंतिम फ़्रेम की इमेज URL; इसे first_frame_url के साथ ही उपयोग करना चाहिए।
- prompt
  टाइप: string
  अधिकतम लंबाई:
  2000
  
  Prompt। text-to-video और omni-reference मोड के लिए आवश्यक।
- reference_audio_urls
  टाइप: array string[] …3फ़ॉर्मेट: uri
  
  omni-reference ऑडियो क्लिप।
- reference_image_urls
  टाइप: array string[] …9फ़ॉर्मेट: uri
  
  omni-reference इमेज। पहले/अंतिम फ़्रेम के साथ परस्पर अनन्य।
- reference_video_urls
  टाइप: array string[] …3फ़ॉर्मेट: uri
  
  omni-reference वीडियो। पहले/अंतिम फ़्रेम के साथ परस्पर अनन्य। वीडियो देने पर बिलिंग इकाई मूल्य बदलता है और token गणना में input अवधि जुड़ती है।
- resolution
  टाइप: string enum
  
  output रिज़ॉल्यूशन। अधिक रिज़ॉल्यूशन अधिक tokens लेता है और अधिक खर्च करता है।
  
  मान
  480p
  720p
  1080p
  4k
- service_tier
  टाइप: string | null
  
  फ़िलहाल केवल default (standard) समर्थित है। छोड़ा गया, null, उपनाम और असमर्थित स्ट्रिंग्स default पर fallback करते हैं; अन्य प्रकार HTTP 400 लौटाते हैं। कॉन्फ़िगर किए गए चैनल और कीमतें अपरिवर्तित रहती हैं। Text API प्रोवाइडर का standard मान भेजते हैं; Decisions और जनरेशन API upstream फ़ील्ड छोड़ देते हैं।
last_frame_url
टाइप: string फ़ॉर्मेट: uri
prompt
टाइप: string
अधिकतम लंबाई:
2000
reference_audio_urls
टाइप: array string[] …3फ़ॉर्मेट: uri
reference_image_urls
टाइप: array string[] …9फ़ॉर्मेट: uri
reference_video_urls
टाइप: array string[] …3फ़ॉर्मेट: uri
resolution
टाइप: string enum
मान
- 480p
- 720p
- 1080p
- 4k

service_tier
टाइप: string | null

फ़िलहाल केवल default (standard) समर्थित है। छोड़ा गया, null, उपनाम और असमर्थित स्ट्रिंग्स default पर fallback करते हैं; अन्य प्रकार HTTP 400 लौटाते हैं। कॉन्फ़िगर किए गए चैनल और कीमतें अपरिवर्तित रहती हैं। Text API प्रोवाइडर का standard मान भेजते हैं; Decisions और जनरेशन API upstream फ़ील्ड छोड़ देते हैं।

responses

202
टाइप: object · VideoGenerationAccepted

टास्क स्वीकार किया गया
kind
enum
const:
video
आवश्यक
मान
video
outputs
टाइप: array string[]
आवश्यक

टास्क सफल होने तक खाली।

status
enum
const:
queued
आवश्यक
मान
queued
task_id
टाइप: string
आवश्यक

पोलिंग के लिए उपयोग करने वाला टास्क ID।
application/json
400
टाइप: object · GenerationError

अमान्य request (अज्ञात मॉडल, मिश्रित input मोड, अमान्य फ़ील्ड)

OpenAI-संगत एरर एनवेलप।
error
टाइप: object
message
टाइप: string
आवश्यक
type
टाइप: string enum
आवश्यक
मान
invalid_request_error
server_error
code
टाइप: string
param
टाइप: string null स्वीकार्य
application/json
401
टाइप: object · GenerationError

अमान्य या अनुपलब्ध Felo API key

OpenAI-संगत एरर एनवेलप।
error
टाइप: object
message
टाइप: string
आवश्यक
type
टाइप: string enum
आवश्यक
मान
invalid_request_error
server_error
code
टाइप: string
param
टाइप: string null स्वीकार्य
application/json
402
टाइप: object · GenerationError

अपर्याप्त शेष राशि / बिलिंग आवश्यकता पूरी नहीं हुई

OpenAI-संगत एरर एनवेलप।
error
टाइप: object
message
टाइप: string
आवश्यक
type
टाइप: string enum
आवश्यक
मान
invalid_request_error
server_error
code
टाइप: string
param
टाइप: string null स्वीकार्य
application/json
403
टाइप: object · GenerationError

खाते को अनुमति नहीं है (सदस्यता आवश्यक है या उपयोगकर्ता पर प्रतिबंध है)। बंद किए गए मॉडल भी upstream कॉल से पहले अस्वीकार कर दिए जाते हैं। पहले से स्वीकृत requests और टास्क जारी रहते हैं।

OpenAI-संगत एरर एनवेलप।
error
टाइप: object
message
टाइप: string
आवश्यक
type
टाइप: string enum
आवश्यक
मान
invalid_request_error
server_error
code
टाइप: string
param
टाइप: string null स्वीकार्य
application/json
429
टाइप: object · GenerationError

request या खर्च सीमा पूरी हो गई

OpenAI-संगत एरर एनवेलप।
error
टाइप: object
message
टाइप: string
आवश्यक
type
टाइप: string enum
आवश्यक
मान
invalid_request_error
server_error
code
टाइप: string
param
टाइप: string null स्वीकार्य
application/json
502
टाइप: object · GenerationError

upstream प्रोवाइडर विफल रहा

OpenAI-संगत एरर एनवेलप।
error
टाइप: object
message
टाइप: string
आवश्यक
type
टाइप: string enum
आवश्यक
मान
invalid_request_error
server_error
code
टाइप: string
param
टाइप: string null स्वीकार्य
application/json
503
टाइप: object · GenerationError

जनरेशन सेवा या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है

OpenAI-संगत एरर एनवेलप।
error
टाइप: object
message
टाइप: string
आवश्यक
type
टाइप: string enum
आवश्यक
मान
invalid_request_error
server_error
code
टाइप: string
param
टाइप: string null स्वीकार्य
application/json

post/api/v1/videos/generations

curl https://openapi.felo.ai/api/v1/videos/generations \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "model": "seedance-2.0-mini",
  "prompt": "a cinematic trailer shot, 720p",
  "resolution": "720p",
  "duration": 5,
  "generate_audio": true
}'

स्कीमा दिखाएँ

{
  "task_id": "string",
  "status": "queued",
  "kind": "video",
  "outputs": [
    "string"
  ]
}

टास्क स्वीकार किया गया

वीडियो जनरेशन टास्क सबमिट करें

प्रमाणीकरणRequired

वीडियो जनरेशन टास्क सबमिट करें