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

تولید ویدیو از عکس

یک یا چند عکس مرجع و توضیحی کوتاه ارائه کنید تا ویدیوی دلخواهتان ساخته شود.

Endpoint

POSThttps://bananaai.ir/api/v1/videos/image-to-video

مدل‌ها

  • seedance-2 / seedance-2-5 / seedance-2-mini: فریم اول و آخر یا ورودی‌های مرجع چندرسانه‌ای
  • grok-imagine-video: یک عکس ورودی، ۱ تا ۱۵ ثانیه
  • gemini-omni-video: چند عکس و اختیاری یک ویدیوی مرجع
  • kling-v3-turbo: یک عکس ورودی، ۳ تا ۱۵ ثانیه، ۷۲۰p / ۱۰۸۰p
  • kling-3.0: فریم اول (و اختیاری فریم آخر)
  • veo-3.1: فریم اول (و اختیاری فریم آخر)، ۴ / ۶ / ۸ ثانیه، تا ۴K

درخواست

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

promptالزامیstring

توضیح حرکت یا صحنه موردنظر در ویدیو.

مثال:Slow cinematic orbit around the product on a clean studio pedestal
image_urlsاختیاریstring[]

آرایه‌ای از URL عکس‌ها. در بیشتر مدل‌ها، آیتم اول به‌عنوان فریم نخست استفاده می‌شود.

مثال:https://example.com/source.jpg
first_frame_urlاختیاریstring

URL فریم نخست، به‌عنوان جایگزین صریح آیتم اول.

last_frame_urlاختیاریstring

URL اختیاری فریم پایانی برای Seedance و Kling 3.0.

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: تولید صدا همراه با ویدیو.

soundاختیاریboolean

Kling 3.0: فعال‌کردن صدا.

modeاختیاریstring

Kling 3.0: std | pro | 4K.

مثال:pro
reference_image_urlsاختیاریstring[]

Seedance چندرسانه‌ای: حداکثر ۹ عکس مرجع.

reference_video_urlsاختیاریstring[]

Seedance چندرسانه‌ای: حداکثر ۳ ویدیوی مرجع. در Seedance 2.5 مدت هر کلیپ باید ۴ تا ۳۰ ثانیه و مجموع آن‌ها حداکثر ۳۰ ثانیه باشد.

reference_audio_urlsاختیاریstring[]

Seedance چندرسانه‌ای: حداکثر ۳ فایل صوتی مرجع. در Seedance 2.5 مدت هر فایل باید ۴ تا ۳۰ ثانیه و مجموع آن‌ها حداکثر ۳۰ ثانیه باشد.

reference_video_duration_secondsاختیاریnumber

Seedance: مجموع مدت ویدیوهای مرجع برای محاسبه اعتبار. هنگام استفاده از seedance-2-5 با reference_video_urls، مدت خروجی با ویدیوی مرجع هماهنگ می‌شود.

video_listاختیاریobject[]

Gemini Omni: یک کلیپ مرجع شامل url، start و ends بر حسب ثانیه.

مثال:[{"url":"https://example.com/ref.mp4","start":0,"ends":4}]

اطلاعات

URL عکس‌ها و ویدیوها باید برای سرویس ما در دسترس باشد. درخواست برای فایل‌های نیازمند ورود یا لینک‌های موقت منقضی‌شده ناموفق خواهد بود.

هشدار

در Seedance 2.5، با ارسال reference_video_urls درخواست به‌عنوان ویرایش ویدیو پردازش می‌شود. مقدار duration به‌صورت خودکار روی -1 و نسبت تصویر روی adaptive قرار می‌گیرد؛ مدت و نسبت تصویر خروجی نیز از ویدیوی مرجع پیروی می‌کند. در این حالت duration را به‌صورت دستی ارسال نکنید، زیرا نادیده گرفته می‌شود. اعتبار مصرفی بر اساس مدت ویدیوی مرجع محاسبه خواهد شد.
bash
curl -X POST "https://bananaai.ir/api/v1/videos/image-to-video" \
  -H "Authorization: Bearer ba_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "Slow cinematic orbit around the product",
    "image_urls": ["https://example.com/product.jpg"],
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "auto"
  }'

پاسخ

json
1{
2  "id": "task_abc123",
3  "status": "pending",
4  "model": "grok-imagine-video",
5  "credits_reserved": 144,
6  "created_at": "2026-07-11T12:00:00.000Z"
7}

یادداشت

شناسه تسک در فیلد id قرار دارد. وضعیت را از طریق GET /api/v1/tasks/:id پیگیری کنید. پس از تکمیل پردازش، فیلد videos حاوی نتیجه خواهد بود. مدل veo-3.1 فقط از مدت‌های ۴، ۶ و ۸ ثانیه پشتیبانی می‌کند و به حداقل یک فریم نخست نیاز دارد.
تولید ویدیو از عکس با API