Veo 3.1

Veo 3.1 הוא מודל יצירת הווידאו של Google. SeedRouter מציע אותו בחמישה מזהי מודל על נקודת קצה אחת: שלושה בתמחור לפי קליפ, כשכל קליפ באורך 8 שניות, ושניים בתמחור לפי שנייה עם שליטה רבה יותר (משך, אודיו, seed, פרומפט שלילי, פריים ראשון ואחרון). שלח את הבקשה, שמור את מזהה המשימה שהוחזר, וקרא את הווידאו המוכן מתוך המשימה. התמונות נשלחות ככתובות URL.

מזהי מודל

המחירים הנוכחיים מופיעים בדף המודל.

דוגמה מהירה

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast",
    "prompt": "A red paper boat drifts across a calm pond at sunrise, soft mist on the water, slow push-in on a 35mm lens, no text, no logos.",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

נקודת קצה

POST https://api.seedrouter.ai/v1/videos/generations

התשובה היא משימה ({"id": "task_...", "status": "processing"}), ולא הווידאו המוכן. תשאל את GET /v1/tasks/{task_id} כדי לקבל את התוצאה. שמור את מפתחות ה-API בקוד שרץ בצד השרת.

פרמטרים: מודלים בתמחור לפי קליפ

veo-3.1-fast, veo-3.1-quality ו-veo-3.1-lite.

פרמטרים: מודלים בתמחור לפי שנייה

veo-3.1-fast-official ו-veo-3.1-quality-official.

הסכמה מחמירה: שדות לא מוכרים נדחים ולא מתעלמים מהם, וכל מודל מקבל רק את השדות שלו. קריאות חוזרות אינן זמינות; תשאל את המשימה במקום זאת.

מצבי תמונה

ב-veo-3.1-fast וב-veo-3.1-quality, generation_type קובע איך משתמשים ב-image_urls:

veo-3.1-quality לא מריץ מצב ייחוס, ולכן הוא דוחה generation_type: "reference" וגם שלוש תמונות בלי generation_type. veo-3.1-lite לא מקבל תמונות.

במודלים בתמחור לפי שנייה, הגדר first_frame_image ואם תרצה גם last_frame_image. resize_mode קובע אם תמונה בצורה אחרת מרופדת או נחתכת.

קלטי מדיה

התמונות הן כתובות URL ציבוריות ב-⁦HTTP(S)⁩:

{ "image_urls": ["https://example.com/first.jpg", "https://example.com/last.jpg"] }

במודלים בתמחור לפי קליפ כל תמונה היא JPEG, PNG או WebP ובגודל של עד 10 MB; קובץ שמפר את הכללים האלה מכשיל את המשימה בלי חיוב. נתוני base64 אינם מתקבלים: העלה את הקובץ לאחסון שלך והעבר את הכתובת שלו.

גורמי עלות

בדוק את מדור המחירים של המודל לתעריפים הנוכחיים.

per-clip models:    cost = price of one clip at the output resolution        (720p and 1080p cost the same)
per-second models:  cost = duration × rate for the resolution and audio setting

החיוב נקבע כשהבקשה מתקבלת, ולכן הסכום שנשמר מראש הוא הסכום שמחויב. את החיובים הסופיים תראה בהיסטוריית השימוש של החשבון שלך. משימות שנכשלו אינן מחויבות.

מבנה הפלט

השליחה מחזירה את המשימה:

{"id": "task_...", "model": "veo-3.1-fast", "status": "processing", "created_at": 1789689600}

קבלת המשימה

GET https://api.seedrouter.ai/v1/tasks/{task_id}

תשאל כל 10–20 שניות עד ש-status יהיה completed או failed. פקיעת זמן ברשת במהלך התשאול אינה מעידה שהיצירה נכשלה: שמור את מזהה המשימה והמשך בבדיקה. אל תיצור משימה נוספת כדי לבדוק התקדמות.

משימה שהושלמה

{
  "id": "task_...",
  "model": "veo-3.1-fast",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689720,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

video_url הוא קובץ MP4, או GIF כשהבקשה הגדירה enable_gif. הקישור נמצא באחסון של SeedRouter.

מה החזירו הרצות הבדיקה שלנו (הרצה אחת לכל אחת, 2026-10-04):

למודלים בתמחור לפי קליפ אין מתג אודיו; המודלים בתמחור לפי שנייה מוסיפים רצועת אודיו רק עם generate_audio.

שגיאות

בקשות שנדחות לפני יצירת המשימה מחזירות שגיאת HTTP יחד עם אובייקט error ואינן מחויבות. משימה שנכשלת לאחר שהתקבלה מחזירה בתשאול HTTP 200, עם status: "failed" ואובייקט error.

ראה את קטלוג השגיאות המשותף לקודים, לסטטוסי HTTP ולהנחיות ניסיון חוזר.

{
  "id": "task_...",
  "model": "veo-3.1-fast",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

אם השליחה עצמה חורגת מהזמן הקצוב, בדוק את המשימות שלך לפני שליחה חוזרת: ייתכן שהבקשה הראשונה כבר התקבלה.

טיפים

• התחל ב-veo-3.1-lite או ב-veo-3.1-fast ב-720p כדי לנסות פרומפט, ואז עבור ל-Quality או ל-4k לרינדור הסופי.
• ציין את המצלמה ואת התאורה: עדשה ותנועת מצלמה משנות את השוט יותר משמות תואר.
• הוסף no text, no logos כדי למנוע כיתוב וסימנים מומצאים בפריים.
• לשוט שחייב להתחיל ולהסתיים בתמונות ידועות, השתמש במצב פריימים עם שתי תמונות, או במודלים בתמחור לפי שנייה עם first_frame_image ו-last_frame_image.
• קבע את seed במודלים בתמחור לפי שנייה ושנה פסוקית אחת בכל פעם כדי לשכלל שוט.

קישורים רלוונטיים

• Playground ומחירים של Veo 3.1
• הורדת OpenAPI
• Markdown להעתקה