이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Veo | AI 동영상 생성기

Vertex AI 기반 Veo를 사용하면 Google Cloud 콘솔에서 제공하는 텍스트 프롬프트 또는 이미지 프롬프트에서 새 동영상을 생성하거나 Vertex AI API로 요청을 보낼 수 있습니다.

Vertex AI Media Studio에서 Veo 사용해 보기

Colab에서 Veo 사용해 보기

액세스 요청: 고급 기능 및 Veo 대기자 명단

모델 버전

사용할 수 있는 동영상 생성 모델은 여러 가지가 있습니다. 자세한 내용은 Veo 모델을 참고하세요.

위치

위치는 데이터가 영구 저장되는 위치를 제어하기 위해 요청에서 지정할 수 있는 리전입니다. 사용 가능한 리전 목록은 Vertex AI의 생성형 AI 위치를 참고하세요.

책임감 있는 AI

Veo는 자연어로 된 텍스트 및 이미지 프롬프트(모든 연령대의 사람 이미지 포함)에서 사실적이고 고품질의 동영상을 생성합니다. 텍스트 또는 이미지 프롬프트의 맥락에 따라 Veo에서 사람 또는 아동의 생성을 위해Google Cloud 프로젝트를 승인해야 한다는 오류가 표시될 수 있습니다.

승인이 필요한 경우 Google 계정 담당자에게 문의하세요.

시작하기 전에

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Enable the Vertex AI API.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Enable the Vertex AI API.

Enable the API

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

Select the tab for how you plan to use the samples on this page:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

REST

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

After installing the Google Cloud CLI, initialize it by running the following command:

gcloud init

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

텍스트에서 동영상 생성

설명 텍스트만 입력으로 사용하여 새로운 동영상을 생성할 수 있습니다. 다음 샘플에서는 동영상을 생성하는 기본 안내를 보여줍니다.

콘솔

Google Cloud 콘솔에서 Vertex AI Studio > Media Studio 페이지로 이동합니다.

Media Studio
동영상을 클릭합니다.
선택사항: 설정 창에서 다음 설정을 구성합니다.
- 모델: 사용 가능한 옵션 중에서 모델을 선택합니다.
- 가로세로 비율: 16:9 또는 9:16을 선택합니다.
  
  참고: veo-3.0-generate-preview에서는 9:16 가로세로 비율을 지원하지 않습니다.
- 결과 수: 슬라이더를 조정하거나 1~4 사이의 값을 입력합니다.
- 동영상 길이: 길이를 5초~8초 중에서 선택합니다.
- 출력 디렉터리: 찾아보기를 클릭하여 출력 파일을 저장할 Cloud Storage 버킷을 만들거나 선택합니다.
선택사항: 안전 섹션에서 다음 인물 생성 설정 중 하나를 선택합니다.
- 허용(성인만 해당): 기본값입니다. 성인이나 성인 얼굴만 생성합니다. 청소년 또는 아동이나 청소년 또는 아동의 인물을 생성하지 마세요.
- 허용 안함: 사람이나 얼굴을 생성하지 않습니다.
선택사항: 동영상을 무작위로 생성하려면 고급 옵션 섹션에서 시드 값을 입력합니다.
프롬프트 작성 상자에 생성할 동영상을 설명하는 텍스트 프롬프트를 입력합니다.
생성을 클릭합니다.

REST

환경을 설정하면 REST를 사용하여 텍스트 프롬프트를 테스트할 수 있습니다. 다음 샘플은 요청을 게시자 모델 엔드포인트에 전송합니다.

Veo API에 대한 자세한 내용은 Vertex AI 기반 Veo API를 참조하세요.

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

요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
- MODEL_ID: 사용할 모델 ID. 사용 가능한 값은 다음과 같습니다.
  - veo-2.0-generate-001(정식 버전)
  - veo-3.0-generate-preview(미리보기)
- TEXT_PROMPT: 동영상 생성을 안내하는 데 사용되는 텍스트 프롬프트
- OUTPUT_STORAGE_URI: (선택사항) 출력 동영상을 저장할 Cloud Storage 버킷. 제공하지 않으면 응답으로 동영상 바이트가 반환됩니다. 예를 들면 gs://video-bucket/output/입니다.
- RESPONSE_COUNT: 생성할 동영상 파일의 수. 허용되는 정수 값은 1~4입니다.
- DURATION: 생성할 동영상 파일의 길이. 허용되는 정수 값은 5~8입니다.
- 추가 선택적 파라미터
  
  사용 사례에 따라 다음 선택적 변수를 사용하세요. "parameters": {} 객체에 다음 파라미터 중 일부 또는 전부를 추가합니다.
```
"parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO: 문자열입니다. (선택사항) 생성된 동영상의 가로세로 비율을 정의합니다. 값은 16:9(기본값, 가로) 또는 9:16(세로)입니다.
  - NEGATIVE_PROMPT: 문자열입니다. (선택사항) 모델에서 생성하지 않게 하려는 항목을 설명하는 텍스트 문자열입니다.
  - PERSON_SAFETY_SETTING: 문자열입니다. (선택사항) 사람 또는 얼굴 생성 허용 여부를 제어하는 안전 설정입니다. 값은 다음과 같습니다.
    - allow_adult(기본값): 성인만 생성합니다.
    - disallow: 이미지에 사람이나 얼굴을 포함하지 않습니다.
  - 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"
    }
  ],
  "parameters": {
    "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"
}
```

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

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

PROJECT_ID: Google Cloud 프로젝트 ID
MODEL_ID: 사용할 모델 ID. 사용 가능한 값은 다음과 같습니다.
- veo-2.0-generate-001(정식 버전)
- veo-3.0-generate-preview(미리보기)
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": {
    "@type": "type.googleapis.com/cloud.ai.large_models.vision.GenerateVideoResponse",
    "videos": [
      {
        "gcsUri":"gs://BUCKET_NAME/TIMESTAMPED_FOLDER/sample_0.mp4",
        "mimeType": "video/mp4"
      }
    ]
  }
}

Gen AI SDK for Python

설치

pip install --upgrade google-genai

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

Vertex AI에서 Gen 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_VERTEXAI=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-3.0-generate-preview",
    prompt="a cat reading a book",
    config=GenerateVideosConfig(
        aspect_ratio="16:9",
        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

이미지에서 동영상 생성

샘플 입력	샘플 출력
입력 이미지¹ 텍스트 프롬프트: 코끼리가 자연스럽게 움직인다

¹ 사바나를 걷고 있는 복잡한 패턴의 크로셰 코끼리 프롬프트로 Vertex AI 기반 Imagen을 사용하여 생성한 이미지

이미지만 입력으로 사용하거나 이미지와 설명 텍스트를 입력으로 사용하여 새로운 동영상을 생성할 수 있습니다. 다음 샘플에서는 이미지와 텍스트로 동영상을 생성하는 기본 안내를 보여줍니다.

콘솔

Google Cloud 콘솔에서 Vertex AI Studio > Media Studio 페이지로 이동합니다.

Media Studio
동영상을 클릭합니다.
선택사항: 설정 창에서 다음 설정을 구성합니다.
- 모델: 사용 가능한 옵션 중에서 모델을 선택합니다.
- 가로세로 비율: 16:9 또는 9:16을 선택합니다.
  
  참고: veo-3.0-generate-preview에서는 9:16 가로세로 비율을 지원하지 않습니다.
- 결과 수: 슬라이더를 조정하거나 1~4 사이의 값을 입력합니다.
- 동영상 길이: 길이를 5초~8초 중에서 선택합니다.
- 출력 디렉터리: 찾아보기를 클릭하여 출력 파일을 저장할 Cloud Storage 버킷을 만들거나 선택합니다.
선택사항: 안전 섹션에서 다음 인물 생성 설정 중 하나를 선택합니다.
- 허용(성인만 해당): 기본값입니다. 성인이나 성인 얼굴만 생성합니다. 청소년 또는 아동이나 청소년 또는 아동의 인물을 생성하지 마세요.
- 허용 안함: 사람이나 얼굴을 생성하지 않습니다.
선택사항: 동영상을 무작위로 생성하려면 고급 옵션 섹션에서 시드 값을 입력합니다.
프롬프트 작성 상자에서 업로드를 클릭합니다.
업로드할 로컬 이미지를 선택하고 선택을 클릭합니다.
프롬프트 작성 상자에 생성할 동영상을 설명하는 텍스트 프롬프트를 입력합니다.
생성을 클릭합니다.

REST

환경을 설정하면 REST를 사용하여 텍스트 프롬프트를 테스트할 수 있습니다. 다음 샘플은 요청을 게시자 모델 엔드포인트에 전송합니다.

Veo API에 대한 자세한 내용은 Vertex AI 기반 Veo API를 참조하세요.

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

요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
- MODEL_ID: 사용할 모델 ID. 사용 가능한 값은 다음과 같습니다.
  - veo-2.0-generate-001(정식 버전)
  - veo-3.0-generate-preview(미리보기)
- TEXT_PROMPT: 동영상 생성을 안내하는 데 사용되는 텍스트 프롬프트
- INPUT_IMAGE: 입력 이미지를 나타내는 base64로 인코딩된 바이트 문자열입니다. 품질을 보장하려면 입력 이미지가 720p 이상(1280x720픽셀)이고 가로세로 비율이 16:9 또는 9:16이어야 합니다. 업로드 중에 가로세로 비율이나 크기가 다른 이미지는 조절되거나 중앙에서 잘릴 수 있습니다.
- MIME_TYPE: 입력 이미지의 MIME 유형입니다. image/jpeg 또는 image/png MIME 유형의 이미지만 지원됩니다.
- OUTPUT_STORAGE_URI: (선택사항) 출력 동영상을 저장할 Cloud Storage 버킷. 제공하지 않으면 응답으로 동영상 바이트가 반환됩니다. 예를 들면 gs://video-bucket/output/입니다.
- RESPONSE_COUNT: 생성할 동영상 파일의 수. 허용되는 정수 값은 1~4입니다.
- DURATION: 생성할 동영상 파일의 길이. 허용되는 정수 값은 5~8입니다.
- 추가 선택적 파라미터
  
  사용 사례에 따라 다음 선택적 변수를 사용하세요. "parameters": {} 객체에 다음 파라미터 중 일부 또는 전부를 추가합니다.
```
"parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO: 문자열입니다. (선택사항) 생성된 동영상의 가로세로 비율을 정의합니다. 값은 16:9(기본값, 가로) 또는 9:16(세로)입니다.
  - NEGATIVE_PROMPT: 문자열입니다. (선택사항) 모델에서 생성하지 않게 하려는 항목을 설명하는 텍스트 문자열입니다.
  - PERSON_SAFETY_SETTING: 문자열입니다. (선택사항) 사람 또는 얼굴 생성 허용 여부를 제어하는 안전 설정입니다. 값은 다음과 같습니다.
    - allow_adult(기본값): 성인만 생성합니다.
    - disallow: 이미지에 사람이나 얼굴을 포함하지 않습니다.
  - 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",
      "image": {
        "bytesBase64Encoded": "INPUT_IMAGE",
        "mimeType": "MIME_TYPE"
      }
    }
  ],
  "parameters": {
    "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"
}
```
(선택사항) 동영상 생성 장기 실행 작업의 상태를 확인합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
- MODEL_ID: 사용할 모델 ID. 사용 가능한 값은 다음과 같습니다.
  - veo-2.0-generate-001
- TEXT_PROMPT: 동영상 생성을 안내하는 데 사용되는 텍스트 프롬프트
- 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",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO: 문자열입니다. (선택사항) 생성된 동영상의 가로세로 비율을 정의합니다. 값은 16:9(기본값, 가로) 또는 9:16(세로)입니다.
  - NEGATIVE_PROMPT: 문자열입니다. (선택사항) 모델에서 생성하지 않게 하려는 항목을 설명하는 텍스트 문자열입니다.
  - PERSON_SAFETY_SETTING: 문자열입니다. (선택사항) 사람 또는 얼굴 생성 허용 여부를 제어하는 안전 설정입니다. 값은 다음과 같습니다.
    - allow_adult(기본값): 성인만 생성합니다.
    - disallow: 이미지에 사람이나 얼굴을 포함하지 않습니다.
  - 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"
    }
  ],
  "parameters": {
    "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"
}
```

Gen AI SDK for Python

설치

pip install --upgrade google-genai

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

Vertex AI에서 Gen 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_VERTEXAI=True

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

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.0-generate-preview",
    image=Image(
        gcs_uri="gs://cloud-samples-data/generative-ai/image/flowers.png",
        mime_type="image/png",
    ),
    config=GenerateVideosConfig(
        aspect_ratio="16:9",
        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

프롬프트 리라이터

Veo는 프롬프트 수정 도구라고도 하는 LLM 기반 프롬프트 개선 도구를 제공합니다. 프롬프트 재작성 도구는 프롬프트를 재작성하여 동영상 설명, 카메라 모션, 스크립트, 음향 효과를 프롬프트에 추가하는 옵션을 제공합니다. 프롬프트가 더 구체적일수록 동영상 품질이 높아집니다.

프롬프트 개선을 사용 중지하면 동영상 품질과 출력의 프롬프트 유사성이 영향을 받을 수 있습니다. 이 기능은 다음 모델 버전에서 기본적으로 사용 설정되어 있습니다.

veo-2.0-generate-001
veo-3.0-generate-preview (미리보기)

중요: veo-3.0-generate-preview를 사용하는 경우 프롬프트 리라이터를 사용 중지할 수 없습니다.

수정된 프롬프트는 원래 프롬프트의 길이가 30단어 미만인 경우에만 API 응답을 통해 제공됩니다.

프롬프트 개선 기능을 사용 중지하려면 다음 단계를 따르세요.

콘솔

Google Cloud 콘솔에서 Vertex AI Studio > Media Studio 페이지로 이동합니다.

Media Studio로 이동
Veo를 클릭합니다.
설정에서 프롬프트 개선 사용 설정 전환 버튼을 클릭합니다.
프롬프트 작성 상자에 프롬프트를 입력한 다음 생성을 클릭합니다.

REST

Veo API에 대한 자세한 내용은 Vertex AI 기반 Veo API를 참조하세요.

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

요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
- MODEL_ID: 사용할 모델 ID. 사용 가능한 값은 다음과 같습니다.
  - veo-2.0-generate-001(정식 버전 허용 목록)
  - veo-3.0-generate-preview(미리보기)
- 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",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO: 문자열입니다. (선택사항) 생성된 동영상의 가로세로 비율을 정의합니다. 값은 16:9(기본값, 가로) 또는 9:16(세로)입니다.
  - NEGATIVE_PROMPT: 문자열입니다. (선택사항) 모델에서 생성하지 않게 하려는 항목을 설명하는 텍스트 문자열입니다.
  - PERSON_SAFETY_SETTING: 문자열입니다. (선택사항) 사람 또는 얼굴 생성 허용 여부를 제어하는 안전 설정입니다. 값은 다음과 같습니다.
    - allow_adult(기본값): 성인만 생성합니다.
    - disallow: 이미지에 사람이나 얼굴을 포함하지 않습니다.
  - 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"
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": "RESPONSE_COUNT",
    "durationSeconds": "DURATION",
    "enhancePrompt": ENHANCED_PROMPT
  }
}
```
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
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"
}
```

다음 단계

Google DeepMind의 Veo 모델에 관한 정보 읽어보기
'Veo 및 Imagen 3: Vertex AI의 새로운 동영상 및 이미지 생성 모델 발표' 블로그 게시물 읽어보기
'크리에이터를 위해 제작된 새로운 생성형 미디어 모델 및 도구' 블로그 게시물 읽어보기

Veo | AI 동영상 생성기 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

모델 버전

위치

책임감 있는 AI

시작하기 전에

Console

REST

텍스트에서 동영상 생성

콘솔

REST

curl

PowerShell

curl

PowerShell

응답

Gen AI SDK for Python

설치

이미지에서 동영상 생성

콘솔

REST

curl

PowerShell

curl

PowerShell

Gen AI SDK for Python

설치

프롬프트 리라이터

콘솔

REST

curl

PowerShell

다음 단계

Veo | AI 동영상 생성기