אתם יכולים להשתמש ב-Gemini Omni או ב-Veo ב-Gemini Enterprise Agent Platform כדי להאריך סרטונים. ב-Gemini Omni, אתם יכולים להזין סרטון בכל אורך. המודל משתמש ב-10 השניות האחרונות לכל היותר כדי ליצור המשך באורך של 3 עד 10 שניות, ומחבר אותו ל-30 השניות האחרונות לכל היותר של הסרטון שהזנתם (כך שהאורך הכולל של הסרטון שנוצר הוא עד 40 שניות). ב-Veo, סרטון הקלט צריך להיות באורך של שנייה אחת עד 30 שניות, ואפשר להאריך אותו ב-7 שניות (עד 37 שניות בסך הכול). אפשר להאריך סרטונים באמצעות מסוף Google Cloud או Agent Platform API.
המודלים הבאים תומכים בהארכת סרטונים:
Gemini Omni
לחצו כדי להרחיב את רשימת המודלים הנתמכים
Veo
לחצו כדי להרחיב את רשימת המודלים הנתמכים
במדריך ליצירת פרומפטים לסרטונים מוסבר איך לכתוב פרומפטים טקסטואליים יעילים ליצירת סרטונים.
איך מנסים את Gemini Omni ב-Colab
לפני שמתחילים
- נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloudליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
Enable the Agent Platform API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
Enable the Agent Platform API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
מגדירים אימות לסביבה שלכם.
צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:
המסוף
כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API של Google Cloud , לא צריך להגדיר אימות.
REST
כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.
התקינו את ה-CLI של Google Cloud.
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.
מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .
המגבלות של Veo
כשמשתמשים ב-Veo כדי להאריך סרטונים, הסרטונים שמעלים כפופים למגבלות הבאות:
- קובץ הקלט חייב להיות בפורמט MP4.
- האורך צריך להיות בין שנייה אחת ל-30 שניות.
- קצב הפריימים צריך להיות 24 FPS.
- הרזולוציה צריכה להיות אחת מהאפשרויות הבאות: 720p, 1080p או 4k.
- יחס הגובה-רוחב של סרטוני הקלט יכול להיות 9:16 או 16:9.
כשמשתמשים ב-Veo כדי להאריך סרטונים, הסרטונים שנוצרים כפופים למגבלות הבאות:
- קובץ הפלט הוא MP4.
- האורך המורחב הוא 7 שניות.
- קצב הפריימים הוא 24 פריימים לשנייה.
- הרזולוציה יכולה להיות 720p, 1080p או 4k.
- יחס הגובה-רוחב של סרטוני הפלט יכול להיות 9:16 או 16:9.
איך מאריכים סרטונים באמצעות Gemini Omni
כדי להאריך סרטונים באמצעות Gemini Omni, צריך להעלות סרטון קלט בכל אורך ולכתוב פרומפט טקסטואלי שמתאר את ההמשך (3 עד 10 שניות). המודל משתמש ב-10 השניות האחרונות של סרטון הקלט כדי ליצור את ההרחבה, ומשרשר את הסרטון שנוצר ל-30 השניות האחרונות של סרטון הקלט (לדוגמה, הרחבה של סרטון קלט באורך 60 שניות ב-10 שניות יוצרת סרטון פלט באורך 40 שניות). ב-gemini-omni-1.2-flash, אתם יכולים גם לכלול עד שתי תמונות רפרנס אופציונליות ("type": "image") במערך input כדי להנחות את הקטע המורחב, לציין generation_config.seed לתוצאות שניתן לשחזר ולצרף תוויות של מטא-נתונים בהתאמה אישית (labels) כדי לארגן בקשות ולעקוב אחרי עלויות החיוב.
REST
תהליך יצירת הסרטון יכול להימשך יותר מדקה. אתם יכולים לבחור מבין כמה מצבי אינטראקציה, בהתאם לתהליך העבודה שלכם:
- סינכרוני: בלי שמירת מצב: מגדירים את
storeלערךfalseכדי ליצור סרטון בבקשה אחת בלי לשמר את מצב האינטראקציה בשרת. - סינכרוני: עם שמירת מצב: מגדירים את
storeלערךtrueכדי לשמור את מצב האינטראקציה, וכך אפשר לאחזר את התוצאה מאוחר יותר או להפנות למזהה האינטראקציה לעריכת סרטונים בכמה שלבים. - סינכרוני: סטרימינג עם שמירת מצב: מגדירים את
storeוגם אתstreamלערךtrueכדי לקבל את תהליך החשיבה של המודל באופן מצטבר בזמן שהוא נוצר, ואחריו את סרטון הפלט באירועstep.deltaיחיד ("type": "video"). - אסינכרוני: מגדירים את
backgroundל-trueכדי להריץ את יצירת הסרטון ברקע ולאחזר את התוצאה מאוחר יותר באמצעות מזהה האינטראקציה.
אינטראקציות אסינכרוניות שנשמרות נשארות במערכת עד 7 ימים.
כשמגדירים את "delivery": "uri" ב-response_format, צריך לציין גם את gcs_uri. אם משמיטים את gcs_uri כש-"delivery" הוא "uri", תוחזר שגיאת 400 INVALID_ARGUMENT.
תגובות Unary מחזירות את ה-URI של Cloud Storage ב-steps[].content[].uri, ותגובות סטרימינג מחזירות אותו ב-delta.uri. כדי להחזיר בייטים של וידאו בתוך השורה בתגובה, מגדירים את "delivery": "inline" ומשמיטים את gcs_uri (אין תמיכה ב-gcs_uri כש-"delivery" הוא "inline"). כשמשתמשים בהעברה בתוך השורה, פלט הווידאו מוחזר כמחרוזת בייטים בקידוד base64 לצד "mime_type": "video/mp4" ב-steps[].content[].data (POST ו-GET אונריים) או ב-delta.data (SSE step.delta). בניגוד להפרשי טקסט או אודיו, סרטון בתוך השורה לא מחולק לחלקים בכמה אירועים של step.delta – כל סרטון שנוצר מועבר כמטען ייעודי (payload) מלא בקידוד base64 באירוע אחד של step.delta.
בסרטונים גדולים או ברזולוציה גבוהה, השתמשו ב-"delivery": "uri" עם gcs_uri כדי להימנע ממטענים ייעודיים (payloads) גדולים של תגובות HTTP או SSE של אירוע יחיד.
מידע נוסף על השימוש במודלים של Gemini Omni עם Interactions API
סינכרוני: בלי שמירת מצב
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מחרוזת שמייצגת את מזהה הפרויקט ב- Google Cloud . -
MODEL_ID: מחרוזת שמייצגת את מזהה המודל שבו רוצים להשתמש. אלה הערכים הקבילים:"gemini-omni-1.2-flash""gemini-omni-1.1-flash-preview"
-
TEXT_PROMPT: הפרומפט הטקסטואלי שמשמש ליצירת סרטונים. -
CLOUD_STORAGE_VIDEO_URI: מחרוזת שמייצגת את הקטגוריה של Cloud Storage שמכילה את סרטון הקלט. לדוגמה:"gs://video-bucket/input/". -
VIDEO_MIME: מחרוזת שמייצגת סוג MIME של סרטון. אלה הערכים הקבילים:video/3gppvideo/mp4video/mpegvideo/quicktimevideo/webmvideo/x-flvvideo/x-ms-wmv
-
CLOUD_STORAGE_OUTPUT_URI: מחרוזת שמייצגת את הקטגוריה של Cloud Storage שבה יאוחסנו סרטוני הפלט (לדוגמה,"gs://video-bucket/output/"). חובה כשמגדירים אתdeliveryל-"uri". כדי להחזיר את הבייטים של הסרטון בתשובה, מגדירים את"delivery": "inline"ומשמיטים אתgcs_uriמ-response_format. -
ASPECT_RATIO: אופציונלי: מחרוזת שמייצגת את יחס הגובה-רוחב הצפוי של סרטון הפלט. אם לא מציינים יחס גובה-רוחב, הוא נקבע לפי ההנחיה. אלה הערכים הקבילים:"16:9""9:16"
-
DURATION: מחרוזת שמייצגת את האורך של קובצי הווידאו שנוצרו. המחרוזות המותרות הן מספרים שלמים בין3ל-10, ואחריהם האות s (שניות). לדוגמה,"10s".
ה-method של ה-HTTP וכתובת ה-URL:
POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions
גוף בקשת JSON:
{
"model": "MODEL_ID",
"store": false,
"input": [
{
"type": "text",
"text": "TEXT_PROMPT"
},
{
"type": "video",
"uri": "CLOUD_STORAGE_VIDEO_URI",
"mime_type": "VIDEO_MIME"
}
],
"response_format": [
{
"type": "video",
"delivery": "uri",
"gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
"aspect_ratio": "ASPECT_RATIO",
"duration": "DURATION"
}
],
"generation_config": {
"video_config": {
"task": "extend"
}
}
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$headers = @{ "Authorization" = "Bearer TOKEN" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content
{
"id":"INTERACTION_ID",
"model":"gemini-omni-1.2-flash",
"status":"completed",
"usage":{
"total_tokens":479,
"total_input_tokens":26,
"input_tokens_by_modality":[
{
"modality":"text",
"tokens":26
},
{
"modality":"image",
"tokens":124
}
],
"output_tokens_by_modality": [
{
"modality": "video",
"tokens": 28832
}
],
"total_output_tokens":28832,
"total_thought_tokens":453
},
"steps":[
{
"type":"thought",
"summary":[
{
"type":"text",
"text":"MODEL THOUGHTS"
}
]
},
{
"type":"model_output",
"content":[
{
"type":"video",
"uri":"gs://some/output_path/123.mp4",
"mime_type":"video/mp4"
}
]
}
],
"object":"interaction",
"role":"model",
"created":"2026-05-29T02:17:56Z",
"updated":"2026-05-29T02:17:56Z"
}
סינכרוני: עם שמירת מצב (stateful)
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מחרוזת שמייצגת את מזהה הפרויקט ב- Google Cloud . -
MODEL_ID: מחרוזת שמייצגת את מזהה המודל שבו רוצים להשתמש. אלה הערכים הקבילים:"gemini-omni-1.2-flash""gemini-omni-1.1-flash-preview"
-
TEXT_PROMPT: הפרומפט הטקסטואלי שמשמש ליצירת סרטונים. -
CLOUD_STORAGE_VIDEO_URI: מחרוזת שמייצגת את הקטגוריה של Cloud Storage שמכילה את סרטון הקלט. לדוגמה:"gs://video-bucket/input/". -
VIDEO_MIME: מחרוזת שמייצגת סוג MIME של סרטון. אלה הערכים הקבילים:video/3gppvideo/mp4video/mpegvideo/quicktimevideo/webmvideo/x-flvvideo/x-ms-wmv
-
CLOUD_STORAGE_OUTPUT_URI: מחרוזת שמייצגת את הקטגוריה של Cloud Storage שבה יאוחסנו סרטוני הפלט (לדוגמה,"gs://video-bucket/output/"). חובה כשמגדירים אתdeliveryל-"uri". כדי להחזיר את הבייטים של הסרטון בתשובה, מגדירים את"delivery": "inline"ומשמיטים אתgcs_uriמ-response_format. -
ASPECT_RATIO: אופציונלי: מחרוזת שמייצגת את יחס הגובה-רוחב הצפוי של סרטון הפלט. אם לא מציינים יחס גובה-רוחב, הוא נקבע לפי ההנחיה. אלה הערכים הקבילים:"16:9""9:16"
-
DURATION: מחרוזת שמייצגת את האורך של קובצי הווידאו שנוצרו. המחרוזות המותרות הן מספרים שלמים בין3ל-10, ואחריהם האות s (שניות). לדוגמה,"10s".
ה-method של ה-HTTP וכתובת ה-URL:
POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions
גוף בקשת JSON:
{
"model": "MODEL_ID",
"background": false,
"store": true,
"stream": false,
"input": [
{
"type": "user_input",
"content": [
{
"type": "text",
"text": "TEXT_PROMPT"
},
{
"type": "video",
"uri": "CLOUD_STORAGE_VIDEO_URI",
"mime_type": "VIDEO_MIME"
}
]
}
],
"response_format": [
{
"type": "video",
"delivery": "uri",
"gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
"aspect_ratio": "ASPECT_RATIO",
"duration": "DURATION"
}
],
"generation_config": {
"video_config": {
"task": "extend"
}
}
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$headers = @{ "Authorization" = "Bearer TOKEN" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content
{
"id":"INTERACTION_ID",
"model":"gemini-omni-1.2-flash",
"status":"completed",
"usage":{
"total_tokens":479,
"total_input_tokens":26,
"input_tokens_by_modality":[
{
"modality":"text",
"tokens":26
},
{
"modality":"image",
"tokens":124
}
],
"output_tokens_by_modality": [
{
"modality": "video",
"tokens": 28832
}
],
"total_output_tokens":28832,
"total_thought_tokens":453
},
"steps":[
{
"type":"thought",
"summary":[
{
"type":"text",
"text":"MODEL THOUGHTS"
}
]
},
{
"type":"model_output",
"content":[
{
"type":"video",
"uri":"gs://some/output_path/123.mp4",
"mime_type":"video/mp4"
}
]
}
],
"object":"interaction",
"role":"model",
"created":"2026-05-29T02:17:56Z",
"updated":"2026-05-29T02:17:56Z"
}
INTERACTION_ID:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מחרוזת שמייצגת את מזהה הפרויקט ב- Google Cloud . -
INTERACTION_ID: מזהה האינטראקציה מהבקשה.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
curl
מריצים את הפקודה הבאה:
curl -X GET \
-H "Authorization: Bearer TOKEN" \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID"
PowerShell
מריצים את הפקודה הבאה:
$headers = @{ "Authorization" = "Bearer TOKEN" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID" | Select-Object -Expand Content
{
"id":"INTERACTION_ID",
"model":"gemini-omni-1.2-flash",
"status":"completed",
"usage":{
"total_tokens":29435,
"total_input_tokens":150,
"input_tokens_by_modality":[
{
"modality":"text",
"tokens":26
},
{
"modality":"image",
"tokens":124
}
],
"output_tokens_by_modality": [
{
"modality": "video",
"tokens": 28832
}
],
"total_output_tokens":28832,
"total_thought_tokens":453
},
"steps":[
{
"type": "user_input",
"content": [
{
"type": "text",
"text": "5 second, 9:16 video. Use the image as the first frame."
},
{
"type": "image",
"uri": "gs://some/path",
"mime_type": "image/png"
}
]
},
{
"type":"thought",
"summary":[
{
"type":"text",
"text":"MODEL THOUGHTS"
}
]
},
{
"type":"model_output",
"content":[
{
"type":"video",
"uri":"gs://some/output_path/123.mp4",
"mime_type":"video/mp4"
}
]
}
],
"object":"interaction",
"role":"model",
"created":"2026-05-29T02:17:56Z",
"updated":"2026-05-29T02:17:56Z"
}
כשמשתמשים בהעברה מוטבעת ("delivery": "inline" בלי gcs_uri), השלב model_output מחזיר את הסרטון המלא כמחרוזת בייטים בקידוד base64 ב-steps[].content[].data לצד "mime_type": "video/mp4" במקום uri:
{
"type": "model_output",
"content": [
{
"type": "video",
"data": "BASE64_ENCODED_VIDEO",
"mime_type": "video/mp4"
}
]
}סינכרוני: סטרימינג עם שמירת מצב (stateful)
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מחרוזת שמייצגת את מזהה הפרויקט ב- Google Cloud . -
MODEL_ID: מחרוזת שמייצגת את מזהה המודל שבו רוצים להשתמש. אלה הערכים הקבילים:"gemini-omni-1.2-flash""gemini-omni-1.1-flash-preview"
-
TEXT_PROMPT: הפרומפט הטקסטואלי שמשמש ליצירת סרטונים. -
CLOUD_STORAGE_VIDEO_URI: מחרוזת שמייצגת את הקטגוריה של Cloud Storage שמכילה את סרטון הקלט. לדוגמה:"gs://video-bucket/input/". -
VIDEO_MIME: מחרוזת שמייצגת סוג MIME של סרטון. אלה הערכים הקבילים:video/3gppvideo/mp4video/mpegvideo/quicktimevideo/webmvideo/x-flvvideo/x-ms-wmv
-
CLOUD_STORAGE_OUTPUT_URI: מחרוזת שמייצגת את הקטגוריה של Cloud Storage שבה יאוחסנו סרטוני הפלט (לדוגמה,"gs://video-bucket/output/"). חובה כשמגדירים אתdeliveryל-"uri". כדי להחזיר את הבייטים של הסרטון בתשובה, מגדירים את"delivery": "inline"ומשמיטים אתgcs_uriמ-response_format. -
ASPECT_RATIO: אופציונלי: מחרוזת שמייצגת את יחס הגובה-רוחב הצפוי של סרטון הפלט. אם לא מציינים יחס גובה-רוחב, הוא נקבע לפי ההנחיה. אלה הערכים הקבילים:"16:9""9:16"
-
DURATION: מחרוזת שמייצגת את האורך של קובצי הווידאו שנוצרו. המחרוזות המותרות הן מספרים שלמים בין3ל-10, ואחריהם האות s (שניות). לדוגמה,"10s".
ה-method של ה-HTTP וכתובת ה-URL:
POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions
גוף בקשת JSON:
{
"model": "MODEL_ID",
"background": false,
"store": true,
"stream": true,
"input": [
{
"type": "user_input",
"content": [
{
"type": "text",
"text": "TEXT_PROMPT"
},
{
"type": "video",
"uri": "CLOUD_STORAGE_VIDEO_URI",
"mime_type": "VIDEO_MIME"
}
]
}
],
"response_format": [
{
"type": "video",
"delivery": "uri",
"gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
"aspect_ratio": "ASPECT_RATIO",
"duration": "DURATION"
}
],
"generation_config": {
"video_config": {
"task": "extend"
}
}
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$headers = @{ "Authorization" = "Bearer TOKEN" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content
event: interaction.created
data: {"interaction":{"id":"INTERACTION_ID","status":"in_progress","object":"interaction","model":"gemini-omni-1.2-flash"},"event_type":"interaction.created"}
event: interaction.status_update
data: {"interaction_id":"INTERACTION_ID","status":"in_progress","event_type":"interaction.status_update"}
event: step.start
data: {"index":0,"step":{"type":"thought"},"event_type":"step.start"}
event: step.delta
data: {"index":0,"delta":{"content":{"text":"MODEL THOUGHTS","type":"text"},"type":"thought_summary"},"event_id":"EVENT_ID","event_type":"step.delta"}
event: step.delta
data: {"index":0,"delta":{"content":{"text":"MODEL THOUGHTS","type":"text"},"type":"thought_summary"},"event_id":"EVENT_ID","event_type":"step.delta"}
event: step.delta
data: {"index":0,"delta":{"signature":"...","type":"thought_signature"},"event_type":"step.delta"}
event: step.stop
data: {"index":0,"event_type":"step.stop"}
event: step.start
data: {"index":1,"step":{"type":"model_output"},"event_type":"step.start"}
event: step.delta
data: {"index":1,"delta":{"mime_type":"video/mp4","uri":"gs://some/output_path/123.mp4","type":"video"},"event_id":"EVENT_ID","event_type":"step.delta"}
event: step.stop
data: {"index":1,"event_type":"step.stop"}
event: interaction.completed
data: {"interaction":{"id":"INTERACTION_ID","status":"completed","usage":{"total_tokens":17812,"total_input_tokens":21,"input_tokens_by_modality":[{"modality":"text","tokens":21}],"total_output_tokens":17376,"output_tokens_by_modality":[{"modality":"video","tokens":17376}],"total_thought_tokens":415},"created":"2026-08-12T21:26:20Z","updated":"2026-08-12T21:26:20Z","event_id":"EVENT_ID","object":"interaction","model":"gemini-omni-1.2-flash"},"event_id":"EVENT_ID","event_type":"interaction.completed"}
event: done
data: [DONE]
כשמשתמשים בהעברה מוטבעת ("delivery": "inline" בלי gcs_uri), האירוע step.delta של הסרטון מחזיר את הבייטים של הסרטון ב-delta.data כמחרוזת בקידוד base64 לצד "mime_type": "video/mp4" במקום delta.uri:
event: step.delta
data: {"index":1,"delta":{"mime_type":"video/mp4","data":"BASE64_ENCODED_VIDEO","type":"video"},"event_id":"EVENT_ID","event_type":"step.delta"}
בניגוד לשינויים בטקסט ("type": "text") או באודיו ("type": "audio"), וידאו מוטבע לא מחולק לחלקים בכמה אירועים של step.delta. כל סרטון שנוצר נשלח כתוכן נתונים מלא אחד בקידוד Base64 באירוע step.delta אחד ("type": "video"). אל תשרשרו את delta.data בכמה אירועי step.delta של סרטונים.
בסרטונים גדולים או ברזולוציה גבוהה, צריך להשתמש ב-"delivery": "uri" עם קטגוריה של Cloud Storage (gcs_uri) כדי להימנע מעומסי נתונים גדולים של SSE באירוע יחיד.
INTERACTION_ID עם `?stream=true` כדי להעביר בסטרימינג את האינטראקציה השמורה ואת הסרטון שנוצר:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מחרוזת שמייצגת את מזהה הפרויקט ב- Google Cloud . -
INTERACTION_ID: מזהה האינטראקציה מהבקשה.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID?stream=true
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
curl
מריצים את הפקודה הבאה:
curl -X GET \
-H "Authorization: Bearer TOKEN" \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID?stream=true"
PowerShell
מריצים את הפקודה הבאה:
$headers = @{ "Authorization" = "Bearer TOKEN" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID?stream=true" | Select-Object -Expand Content
event: interaction.created
data: {"interaction":{"id":"INTERACTION_ID","status":"in_progress","object":"interaction","model":"gemini-omni-1.2-flash"},"event_type":"interaction.created"}
event: interaction.status_update
data: {"interaction_id":"INTERACTION_ID","status":"in_progress","event_type":"interaction.status_update"}
event: step.start
data: {"index":0,"step":{"type":"thought"},"event_type":"step.start"}
event: step.delta
data: {"index":0,"delta":{"content":{"text":"MODEL THOUGHTS","type":"text"},"type":"thought_summary"},"event_id":"EVENT_ID","event_type":"step.delta"}
event: step.delta
data: {"index":0,"delta":{"content":{"text":"MODEL THOUGHTS","type":"text"},"type":"thought_summary"},"event_id":"EVENT_ID","event_type":"step.delta"}
event: step.delta
data: {"index":0,"delta":{"signature":"...","type":"thought_signature"},"event_type":"step.delta"}
event: step.stop
data: {"index":0,"event_type":"step.stop"}
event: step.start
data: {"index":1,"step":{"type":"model_output"},"event_type":"step.start"}
event: step.delta
data: {"index":1,"delta":{"mime_type":"video/mp4","uri":"gs://some/output_path/123.mp4","type":"video"},"event_id":"EVENT_ID","event_type":"step.delta"}
event: step.stop
data: {"index":1,"event_type":"step.stop"}
event: interaction.completed
data: {"interaction":{"id":"INTERACTION_ID","status":"completed","usage":{"total_tokens":17664,"total_input_tokens":21,"input_tokens_by_modality":[{"modality":"text","tokens":21}],"total_output_tokens":17376,"output_tokens_by_modality":[{"modality":"video","tokens":17376}],"total_thought_tokens":267},"created":"2026-08-12T21:33:08Z","updated":"2026-08-12T21:33:08Z","event_id":"EVENT_ID","object":"interaction","model":"gemini-omni-1.2-flash"},"event_id":"EVENT_ID","event_type":"interaction.completed"}
event: done
data: [DONE]
כשמשתמשים בהעברה מוטבעת ("delivery": "inline" בלי gcs_uri), האירוע step.delta של הסרטון מחזיר את הבייטים של הסרטון ב-delta.data כמחרוזת בקידוד base64 לצד "mime_type": "video/mp4" במקום delta.uri:
event: step.delta
data: {"index":1,"delta":{"mime_type":"video/mp4","data":"BASE64_ENCODED_VIDEO","type":"video"},"event_id":"EVENT_ID","event_type":"step.delta"}
בניגוד לשינויים בטקסט ("type": "text") או באודיו ("type": "audio"), וידאו מוטבע לא מחולק לחלקים בכמה אירועים של step.delta. כל סרטון שנוצר נשלח כתוכן נתונים מלא אחד בקידוד Base64 באירוע step.delta אחד ("type": "video"). אל תשרשרו את delta.data בכמה אירועי step.delta של סרטונים.
בסרטונים גדולים או ברזולוציה גבוהה, צריך להשתמש ב-"delivery": "uri" עם קטגוריה של Cloud Storage (gcs_uri) כדי להימנע מעומסי נתונים גדולים של SSE באירוע יחיד.
אסינכרוני
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מחרוזת שמייצגת את מזהה הפרויקט ב- Google Cloud . -
MODEL_ID: מחרוזת שמייצגת את מזהה המודל שבו רוצים להשתמש. אלה הערכים הקבילים:"gemini-omni-1.2-flash""gemini-omni-1.1-flash-preview"
-
TEXT_PROMPT: הפרומפט הטקסטואלי שמשמש ליצירת סרטונים. -
CLOUD_STORAGE_VIDEO_URI: מחרוזת שמייצגת את הקטגוריה של Cloud Storage שמכילה את סרטון הקלט. לדוגמה:"gs://video-bucket/input/". -
VIDEO_MIME: מחרוזת שמייצגת סוג MIME של סרטון. אלה הערכים הקבילים:video/3gppvideo/mp4video/mpegvideo/quicktimevideo/webmvideo/x-flvvideo/x-ms-wmv
-
CLOUD_STORAGE_OUTPUT_URI: מחרוזת שמייצגת את הקטגוריה של Cloud Storage שבה יאוחסנו סרטוני הפלט (לדוגמה,"gs://video-bucket/output/"). חובה כשמגדירים אתdeliveryל-"uri". כדי להחזיר את הבייטים של הסרטון בתשובה, מגדירים את"delivery": "inline"ומשמיטים אתgcs_uriמ-response_format. -
ASPECT_RATIO: אופציונלי: מחרוזת שמייצגת את יחס הגובה-רוחב הצפוי של סרטון הפלט. אם לא מציינים יחס גובה-רוחב, הוא נקבע לפי ההנחיה. אלה הערכים הקבילים:"16:9""9:16"
-
DURATION: מחרוזת שמייצגת את האורך של קובצי הווידאו שנוצרו. המחרוזות המותרות הן מספרים שלמים בין3ל-10, ואחריהם האות s (שניות). לדוגמה,"10s".
ה-method של ה-HTTP וכתובת ה-URL:
POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions
גוף בקשת JSON:
{
"model": "MODEL_ID",
"background": true,
"input": [
{
"type": "text",
"text": "TEXT_PROMPT"
},
{
"type": "video",
"uri": "CLOUD_STORAGE_VIDEO_URI",
"mime_type": "VIDEO_MIME"
}
],
"response_format": [
{
"type": "video",
"delivery": "uri",
"gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
"aspect_ratio": "ASPECT_RATIO",
"duration": "DURATION"
}
],
"generation_config": {
"video_config": {
"task": "extend"
}
}
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$headers = @{ "Authorization" = "Bearer TOKEN" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content
{
"id":"INTERACTION_ID",
"status":"in_progress",
"object":"interaction"
}
INTERACTION_ID כדי לקבל את הסרטון שנוצר:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מחרוזת שמייצגת את מזהה הפרויקט ב- Google Cloud . -
INTERACTION_ID: מזהה האינטראקציה מהבקשה.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
curl
מריצים את הפקודה הבאה:
curl -X GET \
-H "Authorization: Bearer TOKEN" \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID"
PowerShell
מריצים את הפקודה הבאה:
$headers = @{ "Authorization" = "Bearer TOKEN" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID" | Select-Object -Expand Content
{
"id":"INTERACTION_ID",
"model":"gemini-omni-1.2-flash",
"status":"completed",
"usage":{
"total_tokens":29435,
"total_input_tokens":150,
"input_tokens_by_modality":[
{
"modality":"text",
"tokens":26
},
{
"modality":"image",
"tokens":124
}
],
"output_tokens_by_modality": [
{
"modality": "video",
"tokens": 28832
}
],
"total_output_tokens":28832,
"total_thought_tokens":453
},
"steps":[
{
"type": "user_input",
"content": [
{
"type": "text",
"text": "5 second, 9:16 video. Use the image as the first frame."
},
{
"type": "image",
"uri": "gs://some/path",
"mime_type": "image/png"
}
]
},
{
"type":"thought",
"summary":[
{
"type":"text",
"text":"MODEL THOUGHTS"
}
]
},
{
"type":"model_output",
"content":[
{
"type":"video",
"uri":"gs://some/output_path/123.mp4",
"mime_type":"video/mp4"
}
]
}
],
"object":"interaction",
"role":"model",
"created":"2026-05-29T02:17:56Z",
"updated":"2026-05-29T02:17:56Z"
}
כשמשתמשים בהעברה מוטבעת ("delivery": "inline" בלי gcs_uri), השלב model_output מחזיר את הסרטון המלא כמחרוזת בייטים בקידוד base64 ב-steps[].content[].data לצד "mime_type": "video/mp4" במקום uri:
{
"type": "model_output",
"content": [
{
"type": "video",
"data": "BASE64_ENCODED_VIDEO",
"mime_type": "video/mp4"
}
]
}איך מאריכים סרטונים באמצעות Veo
הדוגמאות הבאות מראות איך אפשר להאריך סרטון Veo:
המסוף
במסוף Google Cloud , נכנסים לדף Agent Platform > Media Studio.
לוחצים על סרטון.
בתפריט משימה, בוחרים באפשרות תוסף וידאו.
בתפריט מודל, בוחרים מודל מהאפשרויות שמוצגות.
בקטע סרטון קלט, לוחצים על הוספה.
בתיבה Prompt, מזינים פרומפט טקסטואלי שמתאר את הסרטונים שרוצים ליצור.
אופציונלי: משנים את הפרמטרים הבאים:
מספר התוצאות: משנים את המיקום של פס ההזזה או מזינים ערך בין 1 ל-4.
אורך הסרטון: בוחרים אורך סרטון מהתפריט.
- Output directory: לוחצים על Browse כדי ליצור או לבחור קטגוריה של Cloud Storage שבה יאוחסנו הקבצים שנוצרו.
- לוחצים על Run.
Python
התקנה
pip install --upgrade google-genai
מידע נוסף זמין במאמרי העזרה של ה-SDK.
מגדירים משתני סביבה כדי להשתמש ב-Google Gen AI SDK עם Vertex AI:
# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values # with appropriate values for your project. export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT export GOOGLE_CLOUD_LOCATION=global export GOOGLE_GENAI_USE_ENTERPRISE=True
REST
למידע נוסף על Veo API, אפשר לעיין במאמרים הבאים:
- שיטה:
endpoints.predict VideoGenerationModelInstanceVideoGenerationModelParamsVideoGenerationModelResult
כדי לשלוח בקשה ליצירת סרטון, משתמשים בפקודה הבאה. הבקשה הזו מתחילה פעולה ממושכת ושומרת את הפלט בקטגוריה של Cloud Storage שציינתם.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מחרוזת שמייצגת את מזהה הפרויקט ב- Google Cloud . -
MODEL_ID: מחרוזת שמייצגת את מזהה המודל שבו רוצים להשתמש. כשמאריכים סרטון, משתמשים באחת מהאפשרויות הבאות:- Veo 3.1:
veo-3.1-generate-001 - Veo 3.1:
veo-3.1-fast-generate-001
- Veo 3.1:
-
TEXT_PROMPT: פרומפט הטקסט שמשמש ליצירת הסרטון. -
PATH_TO_VIDEO: מחרוזת שמייצגת את הנתיב ב-Cloud Storage לסרטון Veo שאתם מאריכים. לדוגמה:"gs://video-bucket/input/veo-video.mp4". -
OUTPUT_STORAGE_URI: אופציונלי: מחרוזת שמייצגת את הקטגוריה של Cloud Storage שבה יישמרו סרטוני הפלט. אם לא מציינים את הפרמטר, בייטים של הסרטון מוחזרים בתגובה. לדוגמה:"gs://video-bucket/output/". -
RESPONSE_COUNT: מספר קובצי הווידאו שרוצים ליצור. טווח הערכים הקבילים הוא1-4. -
פרמטרים אופציונליים נוספים
אפשר להשתמש במשתנים האופציונליים הבאים, בהתאם לתרחיש לדוגמה. מוסיפים חלק מהפרמטרים הבאים או את כולם לאובייקט
"parameters": {}."parameters": { "aspectRatio": "ASPECT_RATIO", "negativePrompt": "NEGATIVE_PROMPT", "personGeneration": "PERSON_SAFETY_SETTING", // "resolution": RESOLUTION, // Veo 3 models only "sampleCount": RESPONSE_COUNT, "seed": SEED_NUMBER }-
ASPECT_RATIO: אופציונלי: ערך מחרוזת שמתאר את יחס הגובה-רוחב של הסרטונים שנוצרו. אפשר להשתמש בערכים הבאים:-
"16:9"לרוחב -
"9:16"לאורך
ערך ברירת המחדל הוא
"16:9" -
-
NEGATIVE_PROMPT: אופציונלי. ערך מחרוזת שמתאר את התוכן שאתם רוצים למנוע מהמודל ליצור. -
PERSON_SAFETY_SETTING: אופציונלי: ערך מחרוזת ששולט בהגדרת הבטיחות ליצירת אנשים או פנים. אפשר להשתמש בערכים הבאים:-
"allow_adult": אפשר ליצור רק תמונות של אנשים ופנים של מבוגרים. -
"disallow": לא יוצר אנשים או פנים.
ערך ברירת המחדל הוא
"allow_adult". -
-
RESOLUTION: אופציונלי. ערך מחרוזת שקובע את הרזולוציה של הסרטון שנוצר. נתמך במודלים של Veo 3 בלבד. אפשר להשתמש בערכים הבאים:"720p""1080p"-
"4k"(רק במודלים של Veo 3.1 Preview)
ערך ברירת המחדל הוא
"720p". -
RESPONSE_COUNT: אופציונלי. ערך של מספר שלם שמתאר את מספר הסרטונים שרוצים ליצור. טווח הערכים הקבילים הוא1-4. -
SEED_NUMBER: אופציונלי. ערך uint32 שהמודל משתמש בו כדי ליצור סרטונים דטרמיניסטיים. אם תציינו מספר גרעין בבקשה בלי לשנות פרמטרים אחרים, המודל ייצור את אותם סרטונים. טווח הערכים הקבילים הוא0-4294967295.
-
ה-method של ה-HTTP וכתובת ה-URL:
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
גוף בקשת JSON:
{ "instances": [ { "prompt": "TEXT_PROMPT", "video": { "gcsUri": "PATH_TO_VIDEO", "mimeType": "video/mp4" } } ], "parameters": { "storageUri": "OUTPUT_STORAGE_URI", "sampleCount": RESPONSE_COUNT } }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הבקשה הזו מחזירה שם פעולה מלא עם מזהה פעולה ייחודי. כדי לבדוק את הסטטוס של הבקשה ליצירת סרטון, צריך להשתמש בשם המלא של הפעולה.curl
שומרים את גוף הבקשה בקובץ בשם
request.jsonומריצים את הפקודה הבאה:curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning"PowerShell
שומרים את גוף הבקשה בקובץ בשם
request.jsonומריצים את הפקודה הבאה:$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning" | Select-Object -Expand Content{ "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8" }-
אופציונלי: בודקים את הסטטוס של הפעולה הממושכת ליצירת הסרטון.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
- MODEL_ID: מזהה המודל שבו רוצים להשתמש.
- OPERATION_ID: מזהה הפעולה הייחודי שהוחזר בבקשה המקורית ליצירת סרטון.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation
גוף בקשת JSON:
{ "operationName": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID" }כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
הבקשה הזו מחזירה מידע על הפעולה, כולל אם היא עדיין פועלת או שהיא הסתיימה.curl
שומרים את גוף הבקשה בקובץ בשם
request.jsonומריצים את הפקודה הבאה:curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation"PowerShell
שומרים את גוף הבקשה בקובץ בשם
request.jsonומריצים את הפקודה הבאה:$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation" | Select-Object -Expand Content