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

مدل‌ها

• kling-v3-turbo: ۳ تا ۱۵ ثانیه، ۷۲۰p / ۱۰۸۰p
• seedance-2: ۴ تا ۱۵ ثانیه، تا ۴K
• seedance-2-5: ۴ تا ۳۰ ثانیه، ۴۸۰p / ۷۲۰p / ۱۰۸۰p
• seedance-2-mini: اقتصادی، فقط ۴۸۰p / ۷۲۰p
• grok-imagine-video: ۶ تا ۱۵ ثانیه، ۴۸۰p / ۷۲۰p
• veo-3.1: فقط مدت‌های ۴ / ۶ / ۸ ثانیه، تا ۴K (کیفیت از مدت: Lite / Fast / Quality). نسبت‌ها: ۱۶:۹ و ۹:۱۶

درخواست

• prompt (required, string): متن توصیف ویدیو.
• generate_audio (optional, boolean): فقط Seedance: تولید صدا.
• web_search (optional, boolean): فقط Seedance: جستجوی وب.
• model (optional, string): شناسه مدل ویدیو.
  • examples: veo-3.1, grok-imagine-video, kling-v3-turbo, wan-3, wan-3-prime, flux-3-video, kling-4, seedance-2-5, seedance-2, seedance-2-mini, gemini-omni-video, kling-3.0
• duration (optional, integer): مدت زمان ویدیو به ثانیه. بازه مجاز به مدل بستگی دارد.
  • examples: 5, 8, 10
• resolution (optional, string): رزولوشن خروجی. گزینه‌ها به مدل بستگی دارد.
  • examples: 480p, 720p, 1080p, 4k
• aspect_ratio (optional, string): نسبت عکس ویدیو.
  • examples: 16:9, 9:16, 1:1, auto

نمونه curl

curl -X POST "https://api.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 misty mountains at sunrise","duration":5,"resolution":"720p","aspect_ratio":"9:16","generate_audio":false}'

پاسخ

{
  "id": "task_abc123",
  "status": "pending",
  "model": "seedance-2",
  "credits_reserved": 250,
  "created_at": "2026-01-01T12:00:00.000Z"
}

شناسه task در فیلد id است. وقتی وضعیت completed شد، فیلد videos شامل URL خروجی است. پیگیری با GET /api/v1/tasks/:id هر ۳ تا ۵ ثانیه.