השבתה של Veo בכלי לשכתוב הנחיות ב-Gemini Enterprise Agent Platform

המסוף

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

   מעבר ל-Media Studio

2. לוחצים על Veo.

3. בהגדרות, לוחצים על החלפת מצב של ההגדרה 'הפעלת שיפור ההנחיות'.

4. בתיבה כתיבת הנחיה, מזינים את ההנחיה ולוחצים על send יצירה.

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

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-2.0-generate-001",
    prompt="a cat reading a book",
    config=GenerateVideosConfig(
        aspect_ratio="16:9",
        output_gcs_uri=output_gcs_uri,
        number_of_videos=1,
        duration_seconds=5,
        person_generation="dont_allow",
        enhance_prompt=False,
    ),
)

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: מזהה המודל שבו רוצים להשתמש. ערכים זמינים:
  • veo-2.0-generate-001
• ‫TEXT_PROMPT: הנחייה טקסטואלית שמשמשת להנחיית יצירת סרטונים.
• ‫OUTPUT_STORAGE_URI: אופציונלי: קטגוריה של Cloud Storage לאחסון סרטוני הפלט. אם לא מציינים קטגוריה, בייטים של סרטונים מוחזרים בתגובה. לדוגמה: gs://video-bucket/output/.
• ‫RESPONSE_COUNT: מספר קובצי הווידאו שרוצים ליצור. ערכים קבילים מסוג מספר שלם: 1-4.
• ‫DURATION: אורך קובצי הווידאו שרוצים ליצור. הערכים הקבילים הם מספרים שלמים מ-5 עד 8.
• ‫ENHANCED_PROMPT: האם להשתמש בהנחיות משופרות או לא. אפשר להשתמש באחת מהאפשרויות הבאות:
  • ‫True: (ברירת מחדל) שימוש ב-Gemini כדי לשפר את ההנחיות.
  • ‫False: אל תשתמשו ב-Gemini כדי לשפר את ההנחיות.

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

  אפשר להשתמש במשתנים האופציונליים הבאים בהתאם לתרחיש השימוש. מוסיפים חלק מהפרמטרים הבאים או את כולם לאובייקט "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"
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": "RESPONSE_COUNT",
    "durationSeconds": "DURATION",
    "enhancePrompt": ENHANCED_PROMPT
  }
}

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

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"

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