تولید ویدیو از متن

از یک توضیح متنی ویدیو بسازید. مدل، مدت، رزولوشن و نسبت تصویر را انتخاب کنید و نتیجه را از مسیر پیگیری تسک دریافت کنید.

نسخهٔ API: v1

مسیر درخواست

POSThttps://bananaai.ir/api/v1/videos/generations

یک تسک تولید ویدیو می‌سازد. پردازش ویدیو معمولاً بین ۳۰ ثانیه تا چند دقیقه طول می‌کشد؛ نتیجه را از مسیر پیگیری تسک بگیرید. هزینه بر اساس مدل، مدت و رزولوشن در لحظهٔ ثبت رزرو می‌شود.

مدل‌ها

شناسهٔ مدل را در فیلد model بفرستید. بازهٔ مدت و رزولوشن‌های مجاز هر مدل متفاوت است؛ مقدار خارج از بازه با 400 و کد invalid_request رد می‌شود.

مدل	مدت	رزولوشن	توضیح
kling-v3-turboKling 3 Turbo	۳ تا ۱۵ ثانیه	720p · 1080p	سریع‌ترین گزینه برای پیش‌نمایش
seedance-2Seedance 2.0	۴ تا ۱۵ ثانیه	480p · 720p · 1080p · 4K	پشتیبانی از generate_audio
wan-3Wan 3.0	۲ تا ۳۰ ثانیه	480p · 720p · 1080p	فریم اول/آخر و مرجع چندرسانه‌ای
wan-3-primeWan 3.0 Prime	۲ تا ۳۰ ثانیه	480p · 720p · 1080p	نسخه پریمیوم Wan
seedance-2-5Seedance 2.5	۴ تا ۳۰ ثانیه	480p · 720p · 1080p	طولانی‌ترین خروجی
seedance-2-miniSeedance 2.0 Mini	۴ تا ۱۵ ثانیه	480p · 720p	کم‌هزینه‌ترین گزینه
grok-imagine-videoGrok Imagine Video	۶ تا ۱۵ ثانیه	480p · 720p	—
veo-3.1Google Veo 3.1	فقط ۴ / ۶ / ۸ ثانیه	720p · 1080p · 4K	مدت، کیفیت را تعیین می‌کند (Lite / Fast / Quality)

پارامترهای درخواست

بدنهٔ درخواست باید JSON باشد (Content-Type: application/json).

promptstringالزامی: توضیح صحنه، حرکت دوربین و حال‌وهوای ویدیو. برای بهترین نتیجه از توصیف سینمایی و مشخص استفاده کنید.; مثال:A cinematic drone shot over a desert city at sunset
modelstringاختیاری: شناسهٔ مدل از جدول بالا.; پیش‌فرض:kling-v3-turbo
durationintegerاختیاری: مدت ویدیو به ثانیه. بازهٔ مجاز به مدل بستگی دارد؛ Veo فقط ۴، ۶ یا ۸ را می‌پذیرد.; پیش‌فرض:5 (Veo: 8)مثال:5810
resolutionstringاختیاری: رزولوشن خروجی. گزینه‌های مجاز در جدول مدل‌ها آمده است.; پیش‌فرض:720pمقادیر مجاز:480p720p1080p4k
aspect_ratiostringاختیاری: نسبت تصویر ویدیو. Grok گزینهٔ auto را هم می‌پذیرد؛ Veo فقط 16:9 و 9:16.; پیش‌فرض:9:16 (Veo: 16:9)مقادیر مجاز:16:99:161:1auto
generate_audiobooleanاختیاریفقط Seedance: تولید صدا همراه با ویدیو. هزینه را تغییر نمی‌دهد.; پیش‌فرض:false
web_searchbooleanاختیاریفقط Seedance: اجازهٔ جست‌وجوی وب به مدل برای درک بهتر پرامپت.; پیش‌فرض:false
metadataobjectاختیاری: جفت‌های کلید/مقدار دلخواه (تا ۱۶ کلید، مقدار حداکثر ۵۰۰ کاراکتر) مثل شناسهٔ سفارش شما. در پاسخ تسک و بدنهٔ وب‌هوک عیناً برمی‌گردد تا نتیجه را به رکورد خودتان وصل کنید.; مثال:{"order_id":"1042"}

Veo 3.1

مدت ویدیو کیفیت مدل را تعیین می‌کند: ۴ ثانیه = Lite، ۶ ثانیه = Fast، ۸ ثانیه = Quality. هزینهٔ هر ترکیب در اعتبار و هزینه آمده است.

نمونه درخواست

bash

curl -X POST "https://bananaai.ir/api/v1/videos/generations" \
  -H "Authorization: Bearer ba_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2",
  "prompt": "A cinematic drone shot over a desert city at sunset",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "9:16",
  "generate_audio": false
}'

پاسخ

JSON

1{
2  "id": "task_abc123",
3  "status": "pending",
4  "model": "seedance-2",
5  "credits_reserved": 250,
6  "created_at": "2026-07-11T12:00:00.000Z"
7}

credits_reserved همان مبلغی است که در صورت موفقیت کسر می‌شود؛ برای Seedance برابر نرخ رزولوشن × مدت است.

دریافت نتیجه

هر ۳ تا ۵ ثانیه GET /api/v1/tasks/:id را بخوانید. پس از completed، نشانی ویدیو در آرایهٔ videos قرار دارد:

JSON

1{
2  "id": "task_abc123",
3  "status": "completed",
4  "type": "video",
5  "model": "seedance-2",
6  "prompt": "A cinematic drone shot over a desert city at sunset",
7  "images": [],
8  "videos": ["https://cdn.bananaai.ir/.../output.mp4"],
9  "error": null,
10  "credits_reserved": 250,
11  "credits_deducted": true,
12  "created_at": "2026-07-11T12:00:00.000Z",
13  "completed_at": "2026-07-11T12:01:20.000Z"
14}

نکته

اگر پردازش بیش از حدود ۱۵ دقیقه طول بکشد، تسک ناموفق می‌شود و اعتبار رزروشده آزاد می‌شود. الگوی کامل پیگیری در الگوی پیگیری.