API Veo 3.1
مدل ساخت ویدیوی Google با صدای هم‌زمان؛ برای تیمی که کلیپ تبلیغاتی، معرفی محصول یا ویدیوی شبکهٔ اجتماعی را با کیفیت خروجی نهایی و صدای ساختهشده در همان فراخوان میخواهد.
مشخصات و قیمت API Veo 3.1
- نام مدل در فراخوان
- google-veo-3.1
- نوع
- تبدیل متن به ویدیو و عکس به ویدیو
- مدت ویدیو
- ۴، ۶، ۸ ثانیه
- کیفیت
- 720p، 1080p
- صدا
- با صدا یا بیصدا
- نگه‌داری فایل
- ۷ روز
| تنظیم | هر ثانیه | ویدیوی ۴ ثانیهای | ویدیوی ۸ ثانیهای |
|---|---|---|---|
| با صدا | ۱۳۳٬۹۸۰ تومان | ۵۳۵٬۹۲۰ تومان | ۱٬۰۷۱٬۸۴۰ تومان |
| بیصدا | ۶۶٬۹۹۰ تومان | ۲۶۷٬۹۶۰ تومان | ۵۳۵٬۹۲۰ تومان |
قیمت‌ها شامل مالیات بر ارزش افزوده‌اند. مبلغ کامل ویدیو هنگام ثبت درخواست از موجودی قفل میشود؛ اگر ساخت موفق شود همان مبلغ کسر میشود و اگر ناموفق باشد، کامل به موجودی برمیگردد.
دربارهٔ Veo 3.1
Veo 3.1 مدل تولید ویدیوی Google است که در مهر ۱۴۰۴ (اکتبر ۲۰۲۵) عرضه شد. از یک توصیف متنی، یا از یک تصویر به‌عنوان فریم اول، کلیپ کوتاهی می‌سازد که صدایش هم در همان فراخوان ساخته میشود: صدای محیط، افکت و حتی گفت‌وگوی کوتاه. اگر دنبال «API ویو ۳٫۱» یا «API ساخت ویدیو با هوش مصنوعی» بوده‌ای، همین صفحه را می‌خواستی.
جای Veo 3.1 در میان مدل‌های ویدیویی ما
Veo 3.1 ردهٔ کامل خانوادهٔ Veo است و برای خروجی نهایی ساخته شده. Veo 3.1 Fast همان خانواده است با تمرکز بر سرعت و هزینهٔ کمتر، مناسب پیش‌نویس و حجم بالا. Runway Gen-4.5 ویدیوی بیصدا می‌سازد و برای کسی است که صدا را جدا تدوین می‌کند. Grok Imagine Video 1.5 از xAI و Wan 3.0 از Alibaba هم صدا دارند و هر کدام بازهٔ زمانی و وضوح خودشان را دارند.
ویژگی تعیین‌کنندهٔ Veo 3.1 کوتاه‌بودن کلیپ است: Google طول ویدیو را ۴، ۶ یا ۸ ثانیه تعریف کرده. یعنی برای یک نمای کوتاه و تمیز ساخته شده، نه برای ویدیوی چنددقیقه‌ای. ویدیوی بلندتر را با کنار هم گذاشتن چند کلیپ در تدوین می‌سازی.
کلیپ‌هایی که کسب‌وکار ایرانی با آن می‌سازد
کاربرد ملموسش کلیپ کوتاهی است که پیش از این عکاسی، فیلم‌برداری یا انیمیشن لازم داشت:
- ویدیوی معرفی محصول برای استوری و ریلز، از روی عکس خود محصول.
- نمای کوتاه تبلیغاتی با صدای محیط، مثلاً بخار قهوه در کافه یا صدای باران
پشت پنجره.
- پیش‌نمایش ایدهٔ یک آگهی پیش از سپردنش به تیم فیلم‌برداری.
- ویدیوی پس‌زمینهٔ صفحهٔ فرود یا اپلیکیشن.
برای ساخت از روی عکس، تصویر را با نشانی https یا به‌شکل data URL در فیلد image بفرست تا فریم اول ویدیو شود و توصیف، حرکتش را تعیین کند.
فراخوان ناهمگام است، منتظر پاسخ نمان
ساخت ویدیو چند ده ثانیه تا چند دقیقه طول میکشد، پس فراخوان دو مرحله دارد. اول درخواست را با POST به /api/v1/ai/videos/ بفرست، با model برابر google-veo-3.1، توصیف در prompt، طول ویدیو بر حسب ثانیه در duration، و اگر صدا نمی‌خواهی audio برابر false. پاسخ بلافاصله با کد HTTP 202 و شناسه‌ای برمیگردد که با vid_ شروع میشود.
بعد هر چند ثانیه یک بار /api/v1/ai/videos/<id>/ را با GET بخوان تا status به succeeded یا failed برسد. در حالت موفق، نشانی فایل در videoUrl است و در حالت شکست، علت در error.code و error.message می‌آید. اتصال را باز نگه ندار و فاصلهٔ پرسیدن را هم زیر یکی دو ثانیه نبر؛ کار سریع‌تر تمام نمی‌شود.
هزینهٔ هر ثانیه ویدیو و رزرو موجودی
قیمت API Veo 3.1 ثانیهای حساب میشود و ویدیوی با صدا تعرفهٔ متفاوتی با ویدیوی بیصدا دارد؛ هر دو عدد در جدول بالای همین صفحه آمده. وقتی درخواست را می‌فرستی، هزینهٔ کامل همان طولی که خواسته‌ای از موجودی رزرو میشود. اگر ساخت شکست بخورد، کل مبلغ رزروشده برمیگردد و اگر موفق شود، دقیقاً همان مبلغ کسر میشود.
نتیجهٔ عملی: اگر روی ویدیو موسیقی یا گویندگی خودت را می‌گذاری، audio را خاموش کن تا هزینهٔ صدایی را که دور می‌ریزی ندهی.
نوشتهٔ فارسی و زبان توصیف
نوشتهٔ فارسی داخل تصویر ویدیو قابل اتکا نیست. مدل ویدیویی هم مثل مدل تصویری حروف را مثل شکل میکشد و خط پیوستهٔ فارسی معمولاً به‌هم‌ریخته درمی‌آید. در توصیف بنویس که هیچ نوشته‌ای در تصویر نباشد و عنوان و زیرنویس را در تدوین اضافه کن.
توصیف را در عمل بهتر است انگلیسی بنویسی. توصیف فارسی هم فهمیده میشود، ولی تجربهٔ رایج این است که جزئیات حرکت دوربین، نور و سبک با توصیف انگلیسی دقیق‌تر اجرا میشود. روی گفت‌وگوی فارسی داخل ویدیو هم حساب نکن؛ صدای گوینده را جدا ضبط کن.
فایل را فقط هفت روز نگه می‌داریم
ویدیوی ساختهشده ۷ روز روی سرور ما میماند و بعد پاک میشود؛ زمان دقیق پاکشدن را فیلد expiresAt در پاسخ وضعیت می‌گوید. همان لحظه که وضعیت succeeded شد، فایل را از videoUrl دانلود کن و در فضای ذخیرهسازی خودت بگذار. دانلود همان سرآیند Authorization با کلید API را میخواهد، پس این نشانی را نمی‌شود مستقیم در سایت یا اپلیکیشن قرار داد؛ یک هفته بعد هم اصلاً کار نمی‌کند.
کجا Veo 3.1 انتخاب اشتباهی است
اگر هنوز در مرحلهٔ پیداکردن ایده‌ای و ده نسخه از یک صحنه را امتحان می‌کنی، Veo 3.1 Fast همان کار را سریع‌تر و ارزان‌تر انجام می‌دهد؛ فقط نسخهٔ برنده را با Veo 3.1 بساز. اگر کلیپ بلندتر از چند ثانیه را در یک تکه می‌خواهی، Wan 3.0 بازهٔ زمانی بلندتری دارد. و اگر ویدیو باید متن فارسی خوانا داشته باشد، هیچ مدل ویدیویی جای تدوین را نمی‌گیرد.
کاربردهای API Veo 3.1
- ویدیوی معرفی محصول از روی عکسعکس محصول را فریم اول می‌گیرد و چند ثانیه حرکت دوربین و نور به آن می‌دهد؛ مناسب استوری، ریلز و صفحهٔ محصول فروشگاه.
- نمای تبلیغاتی با صدای محیطکلیپ کوتاه را همراه صدای محیط و افکت در یک فراخوان می‌سازد، بی‌آنکه برای هر نما صداگذاری جداگانه لازم باشد.
- پیش‌نمایش آگهی پیش از فیلم‌برداریایدهٔ آگهی را به‌شکل چند نمای کوتاه نشان می‌دهد تا پیش از هزینهٔ تولید واقعی، دربارهٔ صحنه و حس کار تصمیم گرفته شده باشد.
اتصال به API Veo 3.1
ساخت ویدیو ناهمگام است: درخواست، شناسهٔ کار را برمی‌گرداند و نه خود ویدیو. وضعیت را هر چند ثانیه با همان شناسه بپرسید تا succeeded شود و نشانی فایل (videoUrl) بیاید. دریافت فایل هم همان کلید API را میخواهد. برای ساخت ویدیو از عکس، نشانی https یا data URL تصویر آغازین را در فیلد image بفرستید.
# ۱. ثبت کار
curl -X POST 'https://melliapi.net/api/v1/ai/videos/' \
-H 'Authorization: Bearer melli_live_…' \
-H 'Content-Type: application/json' \
-d '{
"model": "google-veo-3.1",
"prompt": "A slow cinematic drone shot over the Persian Gulf at sunset",
"duration": 8,
"resolution": "720p",
"audio": true
}'
# → { "ok": true, "id": "vid_…", "status": "processing", … }
# ۲. پیگیری تا پایان
curl 'https://melliapi.net/api/v1/ai/videos/vid_…/' -H 'Authorization: Bearer melli_live_…'
# ۳. دریافت فایل
curl -L -o video.mp4 'https://melliapi.net/api/v1/ai/videos/vid_…/content/' \
-H 'Authorization: Bearer melli_live_…'import time, requests
API = "https://melliapi.net/api/v1/ai/videos/"
HEADERS = {"Authorization": "Bearer melli_live_…"}
job = requests.post(API, headers=HEADERS, json={"model":"google-veo-3.1","prompt":"A slow cinematic drone shot over the Persian Gulf at sunset","duration":8,"resolution":"720p","audio":True}).json()
while job["status"] == "processing":
time.sleep(5)
job = requests.get(API + job["id"] + "/", headers=HEADERS).json()
if job["status"] == "succeeded":
video = requests.get(job["videoUrl"], headers=HEADERS)
open("video.mp4", "wb").write(video.content)
else:
print(job["error"])کدهای خطا و جزئیات صورتحساب در مستندات API هوش مصنوعی آمده است.
مدل‌های دیگر Google Gemini
پرسش‌های متداول
آیا API Veo 3.1 در ایران بدون VPN و کارت ارزی قابل استفاده است؟
بله. درخواست از سرور شما به سرور ما میرسد و از آنجا به Google میرود، پس VPN و کارت بینالمللی لازم نیست. حساب را در پنل با پرداخت ریالی شارژ میکنید و هزینهٔ هر ویدیو از همان موجودی کسر میشود.
هزینهٔ ساخت هر ویدیو با Veo 3.1 چطور حساب میشود؟
تعرفه ثانیهای است و برای ویدیوی با صدا و بیصدا فرق دارد. هنگام ثبت درخواست، هزینهٔ کامل طول درخواستی از موجودی رزرو میشود. اگر ساخت موفق شود همان مبلغ کسر میشود و اگر شکست بخورد، کل آن به موجودی برمیگردد.
ویدیوی Veo 3.1 چند ثانیه است؟
Google طول ویدیوی Veo 3.1 را ۴، ۶ یا ۸ ثانیه تعریف کرده. برای ویدیوی بلندتر، چند کلیپ جدا بسازید و در تدوین کنار هم بگذارید؛ ثابت نگه داشتن سبک توصیف و استفاده از فریم اول مشترک، یکدستی کلیپ‌ها را بیشتر می‌کند.
چرا پاسخ درخواست ساخت ویدیو، خود ویدیو را ندارد؟
چون ساخت ویدیو چند ده ثانیه تا چند دقیقه طول میکشد. پاسخ اول فقط شناسهٔ کار با وضعیت processing است. هر چند ثانیه وضعیت همان شناسه را بپرسید تا succeeded شود؛ آن وقت نشانی فایل در videoUrl آمده است.
ویدیوی ساختهشده تا کی روی سرور میماند؟
هفت روز، و زمان دقیق پاکشدن در فیلد expiresAt پاسخ وضعیت آمده. دانلود از videoUrl همان سرآیند Authorization با کلید API را میخواهد، پس ویدیو را بلافاصله پس از ساخت دانلود کنید و در فضای ذخیرهسازی خودتان نگه دارید.