איך יוצרים סרטונים באמצעות תמונות של נכסים וסגנונות

REST

מידע נוסף על השימוש ב-Gemini Omni Flash API זמין במאמר בנושא Interactions API.

יצירת הסרטון יכולה להימשך יותר מדקה. כדי ליצור סרטון שאפשר להוריד מיד אחרי שהוא מוכן, צריך להשתמש בבקשה סינכרונית. כדי ליצור סרטון שאפשר להוריד אותו מאוחר יותר, שולחים בקשה אסינכרונית על ידי הגדרת הפרמטר background לערך true. אינטראקציות אסינכרוניות נשמרות למשך עד 14 ימים.

POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions

{
  "model": "MODEL_ID",
  "input": [
    {
      "type": "text",
      "text": "TEXT_PROMPT"
    },
    {
      "type": "image",
      "uri": "CLOUD_STORAGE_INPUT_URI",
      "mime_type": "image/png"
    }
  ],
  "response_format": [
    {
      "type": "video",
      "delivery": "uri",
      "gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
      "aspect_ratio": "ASPECT_RATIO",
      "duration": "DURATION"
    }
  ],
  "generation_config": {
    "video_config": {
      "task": "reference_to_video"
    }
  }
}

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"

$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-flash-preview",
  "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",
}

POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions

{
  "model": "MODEL_ID",
  "input": [
    {
      "background": true,
      "type": "text",
      "text": "TEXT_PROMPT"
    },
    {
      "type": "image",
      "uri": "CLOUD_STORAGE_INPUT_URI",
      "mime_type": "image/png"
    }
  ],
  "response_format": [
    {
      "type": "video",
      "delivery": "uri",
      "gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
      "aspect_ratio": "ASPECT_RATIO",
      "duration": "DURATION"
    }
  ],
  "generation_config": {
    "video_config": {
      "task": "reference_to_video"
    }
  }
}

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"

$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"
}

POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID

curl -X POST \
     -H "Authorization: Bearer TOKEN" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID"

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method POST `
    -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-flash-preview",
  "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": "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",
          "data":"VIDEO DATA",
          "mime_type":"video/mp4" 
        }
      ]
    }
  ],
  "object":"interaction"
  "role":"model",
  "created":"2026-05-29T02:17:56Z",
  "updated":"2026-05-29T02:17:56Z",
}

המסוף

1. במסוף Cloud de Confiance , נכנסים לדף Agent Platform > Agent Platform Studio .

   מעבר אל Agent Platform Studio

2. לוחצים על יצירת מדיה.

3. לוחצים על סרטון.

4. בתפריט משימה, בוחרים באפשרות הפניה לסרטון (נושא).

5. בתפריט Model (מודל), בוחרים מודל מבין האפשרויות הזמינות.

6. בקטע תמונות של הנושא, לוחצים על הוספה.

   מוצגת תיבת דו-שיח לבחירת קובץ. בוחרים תמונה אחת עד שלוש תמונות במחשב להעלאה.

7. אופציונלי: בקטע פרמטרים, משנים את ההגדרות הבאות:

   • יחס גובה-רוחב: בוחרים באפשרות 16:9 או 9:16.
   • מספר התוצאות: מזיזים את פס ההזזה או מזינים ערך בין 1 ל-4.
   • משך הסרטון: בוחרים באפשרות 8, 6 או 4 שניות.
   • רזולוציית הפלט: בוחרים אחת מהאפשרויות הבאות:
     • ‫720p
     • 1080p
     • 4k

8. אופציונלי: בקטע בטיחות, בוחרים אחת מההגדרות הבאות של יצירת אנשים:

   • מותר (למבוגרים בלבד): ערך ברירת המחדל. יצירת תמונות של אנשים או פנים של מבוגרים בלבד. אל תיצרו תמונות של צעירים, ילדים או פנים.

   • אין הרשאה: לא ייווצרו אנשים או פנים.

9. אופציונלי: בקטע אפשרויות מתקדמות, מזינים ערך Seed כדי ליצור סרטון באופן אקראי.

10. בתיבה הנחיה, כותבים הנחיית טקסט שמתארת את הסרטונים שרוצים ליצור.

11. לוחצים על 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

import time
from google import genai
from google.genai.types import GenerateVideosConfig, Image, VideoGenerationReferenceImage

client = genai.Client()

# TODO(developer): Update and un-comment below line
# output_gcs_uri = "gs://your-bucket/your-prefix"

operation = client.models.generate_videos(
    model="veo-3.1-generate-preview",
    prompt="A person walks in carrying a vase full of flowers and places the vase on a kitchen table.",
    config=GenerateVideosConfig(
        reference_images=[
            VideoGenerationReferenceImage(
                image=Image(
                    gcs_uri="gs://cloud-samples-data/generative-ai/image/vase.png",
                    mime_type="image/png",
                ),
                reference_type="asset",
            ),
        ],
        aspect_ratio="9:16",
        output_gcs_uri=output_gcs_uri,
    ),
)

while not operation.done:
    time.sleep(15)
    operation = client.operations.get(operation)
    print(operation)

if operation.response:
    print(operation.result.generated_videos[0].video.uri)

# Example response:
# gs://your-bucket/your-prefix

REST

מידע נוסף על Veo API:

• Method: endpoints.predict
• VideoGenerationModelInstance
• VideoGenerationModelParams
• VideoGenerationModelResult

1. משתמשים בפקודות הבאות כדי לשלוח בקשה ליצירת סרטון. הבקשה הזו מתחילה פעולה ממושכת ומאחסנת את הפלט בקטגוריה של Cloud Storage שאתם מציינים.

   לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

   • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
   • ‫MODEL_ID: מחרוזת שמייצגת את מזהה המודל לשימוש. המודלים הנתמכים:
     <0x0
   • ‫TEXT_PROMPT: הנחייה טקסטואלית שמשמשת להנחיית יצירת סרטונים.
   • BASE64_ENCODED_IMAGE: תמונה של הנושא בקידוד base64. אפשר לחזור על השדה הזה ועל mimeType כדי לציין עד שלוש תמונות של הנושא.

   • ‫IMAGE_MIME_TYPE: סוג ה-MIME של תמונת הקלט. רק אחת מהאפשרויות הבאות:

     • image/jpeg
     • image/png

     אפשר לחזור על השדה הזה ועל bytesBase64Encoded כדי לציין עד שלוש תמונות של הנושא.

   • ‫ASPECT_RATIO: אופציונלי: יחס הגובה-רוחב של הסרטון שנוצר. רק אחת מהאפשרויות הבאות:

     • "16:9"
     • "9:16"

     ערך ברירת המחדל הוא "16:9".

   • ‫OUTPUT_STORAGE_URI: אופציונלי: הקטגוריה של Cloud Storage שבה יישמרו סרטוני הפלט. אם לא צוין, בתגובה יוחזר סרטון בקידוד Base64-bytes. לדוגמה: gs://video-bucket/output/.
   • ‫RESPONSE_COUNT: מספר קובצי הווידאו שרוצים ליצור. ערכים קבילים מסוג מספר שלם: 1-4.

   • VIDEO_RESOLUTION: אופציונלי: הרזולוציה של הסרטון שנוצר. רק אחת מהאפשרויות הבאות:

     • "720p"
     • "1080p"
     • ‫"4k" (מודלים של Veo 3.1 בגרסת טרום-השקה בלבד)

     ערך ברירת המחדל הוא "720p".

   • פרמטרים אופציונליים נוספים

     אפשר להשתמש במשתנים האופציונליים הבאים בהתאם לתרחיש השימוש. מוסיפים חלק מהפרמטרים הבאים או את כולם לאובייקט "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 בגרסת טרום-השקה בלבד)

       ערך ברירת המחדל הוא "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",
         // The following fields can be repeated for up to three total
         // images.
         "referenceImages": [
           {
             "image": {
               "bytesBase64Encoded": "BASE64_ENCODED_IMAGE",
               "mimeType": "IMAGE_MIME_TYPE"
             },
             "referenceType": "asset"
           }
         ]
       }
     ],
     "parameters": {
       "aspectRatio":, "ASPECT_RATIO,
       "durationSeconds": 8,
       "storageUri": "OUTPUT_STORAGE_URI",
       "sampleCount": RESPONSE_COUNT,
       "resolution": "VIDEO_RESOLUTION
     }
   }
   

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

   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"
   }
   

2. אופציונלי: בודקים את הסטטוס של הפעולה הממושכת ליצירת הסרטון.

   לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

   • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
   • ‫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

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

   תשובה

   {
     "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID",
     "done": true,
     "response": {
       "raiMediaFilteredCount": 0,
       "@type": "type.googleapis.com/cloud.ai.large_models.vision.GenerateVideoResponse",
       "videos": [
         {
           "gcsUri":"gs://BUCKET_NAME/TIMESTAMPED_FOLDER/sample_0.mp4",
           "mimeType": "video/mp4"
         }
       ]
     }
   }
   

המסוף

1. במסוף Cloud de Confiance , נכנסים לדף Agent Platform > Agent Platform Studio .

   מעבר אל Agent Platform Studio

2. לוחצים על יצירת מדיה.

3. לוחצים על סרטון.

4. בתפריט משימה, בוחרים באפשרות הפניה לסרטון (סגנון).

5. בתפריט Model (מודל), בוחרים מודל מבין האפשרויות הזמינות.

6. בקטע תמונה של סגנון, לוחצים על הוספה.

   מוצגת תיבת דו-שיח לבחירת קובץ. בוחרים תמונה במחשב כדי להעלות אותה.

7. אופציונלי: בקטע פרמטרים, משנים את ההגדרות הבאות:

   • יחס גובה-רוחב: בוחרים באפשרות 16:9 או 9:16.
   • מספר התוצאות: מזיזים את פס ההזזה או מזינים ערך בין 1 ל-4.
   • משך הסרטון: בוחרים באפשרות 8, 7, 6 או 5 שניות.

8. אופציונלי: בקטע בטיחות, בוחרים אחת מההגדרות הבאות של יצירת אנשים:

   • מותר (למבוגרים בלבד): ערך ברירת המחדל. יצירת תמונות של אנשים או פנים של מבוגרים בלבד. אל תיצרו תמונות של צעירים, ילדים או פנים.

   • אין הרשאה: לא ייווצרו אנשים או פנים.

9. אופציונלי: בקטע אפשרויות מתקדמות, מזינים ערך Seed כדי ליצור סרטון באופן אקראי.

10. בתיבה הנחיה, כותבים הנחיית טקסט שמתארת את הסרטונים שרוצים ליצור.

11. לוחצים על Run.

REST

מידע נוסף על Veo API זמין במאמר בנושא Veo on Gemini Enterprise Agent Platform API.

1. משתמשים בפקודות הבאות כדי לשלוח בקשה ליצירת סרטון. הבקשה הזו מתחילה פעולה ממושכת ומאחסנת את הפלט בקטגוריה של Cloud Storage שאתם מציינים.

   לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

   • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .

   • ‫MODEL_ID: מחרוזת שמייצגת את מזהה המודל לשימוש. המודלים הבאים נתמכים:

   • ‫TEXT_PROMPT: הנחייה טקסטואלית שמשמשת להנחיית יצירת סרטונים.
   • ‫BASE64_ENCODED_IMAGE: תמונה של סגנון בקידוד base64.
   • ‫IMAGE_MIME_TYPE: סוג ה-MIME של תמונת הקלט. אחת מהאפשרויות הבאות בלבד:
     • image/jpeg
     • image/png
   • ‫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 בגרסת טרום-השקה בלבד)

       ערך ברירת המחדל הוא "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",
         "referenceImages": [
           {
             "image": {
               "bytesBase64Encoded": "BASE64_ENCODED_IMAGE",
               "mimeType": "IMAGE_MIME_TYPE"
             },
             "referenceType": "style"
           }
         ]
       }
     ],
     "parameters": {
       "durationSeconds": 8,
       "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"
   }
   

2. אופציונלי: בודקים את הסטטוס של הפעולה הממושכת ליצירת הסרטון.

   לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

   • ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
   • ‫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

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

   תשובה

   {
     "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID",
     "done": true,
     "response": {
       "raiMediaFilteredCount": 0,
       "@type": "type.googleapis.com/cloud.ai.large_models.vision.GenerateVideoResponse",
       "videos": [
         {
           "gcsUri":"gs://BUCKET_NAME/TIMESTAMPED_FOLDER/sample_0.mp4",
           "mimeType": "video/mp4"
         }
       ]
     }
   }