애셋 및 스타일 이미지를 사용하여 동영상 생성 안내

Gemini Enterprise Agent Platform에서 Gemini Omni Flash 또는 Veo를 사용하여 참조 이미지를 통해 동영상 생성을 안내할 수 있습니다.

Gemini Omni Flash

Gemini Omni Flash를 사용하면 동영상을 생성할 때 참조 이미지를 사용하여 모델에 추가 입력을 제공할 수 있습니다. 다음 Gemini Omni Flash 모델은 참조 이미지를 지원합니다.

클릭하여 지원되는 모델 펼치기

• gemini-omni-flash-preview 미리보기

Veo

Gemini Enterprise Agent Platform의 Veo를 사용하면 참조 이미지를 활용하여 생성되는 동영상의 콘텐츠와 예술적 스타일을 제어할 수 있습니다. Veo에서 참조 이미지를 사용할 때는 다음 중 하나를 선택할 수 있습니다.

• 주제 이미지: 단일 인물, 캐릭터 또는 제품의 이미지를 최대 3개까지 제공합니다. Veo는 출력 동영상에서 해당 대상의 외형을 유지합니다.

  다음 모델은 참조 애셋 이미지-동영상을 지원합니다.

  클릭하여 지원되는 모델 펼치기

  • veo-2.0-generate-001
  • veo-2.0-generate-exp 미리보기
  • veo-2.0-generate-preview 미리보기
  • veo-3.1-generate-preview 미리보기
  • veo-3.1-fast-generate-preview 미리보기
  • veo-3.1-generate-001
  • veo-3.1-fast-generate-001

• 스타일 이미지: 단일 스타일 이미지를 제공합니다. Veo는 업로드된 이미지의 스타일을 출력 동영상에 적용합니다.

  다음 모델은 참조 스타일 이미지-동영상을 지원합니다.

  클릭하여 지원되는 모델 펼치기

  • veo-2.0-generate-001
  • veo-2.0-generate-exp 미리보기
  • veo-2.0-generate-preview 미리보기

동영상 생성에 효과적인 텍스트 프롬프트 작성에 대한 자세한 내용은 동영상 생성 프롬프트 가이드를 참고하세요.

Colab에서 Gemini Omni Flash 사용해 보기

Colab에서 Veo 사용해 보기

시작하기 전에

Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $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 the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Enable the Agent Platform API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. 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.

Enable the API

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 the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Enable the Agent Platform API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. 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.

Enable the API

1. 환경에 대한 인증을 설정하세요.

   이 페이지의 샘플 사용 방법에 대한 탭을 선택하세요.

   콘솔

   Google Cloud 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스하는 경우 인증을 설정할 필요가 없습니다.

   Python

   로컬 개발 환경에서 이 페이지의 Python 샘플을 사용하려면 gcloud CLI를 설치하고 초기화한 후 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정합니다.

   1. Google Cloud CLI를 설치합니다.

   2. 외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

   3. 로컬 셸을 사용하는 경우 사용자 계정에 대한 로컬 인증 사용자 인증 정보를 만듭니다.

      gcloud auth application-default login

      Cloud Shell을 사용하는 경우 이 작업을 수행할 필요는 없습니다.

      인증 오류가 반환되고 외부 ID 공급업체(IdP)를 사용하는 경우 제휴 ID로 gcloud CLI에 로그인했는지 확인합니다.

   자세한 내용은 Google Cloud 인증 문서의 로컬 개발 환경의 ADC 설정을 참고하세요.

   REST

   로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.

   Google Cloud CLI를 설치합니다.

   외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

   자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

Gemini Omni Flash 및 참조를 사용하여 동영상 생성

REST

Gemini Omni Flash API 사용에 대한 자세한 내용은 Interactions API를 참고하세요.

동영상 생성에 1분 이상 걸릴 수 있습니다. 완료 후 즉시 다운로드할 동영상을 생성하려면 동기 요청을 사용하세요. 나중에 다운로드할 수 있는 동영상을 생성하려면 background 매개변수를 true로 설정하여 비동기 요청을 전송합니다. 비동기 상호작용은 최대 14일 동안 보관됩니다.

동기식 요청

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: Google Cloud 프로젝트 ID를 나타내는 문자열입니다.
• MODEL_ID: 사용할 모델 ID를 나타내는 문자열입니다. 허용되는 값은 다음과 같습니다.
  • "gemini-omni-flash-preview"
• TEXT_PROMPT: 동영상 생성을 안내하는 데 사용되는 텍스트 프롬프트입니다.
• CLOUD_STORAGE_INPUT_URI: 입력 미디어가 포함된 Cloud Storage 버킷을 나타내는 문자열입니다. 예를 들면 "gs://video-bucket/input/"입니다.
• CLOUD_STORAGE_OUTPUT_URI: 선택사항: 출력 동영상을 저장할 Cloud Storage 버킷을 나타내는 문자열입니다. 제공하지 않으면 응답으로 동영상 바이트가 반환됩니다. 예를 들면 "gs://video-bucket/output/"입니다.
• ASPECT_RATIO: (선택사항) 출력 동영상의 예상 가로세로 비율을 나타내는 문자열입니다. 제공되지 않으면 가로세로 비율이 프롬프트에서 추론됩니다. 허용되는 값은 다음과 같습니다.
  • "16:9"
  • "9:16"
• DURATION: 생성된 동영상 파일의 길이를 나타내는 문자열입니다. 허용되는 문자열은 3~10 사이의 정수 뒤에 초를 나타내는 's'가 붙은 것입니다. 예를 들어 "10s'

HTTP 메서드 및 URL:

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

JSON 요청 본문:

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

요청 본문을 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-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",
}

비동기 요청

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: Google Cloud 프로젝트 ID를 나타내는 문자열입니다.
• MODEL_ID: 사용할 모델 ID를 나타내는 문자열입니다. 허용되는 값은 다음과 같습니다.
  • "gemini-omni-flash-preview"
• TEXT_PROMPT: 동영상 생성을 안내하는 데 사용되는 텍스트 프롬프트입니다.
• CLOUD_STORAGE_INPUT_URI: 입력 미디어가 포함된 Cloud Storage 버킷을 나타내는 문자열입니다. 예를 들면 "gs://video-bucket/input/"입니다.
• CLOUD_STORAGE_OUTPUT_URI: 선택사항: 출력 동영상을 저장할 Cloud Storage 버킷을 나타내는 문자열입니다. 제공하지 않으면 응답으로 동영상 바이트가 반환됩니다. 예를 들면 "gs://video-bucket/output/"입니다.
• ASPECT_RATIO: (선택사항) 출력 동영상의 예상 가로세로 비율을 나타내는 문자열입니다. 제공되지 않으면 가로세로 비율이 프롬프트에서 추론됩니다. 허용되는 값은 다음과 같습니다.
  • "16:9"
  • "9:16"
• DURATION: 생성된 동영상 파일의 길이를 나타내는 문자열입니다. 허용되는 문자열은 3~10 사이의 정수 뒤에 초를 나타내는 's'가 붙은 것입니다. 예를 들어 "10s'

HTTP 메서드 및 URL:

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

JSON 요청 본문:

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

요청 본문을 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가 포함됩니다.

{
  "id":"INTERACTION_ID",
  "status":"in_progress",
  "object":"interaction"
}

나중에 INTERACTION_ID를 사용하여 생성된 동영상을 가져옵니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: Google Cloud 프로젝트 ID를 나타내는 문자열
• INTERACTION_ID: 비동기 요청의 상호작용 ID입니다.

HTTP 메서드 및 URL:

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

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

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"

PowerShell

다음 명령어를 실행합니다.

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

Veo 및 참조를 사용하여 동영상 생성

다음 섹션에서는 Veo를 사용하여 참조에서 동영상을 생성하는 방법을 설명합니다.

애셋 이미지를 사용하여 동영상 생성

다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 Agent Platform > Agent Platform Studio 페이지로 이동합니다.

   Agent Platform Studio로 이동

2. 미디어 생성을 클릭합니다.

3. 동영상을 클릭합니다.

4. 작업 메뉴에서 동영상 참조 (주제)를 선택합니다.

5. 모델 메뉴에서 사용 가능한 옵션 중에서 모델을 선택합니다.

   참고: veo-3.1-generate-preview은 피사체 이미지를 사용할 때 8초 길이의 동영상만 반환합니다.

6. 주제 이미지 섹션에서 추가를 클릭합니다.

   파일 선택 대화상자가 표시됩니다. 컴퓨터에서 업로드할 이미지를 1~3개 선택합니다.

7. 선택사항: 파라미터 섹션에서 다음 설정을 조정합니다.

   • 가로세로 비율: 16:9 또는 9:16을 선택합니다.
   • 결과 수: 슬라이더를 조정하거나 1~4 사이의 값을 입력합니다.
   • 동영상 길이: 8, 6 또는 4초를 선택합니다.
   • 출력 해상도: 다음 중 하나를 선택합니다.
     • 720p
     • 1080p
     • 4k

8. 선택사항: 안전 섹션에서 다음 인물 생성 설정 중 하나를 선택합니다.

   • 허용(성인만 해당): 기본값입니다. 성인이나 성인 얼굴만 생성합니다. 청소년 또는 아동이나 청소년 또는 아동의 인물을 생성하지 마세요.

   • 허용 안함: 사람이나 얼굴을 생성하지 않습니다.

9. 선택사항: 동영상을 무작위로 생성하려면 고급 옵션 섹션에서 시드 값을 입력합니다.

10. 프롬프트 상자에 생성할 동영상을 설명하는 텍스트 프롬프트를 입력합니다.

11. 실행을 클릭합니다.

Python

설치

pip install --upgrade google-genai

자세한 내용은 SDK 참고 문서를 참고하세요.

Vertex AI에서 Google 생성형 AI SDK를 사용하도록 환경 변수를 설정합니다.

# 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에 대한 자세한 내용은 다음을 참고하세요.

• 메서드: endpoints.predict
• VideoGenerationModelInstance
• VideoGenerationModelParams
• VideoGenerationModelResult

1. 다음 명령어를 사용하여 동영상 생성 요청을 전송합니다. 이 요청은 장기 실행 작업을 시작하고 지정한 Cloud Storage 버킷에 출력을 저장합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • PROJECT_ID: Google Cloud 프로젝트 ID입니다.
   • MODEL_ID: 사용할 모델 ID를 나타내는 문자열입니다. 지원되는 모델은 다음과 같습니다.
     <0x0A
   • TEXT_PROMPT: 동영상 생성을 안내하는 데 사용되는 텍스트 프롬프트입니다.
   • BASE64_ENCODED_IMAGE: base64 바이트로 인코딩된 피사체 이미지입니다. 이 필드와 mimeType을 반복하여 최대 3개의 피사체 이미지를 지정할 수 있습니다.

   • IMAGE_MIME_TYPE: 입력 이미지의 MIME 유형입니다. 다음 중 하나만 사용할 수 있습니다.

     • image/jpeg
     • image/png

     이 필드와 bytesBase64Encoded를 반복하여 최대 3개의 피사체 이미지를 지정할 수 있습니다.

   • ASPECT_RATIO: 선택사항: 생성된 동영상의 가로세로 비율입니다. 다음 중 하나만 사용할 수 있습니다.

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

     기본값은 "16:9"입니다.

   • OUTPUT_STORAGE_URI: (선택사항) 출력 동영상을 저장할 Cloud Storage 버킷. 제공되지 않으면 Base64 바이트로 인코딩된 동영상이 응답으로 반환됩니다. 예를 들면 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입니다.

   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

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   요청 본문을 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

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   요청 본문을 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

   이 요청은 고유한 작업 ID가 포함된 전체 작업 이름을 반환합니다. 이 전체 작업 이름을 사용하여 동영상 생성 요청 상태를 폴링합니다.
   {
     "name":
     "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
   }
   

2. (선택사항) 동영상 생성 장기 실행 작업의 상태를 확인합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • PROJECT_ID: Google Cloud 프로젝트 ID
   • MODEL_ID: 사용할 모델 ID
   • OPERATION_ID: 원래 동영상 생성 요청에 반환된 고유한 작업 ID

   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

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   요청 본문을 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

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   요청 본문을 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. Google Cloud 콘솔에서 Agent Platform > Agent Platform Studio 페이지로 이동합니다.

   Agent Platform Studio로 이동

2. 미디어 생성을 클릭합니다.

3. 동영상을 클릭합니다.

4. 작업 메뉴에서 참조-동영상 (스타일)을 선택합니다.

5. 모델 메뉴에서 사용 가능한 옵션 중에서 모델을 선택합니다.

6. 스타일 이미지 섹션에서 추가를 클릭합니다.

   파일 선택 대화상자가 표시됩니다. 컴퓨터에서 업로드할 이미지를 선택합니다.

7. 선택사항: 파라미터 섹션에서 다음 설정을 조정합니다.

   • 가로세로 비율: 16:9 또는 9:16을 선택합니다.
   • 결과 수: 슬라이더를 조정하거나 1~4 사이의 값을 입력합니다.
   • 동영상 길이: 8, 7, 6 또는 5초를 선택합니다.

8. 선택사항: 안전 섹션에서 다음 인물 생성 설정 중 하나를 선택합니다.

   • 허용(성인만 해당): 기본값입니다. 성인이나 성인 얼굴만 생성합니다. 청소년 또는 아동이나 청소년 또는 아동의 인물을 생성하지 마세요.

   • 허용 안함: 사람이나 얼굴을 생성하지 않습니다.

9. 선택사항: 동영상을 무작위로 생성하려면 고급 옵션 섹션에서 시드 값을 입력합니다.

10. 프롬프트 상자에 생성할 동영상을 설명하는 텍스트 프롬프트를 입력합니다.

11. 실행을 클릭합니다.

REST

Veo API에 대한 자세한 내용은 Gemini Enterprise Agent Platform 기반 Veo API를 참고하세요.

1. 다음 명령어를 사용하여 동영상 생성 요청을 전송합니다. 이 요청은 장기 실행 작업을 시작하고 지정한 Cloud Storage 버킷에 출력을 저장합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • PROJECT_ID: Google Cloud 프로젝트 ID입니다.

   • MODEL_ID: 사용할 모델 ID를 나타내는 문자열입니다. 지원되는 모델은 다음과 같습니다.

     중요: Veo 3.1 모델은 referenceImages.style을 지원하지 않습니다. 스타일 이미지를 사용하는 경우 veo-2.0-generate-exp를 사용하세요.
   • 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입니다.

   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

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   요청 본문을 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

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   요청 본문을 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

   이 요청은 고유한 작업 ID가 포함된 전체 작업 이름을 반환합니다. 이 전체 작업 이름을 사용하여 동영상 생성 요청 상태를 폴링합니다.
   {
     "name":
     "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
   }
   

2. (선택사항) 동영상 생성 장기 실행 작업의 상태를 확인합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • PROJECT_ID: Google Cloud 프로젝트 ID
   • MODEL_ID: 사용할 모델 ID
   • OPERATION_ID: 원래 동영상 생성 요청에 반환된 고유한 작업 ID

   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

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   요청 본문을 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

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   요청 본문을 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"
         }
       ]
     }
   }
   

다음 단계

• 동영상 생성 프롬프트 가이드
• 텍스트에서 동영상 생성
• Gemini Enterprise Agent Platform 기반 Veo에 대한 책임감 있는 AI 및 사용 가이드라인 이해