رفتن به محتوای اصلی
بنانا AI
Text to Video

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

با ارائه یک توضیح متنی، ویدیوی دلخواهتان را بسازید.

Endpoint

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

مدل‌ها

  • kling-v3-turbo: مدل سریع، ۳ تا ۱۵ ثانیه، ۷۲۰p / ۱۰۸۰p
  • seedance-2: Seedance 2.0، ۴ تا ۱۵ ثانیه، تا ۴K
  • seedance-2-5: Seedance 2.5، ۴ تا ۳۰ ثانیه، فقط ۴۸۰p / ۷۲۰p
  • seedance-2-mini: نسخه مقرون‌به‌صرفه Seedance، فقط ۴۸۰p / ۷۲۰p
  • grok-imagine-video: Grok Imagine، ۱ تا ۱۵ ثانیه، تا ۱۰۸۰p
  • veo-3.1: Google Veo 3.1، فقط ۴ / ۶ / ۸ ثانیه، تا ۴K

درخواست

بدنه درخواست باید در قالب JSON باشد و می‌تواند فیلدهای زیر را داشته باشد:

promptالزامیstring

توضیح ویدیوی موردنظر.

مثال:A cinematic drone shot over a desert city at sunset
modelاختیاریstring

شناسه مدل ویدیو.

مثال:veo-3.1grok-imagine-videokling-v3-turboseedance-2-5seedance-2seedance-2-minigemini-omni-videokling-3.0
durationاختیاریinteger

مدت زمان ویدیو به ثانیه. بازه مجاز به مدل بستگی دارد.

مثال:5810
resolutionاختیاریstring

رزولوشن خروجی. گزینه‌ها به مدل بستگی دارد.

مثال:480p720p1080p4k
aspect_ratioاختیاریstring

نسبت عکس ویدیو.

مثال:16:99:161:1auto
generate_audioاختیاریboolean

ویژه Seedance: تولید صدا همراه با ویدیو.

مثال:truefalse
web_searchاختیاریboolean

ویژه Seedance: فعال‌کردن جست‌وجوی وب.

مثال:false
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
  }'

یادداشت

برای veo-3.1 فقط مدت‌های ۴، ۶ و ۸ ثانیه و نسبت‌های ۱۶:۹ / ۹:۱۶ پشتیبانی می‌شوند. مدل، کیفیت خروجی را بر اساس مدت انتخاب می‌کند (Lite / Fast / Quality).

پاسخ

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}

یادداشت

شناسه تسک در فیلد id قرار دارد، نه taskId. برای پیگیری وضعیت، همین مقدار را به GET /api/v1/tasks/:id بدهید. پس از رسیدن وضعیت به completed، فیلد videos شامل URL ویدیو خواهد بود.
تولید ویدیو از متن با API