ملی ای‌پی‌آی

API Veo 3.1 Fast

نسخهٔ سریع‌تر و کم‌هزینه‌تر Veo 3.1؛ برای تیمی که ویدیوی کوتاه را در حجم زیاد می‌سازد، ایده‌ها را پیش از نسخهٔ نهایی امتحان می‌کند یا ویدیو را داخل محصولش برای کاربر تولید می‌کند.

ساخت حساب و دریافت کلید

مشخصات و قیمت API Veo 3.1 Fast

نام مدل در فراخوان
google-veo-3.1-fast
نوع
تبدیل متن به ویدیو و عکس به ویدیو
مدت ویدیو
۴، ۶، ۸ ثانیه
کیفیت
720p، 1080p
صدا
با صدا یا بی‌صدا
نگه‌داری فایل
۷ روز
تنظیمهر ثانیهویدیوی ۴ ثانیه‌ایویدیوی ۸ ثانیه‌ای
با صدا۵۰٬۲۴۳ تومان۲۰۰٬۹۷۰ تومان۴۰۱٬۹۴۰ تومان
بی‌صدا۳۳٬۴۹۵ تومان۱۳۳٬۹۸۰ تومان۲۶۷٬۹۶۰ تومان

قیمت‌ها شامل مالیات بر ارزش افزوده‌اند. مبلغ کامل ویدیو هنگام ثبت درخواست از موجودی قفل می‌شود؛ اگر ساخت موفق شود همان مبلغ کسر می‌شود و اگر ناموفق باشد، کامل به موجودی برمی‌گردد.

دربارهٔ Veo 3.1 Fast

Veo 3.1 Fast عضو سریع خانوادهٔ Veo 3.1 گوگل است که همراه Veo 3.1 عرضه شد. همان کارها را می‌کند، یعنی ویدیو از توصیف متنی یا از تصویر فریم اول، همراه صدای هم‌زمان، ولی برای زمان ساخت کوتاه‌تر و هزینهٔ کمتر تنظیم شده. اگر «API ویو ۳٫۱ فست» یا «API تبدیل متن به ویدیو» جست‌وجو کرده‌ای، این صفحه مال همین مدل است.

فرق Veo 3.1 Fast با Veo 3.1

این دو مدل یک خانواده‌اند و فرقشان در اولویت است. Veo 3.1 برای خروجی نهایی با بیشترین جزئیات ساخته شده و Veo 3.1 Fast برای جایی که سرعت و تعداد مهم‌تر است. طول کلیپ در هر دو ۴، ۶ یا ۸ ثانیه است و هر دو از تصویر به‌عنوان فریم اول پشتیبانی می‌کنند.

یک الگوی کاری رایج این است: ایده را با Fast پیدا کن، چند نسخه بساز، و توصیف برنده را برای نسخهٔ نهایی به Veo 3.1 بده. بیشتر هزینهٔ آزمون‌وخطا روی مدل ارزان‌تر می‌افتد.

کجا سرعت ساخت تعیین‌کننده است

جایی که کاربر منتظر ویدیوست یا تعداد ویدیوها زیاد است:

  • اپلیکیشنی که از عکس کاربر، کلیپ کوتاه متحرک می‌سازد و کاربر پشت صفحه

منتظر است.

  • فروشگاهی که برای صدها کالا، ویدیوی چندثانیه‌ای صفحهٔ محصول می‌خواهد.
  • تیم محتوایی که هر روز چند ویدیوی کوتاه برای شبکهٔ اجتماعی منتشر

می‌کند و دنبال تنوع است، نه جزئیات سینمایی.

  • آژانسی که پیش از جلسه با مشتری، چند جهت بصری را سریع نشان می‌دهد.

صدا را خاموش کن اگر لازمش نداری

در این مدل صدا اختیاری است و تعرفهٔ ثانیه‌ای ویدیوی بی‌صدا با ویدیوی با‌صدا فرق دارد؛ هر دو را در جدول بالای صفحه می‌بینی. اگر روی ویدیو موسیقی خودت را می‌گذاری یا ویدیو بی‌صدا پخش می‌شود (مثل پس‌زمینهٔ سایت)، در درخواست audio را false بگذار. قیمت API Veo 3.1 Fast در تولید انبوه بیشتر از هر چیز به همین انتخاب و طول کلیپ بستگی دارد.

چرخهٔ درخواست و پیگیری وضعیت

درخواست را با POST به /api/v1/ai/videos/ بفرست و model را google-veo-3.1-fast بگذار. پاسخ با کد HTTP 202 و شناسهٔ کار برمی‌گردد و وضعیتش processing است. سپس هر چند ثانیه /api/v1/ai/videos/<id>/ را بخوان تا وضعیت succeeded شود و videoUrl بیاید، یا failed شود.

برای کار انبوه، درخواست‌ها را در صف بگذار و تعداد کارهای هم‌زمان را محدود کن. اگر پاسخ 429 گرفتی، چند ثانیه صبر کن و با فاصلهٔ رو به افزایش دوباره بفرست.

رزرو موجودی در کار انبوه

هنگام ثبت هر درخواست، هزینهٔ کامل طول درخواستی از موجودی رزرو می‌شود و تا پایان کار قفل می‌ماند. اگر صد درخواست را یک‌جا بفرستی، مبلغ همهٔ آن‌ها هم‌زمان رزرو می‌شود و درخواست‌های بعدی ممکن است با کمبود موجودی رد شوند. کار شکست‌خورده کل مبلغش را پس می‌دهد و کار موفق دقیقاً همان مبلغ رزروشده را کسر می‌کند.

فارسی در تصویر و دانلود به‌موقع

نوشتهٔ فارسی داخل ویدیو قابل اتکا نیست؛ حروف پیوسته جدا می‌افتند و کلمه‌ها خوانده نمی‌شوند. در توصیف بخواه که تصویر بدون نوشته باشد و متن و زیرنویس را در تدوین اضافه کن. توصیف انگلیسی هم در عمل معمولاً دقیق‌تر دنبال می‌شود.

فایل‌ها ۷ روز روی سرور ما می‌مانند و expiresAt زمان پاک‌شدن هر کدام را می‌گوید. در تولید انبوه این مهم‌تر است: کدی بنویس که به‌محض succeeded، فایل را با همان سرآیند Authorization از videoUrl دانلود و در فضای خودت ذخیره کند.

کجا Fast کم می‌آورد

ویدیوی کلیدی کمپین، نمای نزدیک با جزئیات زیاد، یا صحنه‌ای که قرار است بارها دیده شود. اینجا Veo 3.1 ارزش اضافه‌اش را دارد و صرفه‌جویی در یک کلیپ، به چند بار ساخت دوباره نمی‌ارزد. و اگر کلیپ بلندتر از ۸ ثانیه در یک تکه لازم داری، این خانواده جواب نیست؛ Wan 3.0 را ببین.

کاربردهای API Veo 3.1 Fast

  • ویدیوی صفحهٔ محصول در مقیاس بالابرای صدها کالا از روی عکس موجود، کلیپ کوتاه متحرک می‌سازد؛ جایی که تعداد ویدیوها هزینه را تعیین می‌کند و نه جزئیات تک‌تکشان.
  • ساخت ویدیو داخل اپلیکیشنعکس کاربر را به کلیپ چندثانیه‌ای تبدیل می‌کند و چون سریع‌تر تمام می‌شود، کاربر کمتر پشت صفحهٔ انتظار می‌ماند.
  • آزمون ایده پیش از نسخهٔ نهاییچند نسخه از یک صحنه را کم‌هزینه می‌سازد تا توصیف برنده برای ساخت نسخهٔ نهایی به Veo 3.1 داده شود.
  • کلیپ بی‌صدای پس‌زمینهبرای پس‌زمینهٔ سایت یا ویدیویی که با موسیقی خودتان پخش می‌شود، با صدای خاموش ساخته می‌شود و هزینهٔ صدا پرداخت نمی‌شود.

اتصال به API Veo 3.1 Fast

ساخت ویدیو ناهمگام است: درخواست، شناسهٔ کار را برمی‌گرداند و نه خود ویدیو. وضعیت را هر چند ثانیه با همان شناسه بپرسید تا 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-fast",
    "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-fast","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

پرسش‌های متداول

Veo 3.1 Fast با Veo 3.1 چه فرقی دارد؟

هر دو از خانوادهٔ Veo 3.1 گوگل‌اند، با طول کلیپ ۴، ۶ یا ۸ ثانیه و پشتیبانی از تصویر فریم اول. Fast برای ساخت سریع‌تر و هزینهٔ کمتر تنظیم شده و Veo 3.1 برای خروجی نهایی با جزئیات بیشتر. تعرفهٔ هر دو در صفحهٔ خودشان آمده است.

برای استفاده از API ویو ۳٫۱ فست در ایران چه چیزی لازم است؟

فقط یک حساب در پنل و کلید API. حساب با پرداخت ریالی شارژ می‌شود، درخواست از سرور شما به سرور ما می‌رسد و نه VPN لازم است و نه کارت بین‌المللی. هزینهٔ هر ویدیو هنگام ثبت درخواست از همان موجودی رزرو می‌شود.

اگر صدا را خاموش کنم هزینه کمتر می‌شود؟

بله، در Veo 3.1 Fast تعرفهٔ ثانیه‌ای ویدیوی بی‌صدا با ویدیوی با‌صدا فرق دارد و هر دو در جدول بالای صفحه آمده‌اند. اگر روی ویدیو موسیقی یا گویندگی خودتان را می‌گذارید، audio را false بفرستید تا هزینهٔ صدای اضافه را ندهید.

اگر ساخت ویدیو شکست بخورد، پولم چه می‌شود؟

کل مبلغی که هنگام ثبت درخواست رزرو شده بود به موجودی برمی‌گردد. هزینه فقط برای ویدیوی موفق کسر می‌شود و دقیقاً برابر همان مبلغ رزروشده است، یعنی تعرفهٔ ثانیه‌ای ضرب در طولی که درخواست کرده بودید.

شروع