Google: Veo 3.1 Lite
Veo 3.1 Lite יוצר וידאו עם אודיו מובנה מתיאור טקסטואלי או מתמונה התחלתית. תהליך העבודה המתועד של Lite מפיק קליפ אחד, במשכים של 4, 6 או 8 שניות, במסגור לרוחב או לאורך ועם מגבלות מסוימות השונות מ־Veo 3.1 ומ־Fast.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Veo 3.1 Lite הוא דגם Lite של Google בסדרת Veo 3 ליצירת וידאו. הוא מסנתז וידאו עם אודיו מתיאור בשפה טבעית או מתמונת קלט. הפלט הוא קליפ שנוצר, ולא ניתוח טקסטואלי של הקלטה קיימת. כרטיס מודל Lite של היצרן מפנה ל־Veo 3 בנוגע לארכיטקטורה שבבסיסו, לחומרי האימון ולמגבלות המוכרות, ואילו התיעוד הייחודי ל־Lite מגדיר את תכונות היצירה ואת המגבלות שלו.
הארכיטקטורה שאליה מפנים משתמשת בדיפוזיה במרחב לטנטי על ייצוגי אודיו לאורך זמן ועל ייצוגי וידאו במרחב ובזמן. מודל הבסיס אומן על אודיו, וידאו ותמונות, עם כיתובים ברמות פירוט שונות וחומרי אימון שעברו סינון והסרת כפילויות. הדבר מסביר את מטרת היצירה המשולבת של תמונה ואודיו. הוא אינו חושף מספר פרמטרים ייחודי ל־Lite ואינו מעיד שכל תנועה שנוצרת תואמת למציאות הפיזיקלית. לסצנה מעשית, החליטו יחד על הפעולה הגלויה ועל הקול התואם לה.
התיעוד המדויק של Lite קובע מגבלת קלט טקסט של 1,024 טוקנים וסרטון פלט אחד. עמודת Lite במדריך היצירה מציינת משכים של 4, 6 ו־8 שניות, עם 720p כברירת מחדל ו־1080p המחייב קליפ של 8 שניות. יחס 16:9 לרוחב הוא ברירת המחדל, וגם 9:16 לאורך מופיע; הפלט מתועד בקצב 24 פריימים לשנייה. אודיו מובנה פעיל תמיד בתהליך הזה. הערכים האלה שייכים לתהליך העבודה בשם Lite של היצרן, ולא למהדורת Veo שאינה קשורה או לתגובה של יישום שנמדדה בנפרד.
Lite אינו תומך בפלט 4K או בהארכת וידאו. טבלת הפרמטרים מסמנת גם את תכונת referenceImages לריבוי ייחוסים ואת קלט הווידאו להארכה כלא זמינים בעמודת Lite. תמונה התחלתית יכולה לקבוע את פריים הפתיחה; הטבלה מציינת תמונת lastFrame יחד עם התמונה ההתחלתית לצורך מעבר. שמרו על הפרדה בין מסלול בקרת הפריימים הזה לבין שילוב כמה ייחוסי סגנון או נושא. הגדרות היצרן ליצירת אנשים תלויות במצב: טבלת Lite מציינת allow_all ליצירה מטקסט לווידאו ו־allow_adult ליצירה מתמונה ולאינטרפולציה, וכללים אזוריים עשויים להגביל עוד את הפרופיל המתועד. בחרו תמונת פתיחה שתואמת לסצנה הראשונה שבאמת רצויה, עם נושא, מסגור ופרטים גלויים מוכנים לפני בקשת תנועה.
ליצירה מטקסט לווידאו, תארו את הנושא, פעולתו, הסביבה והסגנון הרצוי. הוסיפו מיקום ותנועת מצלמה, מסגור, מיקוד ותאורה כאשר הם חשובים. סצנת מוצר מקורית יכולה לשמור את העצם במרכז בעוד המצלמה מתקרבת לפרט חומר אחד והאור שסביבו משתנה בעדינות. הגדירו מצב התחלתי, פעולה מרכזית ורגע סופי כדי שהקליפ הקצר יממש רעיון מגובש אחד. אוסף ארוך של פעולות שאינן קשורות הוא משימה שונה משוט ממוקד.
ליצירה מתמונה לווידאו, ספקו פריים התחלתי ברור והסבירו מה צריך לזוז ומה צריך להישאר יציב. הגדירו בנפרד את תנועת הנושא ואת כל תנועת המצלמה. אם משתמשים באילוץ פריים סופי, הכינו קומפוזיציית סיום תואמת ותארו את המעבר ביניהן. בדקו את התוצאה במקום להניח שזהות, מיקום או צורה שהתבקשו נשארים זהים לאורך כל הקליפ. כרטיס המודל שאליו מפנים מזהה עקביות מלאה בסצנות מורכבות ותנועה מורכבת כאתגר מתמשך.
מדריך ההנחיות תומך בסימנים מפורשים לדיאלוג, לאפקטים קוליים ולאווירה. שימו דיבור מדויק במירכאות, זהו את הדובר ותארו קולות ביחס לפעולה הגלויה. אין לבלבל בין אפקט קולי ואווירת רקע לבין שורה מדוברת. אנגלית מתועדת כנתמכת באופן מלא בהנחיות, ואילו שפות אחרות לא הוערכו במדריך הזה. בדקו את המילים הנשמעות, התזמון ואיכות הקול כחלק מאותו תוצר כמו הווידאו, במקום להתייחס לאודיו כתמלול נאמן מובטח של ההנחיה.
תהליך העבודה של היצרן הוא אסינכרוני: בקשת יצירה מחזירה פעולה, והתוצאה שהושלמה מתקבלת לאחר שהסטטוס שלה מדווח על השלמה. שמרו את מזהה הפעולה ובדקו את הקליפ שהוחזר. המדריך מתאר שמירה למשך יומיים בצד היצרן וסימון SynthID, לכן תוצר שמור צריך לכלול את התוצאה שהורדה, את ההנחיה, את תמונות המקור ואת ההגדרות שנבחרו. ערך seed יכול לשפר שחזור אך אינו מבטיח דטרמיניזם. בדקו רציפות נושא, פעולה, מסגור, קול ונקודת סיום רצויה של הסצנה לפני שימוש בקליפ בעריכה; השלמת עיבוד לבדה אינה הוכחה שהדרישות היצירתיות מולאו.
Ailoot Ultra · וידאו POST /v1/videos google/veo-3.1-lite
google/veo-3.1-liteהתחלה
הפכו תיאור סצנה לסרטון באורך 4, 6 או 8 שניות ברזולוציית 720p.
- הצגת מוצר בתנועה
- יצירת סצנה שמציגה את מקום ההתרחשות
- התנסות בתנועת מצלמה קצרה
- סוגי קלט נתמכים
- טקסט · תמונות
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text,image- סוגי פלט
video- פורמט פלט
- mp4
- מספר פלטים
- עד 4 פלטs
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות google/veo-3.1-lite | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 מספר בייטים מרבי: 10,000 יחידה: בתים בקידוד UTF8 | ברירת מחדל— |
שדהduration | סוגinteger | דרישהחובה | ערכים ומגבלות 4, 6, 8 יחידה: שניות | ברירת מחדל— |
שדהresolution | סוגstring | דרישהחובה | ערכים ומגבלות 720p | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהחובה | ערכים ומגבלות 16:9, 9:16 | ברירת מחדל— |
שדהgenerate_audio | סוגboolean | דרישהחובה | ערכים ומגבלות false | ברירת מחדל— |
שדהframe_images | סוגarray | דרישהרשות | ערכים ומגבלות תנאים: יש להשמיט במצב text_to_video. אם השדה נכלל: פריט אחד בדיוק {"type":"image_url","image_url":{"url":"<actual HTTPS URL>"},"frame_type":"first_frame"}; הפריט כולל בדיוק type,image_url,frame_type; השדה image_url כולל בדיוק url. אין להוסיף מפתחות מיותרים או כפולים. רק duration=4,resolution="720p",aspect_ratio="16:9",generate_audio=false. כתובת URL חייבת להתפענח עם סכמה https, שם מארח שאינו ריק, ללא פרטי משתמש וללא תו # מילולי; מחרוזת השאילתה החתומה והנתיב המקודד נשמרים. קוד המקור אינו בודק את סוג ה־MIME של הקלט, את גודל הקובץ או את ממדיו בפיקסלים. | ברירת מחדל— |
שילובים של חומרי קלט
מטקסט לווידאו · נדרש: prompt
מתמונה לווידאו · נדרש: prompt, frame_images
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
פרמטרother_options | מפרטfalse |
פרמטרresolution | מפרט720p |
פרמטרprompt_max_bytes | מפרט10000 |
פרמטרduration | מפרט4, 6, 8 |
פרמטרaspect_ratio | מפרט16:9, 9:16 |
פרמטרgenerate_audio | מפרטfalse |
פרמטרmaterial_types | מפרטtext, image |
פרמטרparameters | מפרט{"name":"model","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["google/veo-3.1-lite"],"availability":"source_interface"}, {"name":"prompt","type":"string","required":true,"default_known":false,"default":null,"enum_known":false,"enum":null,"availability":"source_interface","min_length":1,"maximum_bytes":10000,"maximum_length":null,"unit":"בתים בקידוד UTF8"}, {"name":"duration","type":"integer","required":true,"default_known":false,"default":null,"enum_known":true,"enum":[4,6,8],"availability":"source_interface","unit":"שניות"}, {"name":"resolution","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["720p"],"availability":"source_interface"}, {"name":"aspect_ratio","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["16:9","9:16"],"availability":"source_interface"}, {"name":"generate_audio","type":"boolean","required":true,"default_known":false,"default":null,"enum_known":true,"enum":[false],"availability":"source_interface"}, {"name":"frame_images","type":"array","required":false,"default_known":false,"default":null,"enum_known":false,"enum":null,"availability":"source_interface","conditions":"יש להשמיט במצב text_to_video. אם השדה נכלל: פריט אחד בדיוק {\"type\":\"image_url\",\"image_url\":{\"url\":\"<actual HTTPS URL>\"},\"frame_type\":\"first_frame\"}; הפריט כולל בדיוק type,image_url,frame_type; השדה image_url כולל בדיוק url. אין להוסיף מפתחות מיותרים או כפולים. רק duration=4,resolution=\"720p\",aspect_ratio=\"16:9\",generate_audio=false. כתובת URL חייבת להתפענח עם סכמה https, שם מארח שאינו ריק, ללא פרטי משתמש וללא תו # מילולי; מחרוזת השאילתה החתומה והנתיב המקודד נשמרים. קוד המקור אינו בודק את סוג ה־MIME של הקלט, את גודל הקובץ או את ממדיו בפיקסלים."} |
כינויים לשיטה: /v1/videos/generations, /videos, /videos/generations
מחזור חיים: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
יש ליצור פעם אחת ולשמור את המזהה שהוחזר.
יש לבדוק במחזוריות את הסטטוס המקורי; יש לשמור כל נכס שהושלם ואת משכו.
תעריפים
אופן חישוב החיוב הסופי
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפים משוערים להשוואה
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | יצירת שמע | רזולוציה | יחידת חיוב | תנאי חיוב | חיוב |
|---|---|---|---|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | יצירת שמע— | רזולוציה— | יחידת חיוב— | תנאי חיוב— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יצירת שמע— | רזולוציה— | יחידת חיובלכל שניית וידאו | תנאי חיובאודיו: with_audio | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.16 לכל שניית וידאו |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יצירת שמע— | רזולוציה— | יחידת חיובלכל שניית וידאו | תנאי חיובאודיו: with_audio; רזולוציה: 720p | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.1 לכל שניית וידאו |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יצירת שמע— | רזולוציה— | יחידת חיובלכל שניית וידאו | תנאי חיובאודיו: without_audio | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.1 לכל שניית וידאו |
| תצורהUltra | טבלת תעריפים— | כמות חזויהההגדרות המבוקשות; אומדן בלבד. | יצירת שמעללא שמע | רזולוציה720p | יחידת חיובלכל שניית וידאו בפלט | תנאי חיוב— | חיוב פלט · שניית וידאו משוערת בפלט · אומדן להשוואה בלבד $0.06 לכל שניית וידאו בפלט התעריף המוצג אומד את העלות לפני היצירה. החיוב הסופי מחושב מהעלות שנרשמה ליצירה המקורית. משך הווידאו הפיזי אינו הכמות לחיוב. |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יצירת שמע— | רזולוציה— | יחידת חיוב— | תנאי חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.24 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
הפניות למחירי תצורות וידאו
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהמחיר וידאו | תנאי חיובאודיו: with_audio | חיוב פלט · מחיר וידאו $0.16 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובאודיו: without_audio | חיוב פלט · מחיר וידאו $0.1 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובאודיו: with_audio; רזולוציה: 720p | חיוב פלט · מחיר וידאו $0.1 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובאודיו: without_audio; רזולוציה: 720p | חיוב פלט · מחיר וידאו $0.06 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
דוגמאות לבקשות
Ailoot Ultra · וידאו
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1-lite", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 4, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": false}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URL:?Set the actual HTTPS URL of your first-frame image}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os,re
from pathlib import Path
from urllib.parse import urlsplit
image=os.environ["AILOOT_IMAGE_URL"]
try:
parsed=urlsplit(image)
valid=(image.startswith("https://") and parsed.scheme=="https" and bool(parsed.hostname)
and parsed.username is None and parsed.password is None and "#" not in image
and not any(ord(c)<32 or ord(c)==127 for c in image)
and re.search(r"%(?![0-9A-Fa-f]{2})",image) is None)
except ValueError:
valid=False
if not valid:
raise SystemExit("Use your actual HTTPS image URL with a hostname, no userinfo and no fragment")
p={"model":"google/veo-3.1-lite","prompt":"The subject makes a slow, natural movement. Keep the opening composition.","duration":4,"resolution":"720p","aspect_ratio":"16:9","generate_audio":False,"frame_images":[{"type":"image_url","image_url":{"url":image},"frame_type":"first_frame"}]}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print("Keep the complete JSON, headers and original returned id. Use the existing GET status tab for that original operation, then save every completed owned output. Never resubmit an unknown generation.")
PY_RESULT
קבלה ושמירה של תוצאות
Ailoot Ultra · וידאו
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
בדיקת מצב המשימה
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
for x in r.get("data",[]):print(x)
PY_STATUS
שמירת כל הנכסים שהושלמו
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
קריאות תוכן נוספות
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
שמירת כל התוצאות שהושלמו
שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.
data[] שהושלם מכיל את כל כתובות ה־URL החתומות לתוכן שבבעלותכם. יש לאחזר כל כתובת URL שהוחזרה, או להשתמש בנקודת הקצה לתוכן עם index המוגדר לאינדקס של פלט ממשי. משימה מקורית שנכשלה עשויה להחזיר charge_pending_check; יש לבדוק את המשימה המקורית הזו במקום ליצור אותה שוב. רצועת אודיו תקפה של AAC עשויה להיכלל גם כאשר generate_audio=false; יש לשמור את קובץ ה־MP4 המקורי במלואו, כולל האודיו הזה.
כשצריך לבדוק את התגובה המקורית
יש לקרוא את המשימה המקורית הקיימת; אין לשלוח שוב בקשה שתוצאת שליחתה אינה ידועה.
מספר פלטים מרבי: 4.
שדות התגובה
| שדה | סוג | משמעות |
|---|---|---|
שדהid | סוגstring | משמעות— |
שדהobject | סוגstring | משמעות— |
שדהmodel | סוגstring | משמעות— |
שדהstatus | סוגstring | משמעות— |
שדהdata[] | סוגsigned content URL | משמעות— |
שדהcharge_pending_check | סוגboolean | משמעות— |
שדהerror.code | סוגstring | משמעות— |
שדהerror.message | סוגstring | משמעות— |
שדהoperation_id | סוגstring | משמעותתגובת HTTP503 result_pending_check לסטטוס או לתוכן המקוריים: אותו מזהה ציבורי מקורי של פעולת הווידאו בשדה id. |
שדהerror.type | סוגstring | משמעותserver_error בתגובת HTTP503 result_pending_check. |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה400 · invalid_request_error | תנאישדות נדרשים, ייצוג חומר או ערך פרמטר שאינם תקינים | השלב הבאתקנו את השדות שצוינו לפני בקשת יצירה חדשה. |
תגובה409 · video_not_ready | תנאיתוכן התוצאה המקורית עדיין אינו זמין | השלב הבאיש לבדוק במחזוריות את המזהה המקורי שהוחזר ולכבד את Retry-After. |
תגובהserver_error | תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה | השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה. |
תגובה503 · result_pending_check | תנאיGET לסטטוס או לתוכן המקוריים: המשימה אינה מפורסמת, המשימה המקורית אינה במצב failed/cancelled/expired, והמצב המקומי הוא unknown או שסטטוס המשימה המקורית הוא completed. | השלב הבאיש לשמור את id ואת operation_id המקוריים (אותו מזהה וידאו ציבורי), את התגובה ואת הכותרות; יש לקרוא רק את הסטטוס והתוכן המקוריים. אין לשלוח בקשת יצירה חדשה. |
תגובה422 · price_unavailable | תנאיפענוח אובייקט frame_images שסופק או הפרופיל המותנה שלו נכשל, או שלפרופיל המלא שפוענח אין כרטיס מחיר מדויק ומוכן. | השלב הבאיש לשמור את model, prompt, duration, resolution, aspect_ratio ו־generate_audio. יש להוסיף frame_images המכיל בדיוק פריט first_frame אחד בפורמט האובייקט שצוין. יש להגדיר duration=4, resolution="720p", aspect_ratio="16:9" ו־generate_audio=false. האימות הזה מתבצע לפני שליחת הבקשה. |
כינויים
כינויים למודל
Ailoot Ultra google/veo-3.1-lite
כינויים לנתיבי שיטות
/v1/videos/generations, /videos, /videos/generations
מזהי מודלים קשורים IDs
FAQ · Google: Veo 3.1 Lite
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·google/veo-3.1-lite:text,image→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·google/veo-3.1-lite:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images