একটি ভিডিও জেনারেশন টাস্ক জমা দিন

Felo API Support

MIT

সার্ভার

https://openapi.felo.ai

ক্লায়েন্ট লাইব্রেরি

Shell Curl

একটি ভিডিও জেনারেশন টাস্ক জমা দিন

একটি অ্যাসিঙ্ক্রোনাস ভিডিও জেনারেশন টাস্ক তৈরি করে এবং সঙ্গে সঙ্গে একটি task_id ফেরত দেয় (HTTP 202)। সফল না হওয়া পর্যন্ত GET /api/v1/videos/generations/{task_id} পোল করুন। রিকোয়েস্ট বডি ফ্ল্যাট আকারে ({model, prompt, ...}) অথবা নেস্টেড আকারে ({model, input: {prompt, ...}}) — দুইভাবেই দেওয়া যায়; উপস্থিত থাকলে input অবজেক্টটিই অগ্রাধিকার পায়। callback ফিল্ডগুলো (callBackUrl / callback_url / callbackUrl) উপেক্ষা করা হয়।

তিনটি পারস্পরিক একচেটিয়া ইনপুট মোড:

text-to-video: শুধু prompt;
image-to-video (প্রথম/শেষ ফ্রেম): first_frame_url (+ ঐচ্ছিক last_frame_url);
omni-reference: reference_image_urls / reference_video_urls / reference_audio_urls। প্রথম/শেষ ফ্রেমের সঙ্গে যেকোনো মাল্টিমোডাল রেফারেন্স ইনপুট মেশালে 400 invalid_request_error ফেরত আসে।

হেডার

X-Request-Id
টাইপ: string

ঐচ্ছিক কলার রিকোয়েস্ট ID, ডায়াগনস্টিকসের জন্য হুবহু ফেরত দেওয়া হয়।
X-Felo-Channel
টাইপ: string

কমা-বিভক্ত, ক্রমানুসারে সাজানো পাবলিক চ্যানেল কোড। ডিফল্ট ব্যবহার করতে এই হেডার বাদ দিন; default একা ব্যবহার করতে হবে। ওয়ালেট মোডে default মডেলের কার্যকর পাবলিক চ্যানেল ক্রম উল্টো দিক থেকে স্ক্যান করে, অপ্রকাশিত বা অনুপলব্ধ চ্যানেল এড়িয়ে যায় এবং প্রথম উপলব্ধ চ্যানেলের প্রোভাইডার নির্বাচন করে। সেই প্রোভাইডারের মধ্যে একই আপস্ট্রিম মডেল ID ও সার্ভিস টিয়ারযুক্ত উপলব্ধ এন্ডপয়েন্টগুলোও অন্তর্ভুক্ত করে। স্পষ্টভাবে উল্লেখ করা চ্যানেল ক্লায়েন্টের দেওয়া ক্রমে যাচাই করা হয়; কেবল প্রথম চ্যানেলের প্রোভাইডার গ্রুপই জমা দেওয়া হয়। অন্য প্রোভাইডারে স্বয়ংক্রিয় ফলব্যাক নেই। লিগ্যাসি প্রোভাইডার হেডার চ্যানেল রাউটিংকে ওভাররাইড করতে পারে না।

বডি·VideoGenerationRequest

আবশ্যক

application/json

ভিডিও জেনারেশন ইনপুট। ফ্ল্যাট ({model, prompt, ...}) বা নেস্টেড ({model, input: {...}}) — যেকোনো একটি। input অগ্রাধিকার পায়। ঠিক একটি ইনপুট মোড ব্যবহার করতে হবে; প্রথম/শেষ ফ্রেমের সঙ্গে মাল্টিমোডাল রেফারেন্স ইনপুট মেশালে প্রত্যাখ্যাত হয়।

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
  
  আউটপুট অ্যাসপেক্ট রেশিও; adaptive ইনপুট ইমেজের অনুপাত অনুসরণ করে।
  
  মান
  16:9
  9:16
  1:1
  4:3
  3:4
  21:9
  adaptive
- duration
  টাইপ: integer
  সর্বনিম্ন:
  4
  সর্বোচ্চ:
  15
  
  সেকেন্ডে আউটপুট সময়কাল।
- 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 ভিডিও। প্রথম/শেষ ফ্রেমের সঙ্গে পারস্পরিক একচেটিয়া। ভিডিও দিলে বিলিং ইউনিট মূল্য বদলায় এবং টোকেন গণনায় ইনপুট সময়কাল যোগ হয়।
- resolution
  টাইপ: string enum
  
  আউটপুট রেজোলিউশন। উচ্চ রেজোলিউশনে বেশি টোকেন লাগে এবং খরচও বেশি হয়।
  
  মান
  480p
  720p
  1080p
  4k
- service_tier
  টাইপ: string | null
  
  বর্তমানে কেবল default (standard) সমর্থিত। বাদ দেওয়া, null, alias এবং অসমর্থিত স্ট্রিং default-এ ফিরে যায়; অন্য টাইপে HTTP 400 ফেরত আসে। কনফিগার করা চ্যানেল ও মূল্য অপরিবর্তিত থাকে। টেক্সট API প্রোভাইডারের standard মান পাঠায়; Decisions ও জেনারেশন API আপস্ট্রিম ফিল্ড বাদ দেয়।
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, alias এবং অসমর্থিত স্ট্রিং default-এ ফিরে যায়; অন্য টাইপে HTTP 400 ফেরত আসে। কনফিগার করা চ্যানেল ও মূল্য অপরিবর্তিত থাকে। টেক্সট API প্রোভাইডারের standard মান পাঠায়; Decisions ও জেনারেশন API আপস্ট্রিম ফিল্ড বাদ দেয়।

রেসপন্স

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

অবৈধ রিকোয়েস্ট (অজানা মডেল, মিশ্র ইনপুট মোড, অবৈধ ফিল্ড)

OpenAI-সামঞ্জস্যপূর্ণ এরর এনভেলপ।
error
টাইপ: object
message
টাইপ: string
আবশ্যক
type
টাইপ: string enum
আবশ্যক
মান
invalid_request_error
server_error
code
টাইপ: string
param
টাইপ: string nullable
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 nullable
application/json
402
টাইপ: object · GenerationError

অপর্যাপ্ত ব্যালেন্স / বিলিং শর্ত পূরণ হয়নি

OpenAI-সামঞ্জস্যপূর্ণ এরর এনভেলপ।
error
টাইপ: object
message
টাইপ: string
আবশ্যক
type
টাইপ: string enum
আবশ্যক
মান
invalid_request_error
server_error
code
টাইপ: string
param
টাইপ: string nullable
application/json
403
টাইপ: object · GenerationError

অ্যাকাউন্টে অনুমতি নেই (সাবস্ক্রিপশন প্রয়োজন বা ব্যবহারকারীকে নিষিদ্ধ করা হয়েছে)। নিষ্ক্রিয় মডেলগুলিও আপস্ট্রিম কলের আগে প্রত্যাখ্যাত হয়। ইতিমধ্যে গৃহীত রিকোয়েস্ট ও টাস্ক চলতে থাকে।

OpenAI-সামঞ্জস্যপূর্ণ এরর এনভেলপ।
error
টাইপ: object
message
টাইপ: string
আবশ্যক
type
টাইপ: string enum
আবশ্যক
মান
invalid_request_error
server_error
code
টাইপ: string
param
টাইপ: string nullable
application/json
429
টাইপ: object · GenerationError

রিকোয়েস্ট বা ব্যয়ের সীমা পূর্ণ হয়েছে

OpenAI-সামঞ্জস্যপূর্ণ এরর এনভেলপ।
error
টাইপ: object
message
টাইপ: string
আবশ্যক
type
টাইপ: string enum
আবশ্যক
মান
invalid_request_error
server_error
code
টাইপ: string
param
টাইপ: string nullable
application/json
502
টাইপ: object · GenerationError

আপস্ট্রিম প্রোভাইডার ব্যর্থ হয়েছে

OpenAI-সামঞ্জস্যপূর্ণ এরর এনভেলপ।
error
টাইপ: object
message
টাইপ: string
আবশ্যক
type
টাইপ: string enum
আবশ্যক
মান
invalid_request_error
server_error
code
টাইপ: string
param
টাইপ: string nullable
application/json
503
টাইপ: object · GenerationError

জেনারেশন পরিষেবা বা বিলিং পরিষেবা সাময়িকভাবে অনুপলব্ধ

OpenAI-সামঞ্জস্যপূর্ণ এরর এনভেলপ।
error
টাইপ: object
message
টাইপ: string
আবশ্যক
type
টাইপ: string enum
আবশ্যক
মান
invalid_request_error
server_error
code
টাইপ: string
param
টাইপ: string nullable
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

একটি ভিডিও জেনারেশন টাস্ক জমা দিন