Google: Veo 3.1
Veo 3.1 הוא מודל הווידאו של Google לסצנות המבוססות על טקסט ותמונות, עם קול שנוצר, פריימי גבול מונחים ונכסי ייחוס. פרופיל ההפקה שלו מספק קליפים של ארבע, שש או שמונה שניות בקצב 24 פריימים לשנייה, עם אפשרויות פלט הכוללות 720p, 1080p ו־4K.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Veo 3.1 הוא מודל יצירת הווידאו של Google ליצירת סצנה קצרה עם תמונה וקול מטקסט או מבריף המבוסס על תמונה. פרופיל ההפקה שלו תומך ביצירה מטקסט לווידאו, מתמונה לווידאו וביצירה מונחית מפריים ראשון ואחרון, עם קול שנוצר, ייחוסי נכסים ותהליך המשכה נפרד. השתמשו בו לפיתוח קונספט קולנועי, לסיפור מוצר קצר או לקטע חזותי עם סצנה, פעולה וחוויית האזנה מוגדרות.
תארו תחילה את הנושא ואת האירוע הגלוי. הגדירו את הסביבה, שעת היום והתאורה, ואז הגדירו את נקודת המבט או התנועה של המצלמה ואת הסגנון החזותי הרצוי. בריף סצנה מקורי יכול להציג כלי זכוכית על משטח סטודיו כהה, עם תנועה אטית לצד שחושפת השתקפות בעוד קול סביבתי רך מלווה את החשיפה. כל הוראה נותנת מאפיין גלוי או נשמע שאפשר להעריך בתוצאה שהושלמה.
מסגרת ההנחיות של Google מתייחסת לנושא, לפעולה, לסצנה, למצלמה ולאסתטיקה כחלקים נפרדים של הבריף. השתמשו בחלקים שמשרתים את השוט במקום להוסיף כל תיאור אפשרי. כתבו הוראות באנגלית לפרופיל ההנחיות המתועד. אם יש בסצנה כמה פעולות, ציינו את הקשר ביניהן והתאימו אותן לקליפ קצר, כדי שחשיפה או תגובה יישארו ברורות.
תמונת פתיחה קובעת את המראה ואת הקומפוזיציה הראשוניים. השתמשו בה כשהדמות, המוצר או הסביבה כבר קיימים כנכס חזותי, ותארו את התנועה שצריכה להתפתח ממנה. פריים אחרון מוסיף קומפוזיציית יעד לסיום. הכינו פריימי גבול שמעבירים מעבר סביר ושומרים על הפרטים המזהים את הנושא המרכזי, ואז בדקו לאחר היצירה את התנועה בין הפריימים האלה.
ייחוסי נכסים משרתים מטרה אחרת: הם מנחים את המראה של דמות או עצם בסצנה חדשה שנוצרת, ואילו פריימי גבול מגדירים רגעים מסוימים בסצנה הזו. בחרו ייחוסים המציגים את התכונות החזותיות החשובות והבהירו בהנחיה את תפקידו של כל נכס. מפרט היצירה מתמונת ייחוס לווידאו של מודל ההפקה משתמש בפלט של שמונה שניות לתהליך הייחוסים הזה, בנפרד מבחירת המשך הרגילה המבוססת על טקסט.
פרופיל ההפקה הרגיל של היצרן יוצר קליפים של ארבע, שש או שמונה שניות בקצב 24 פריימים לשנייה. הוא מציין מסגור 16:9 לרוחב ו־9:16 לאורך, עד ארבעה סרטוני פלט לכל הנחיה ורזולוציות פלט של 720p, 1080p ו־4K. פורמט וידאו הפלט הוא MP4. המפרט שלו ליצירה מתמונה מקבל JPEG או PNG, מציין גודל מרבי של 20 MB לתמונת קלט ותומך בתצורות קלט 720p/1080p. בחרו את פרופיל הפלט לפי המיקום המיועד ושמרו על קומפוזיציית פריים קריאה בגודל הזה.
קול מובנה יכול ללוות את הסצנה הגלויה. הגדירו שורות מדוברות, אווירה ואפקטים קוליים כחלקים של אותו בריף, תוך ציון הנושא או האירוע שמפיקים כל אחד מהם. הוראת דיאלוג והוראת מצלמה עונות על שאלות שונות: אחת קובעת את הביצוע, והאחרת קובעת כיצד הצופה רואה אותו. התאימו את המילים לזמן הדיבור השימושי בקליפ ובדקו את מובנות הקול ואת הקשר שלו לפעולה.
להמשכה, היצרן מספק תהליך נפרד להארכת וידאו. התחילו מקליפ מקור שנוצר ומתאים לכך, ותארו את האירוע הגלוי הבא או את השינוי הבא בסצנה. שמרו את המקור ואת קטע ההמשך כדי שאפשר יהיה לבדוק את נקודת החיבור שלהם מבחינת מראה, תנועה וקול. אין להתייחס לאפשרויות המשך והרזולוציה הרגילות של יצירה חדשה כחוזה אוניברסלי לכל פעולת הארכה.
תיאור שלילי יכול למקד החרגות בדרישות החזותיות של המשימה. לסדרת וריאציות מוצר, שמרו על נושא וקומפוזיציה יציבים תוך שינוי כיוון יצירתי אחד, כגון התאורה או מרחק המצלמה. תעדו עם התוצאה את ההנחיה, הייחוסים וההגדרות שנבחרו. כך אפשר להשוות הבדל יצירתי שימושי במקום אוסף של יצירות שאינן קשורות.
לפרופיל ההפקה הרגיל של Veo 3.1 ול־Veo 3.1 Fast יש פרופילי רזולוציית פלט שונים. Fast מציין 720p ו־1080p; גרסה 3.1 הרגילה מציינת גם 4K. שמרו את המהדורה שנבחרה צמודה לתוצאה, בלי להחליף בשקט מזהה מודל הפקה בפרופיל Preview ישן יותר או בדור Veo אחר. גם מראה הנושא וגם הפעולה הנתמכת תלויים בתהליך העבודה שנבחר.
היצירה היא פעולה שתוצאתה המוגמרת מספקת תוצרי וידאו לניגון ולעריכה בהמשך. שמרו את הקבצים שהוחזרו עם פריימי המקור, נכסי הייחוס והבריף, ושמרו את מידע מקור התוכן שסופק. בדקו בכל פלט בפועל את מראה הנושא, הפעולה, המסגור, הקול והקומפוזיציה הסופית. השתמשו בקליפ שנבחר כאבן בניין להפקה, עם כותרות, מעברים או עבודות גימור אחרות המתווספים בעריכה שמסביב.
Ailoot Ultra · וידאו POST /v1/videos google/veo-3.1
google/veo-3.1התחלה
Veo 3.1 הוא מודל הווידאו של Google לסצנות המבוססות על טקסט ותמונות, עם קול שנוצר, פריימי גבול מונחים ונכסי ייחוס. פרופיל ההפקה שלו מספק קליפים של ארבע, שש או שמונה שניות בקצב 24 פריימים לשנייה, עם אפשרויות פלט הכוללות 720p, 1080p ו־4K.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text- סוגי פלט
video- פורמט פלט
- mp4
- מספר פלטים
- עד 4 פלטs
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות google/veo-3.1 | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות מספר בייטים מרבי ב-UTF-8: 10,000 נדרשים תווים שאינם רווחים: כן | ברירת מחדל— |
שדהduration | סוגinteger | דרישהחובה | ערכים ומגבלות 4, 6, 8 | ברירת מחדל— |
שדהresolution | סוגstring | דרישהחובה | ערכים ומגבלות 720p | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהחובה | ערכים ומגבלות 16:9, 9:16 | ברירת מחדל— |
שדהgenerate_audio | סוגboolean | דרישהחובה | ערכים ומגבלות false, true | ברירת מחדל— |
שילובים של חומרי קלט
מטקסט לווידאו · נדרש: prompt
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
פרמטרadditional_properties | מפרטfalse |
פרמטרparameters | מפרט{"name":"model","type":"string","required":true,"enum":["google/veo-3.1"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]} |
פרמטרmaterial_types | מפרטtext |
כינויים לשיטה: /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 טוקנים |
| תצורהUltra | טבלת תעריפים— | כמות חזויהההגדרות המבוקשות; אומדן בלבד. | יצירת שמעעם שמע | רזולוציה720p | יחידת חיובלכל שניית וידאו בפלט | תנאי חיוב— | חיוב פלט · שניית וידאו משוערת בפלט · אומדן להשוואה בלבד $0.8 לכל שניית וידאו בפלט התעריף המוצג אומד את העלות לפני היצירה. החיוב הסופי מחושב מהעלות שנרשמה ליצירה המקורית. משך הווידאו הפיזי אינו הכמות לחיוב. |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יצירת שמע— | רזולוציה— | יחידת חיובלכל שניית וידאו | תנאי חיובאודיו: with_audio; רזולוציה: 4k | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $1.2 לכל שניית וידאו |
| תצורהUltra | טבלת תעריפים— | כמות חזויהההגדרות המבוקשות; אומדן בלבד. | יצירת שמעללא שמע | רזולוציה720p | יחידת חיובלכל שניית וידאו בפלט | תנאי חיוב— | חיוב פלט · שניית וידאו משוערת בפלט · אומדן להשוואה בלבד $0.4 לכל שניית וידאו בפלט התעריף המוצג אומד את העלות לפני היצירה. החיוב הסופי מחושב מהעלות שנרשמה ליצירה המקורית. משך הווידאו הפיזי אינו הכמות לחיוב. |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | יצירת שמע— | רזולוציה— | יחידת חיובלכל שניית וידאו | תנאי חיובאודיו: without_audio; רזולוציה: 4k | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.8 לכל שניית וידאו |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | יצירת שמע— | רזולוציה— | יחידת חיוב— | תנאי חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $1.6 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
הפניות למחירי תצורות וידאו
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהמחיר וידאו | תנאי חיובאודיו: with_audio | חיוב פלט · מחיר וידאו $0.8 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובאודיו: with_audio; רזולוציה: 4k | חיוב פלט · מחיר וידאו $1.2 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובאודיו: without_audio | חיוב פלט · מחיר וידאו $0.4 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובאודיו: without_audio; רזולוציה: 4k | חיוב פלט · מחיר וידאו $0.8 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
דוגמאות לבקשות
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", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
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
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 and response headers; do not resubmit an unknown creation.')
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}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
קריאות תוכן נוספות
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
שמירת כל התוצאות שהושלמו
שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.
יש לשמור כל כתובת URL חתומה ובבעלותכם מתוך data[] שהושלם ואת מטא־נתוני הסטטוס המלאים. יש לשמור כל פלט, כולל האודיו שנוצר בו. רצועת אודיו תקפה של 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 | תנאיקריאת גוף הבקשה הגולמי נכשלת לפני פענוח פרופיל הווידאו | השלב הבאיש לשמור את התגובה שהוחזרה ולתקן את גוף הבקשה שלא ניתן לקרוא. |
תגובה422 · price_unavailable | תנאיפענוח פרופיל הווידאו המדויק נכשל, או שלפרופיל המלא שפוענח אין כרטיס מחיר מדויק ומוכן | השלב הבאיש לשמור את התגובה; יש להשתמש בפרופיל המלא והמדויק שאושר ובכרטיס המחיר שפורסם עבורו. הענף הזה מתבצע לפני שליחה לספק. |
תגובה409 · video_not_ready | תנאיתוכן התוצאה המקורית עדיין אינו זמין | השלב הבאיש לבדוק במחזוריות את המזהה המקורי שהוחזר ולכבד את Retry-After. |
תגובהserver_error | תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה | השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה. |
תגובה503 · result_pending_check | תנאיGET לסטטוס או לתוכן המקוריים: המשימה אינה מפורסמת, המשימה המקורית אינה במצב failed/cancelled/expired, והמצב המקומי הוא unknown או שסטטוס המשימה המקורית הוא completed. | השלב הבאיש לשמור את id ואת operation_id המקוריים (אותו מזהה וידאו ציבורי), את התגובה ואת הכותרות; יש לקרוא רק את הסטטוס והתוכן המקוריים. אין לשלוח בקשת יצירה חדשה. |
כינויים
כינויים למודל
Ailoot Ultra google/veo-3.1
כינויים לנתיבי שיטות
/v1/videos/generations, /videos, /videos/generations
מזהי מודלים קשורים IDs
FAQ · Google: Veo 3.1
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·google/veo-3.1:text→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·google/veo-3.1:model,prompt,duration,resolution,aspect_ratio,generate_audio