Gemini Enterprise Agent Platform에서 Gemini Omni 또는 Veo를 사용하여 동영상을 확장할 수 있습니다. Gemini Omni를 사용하면 어떤 길이의 입력 동영상도 제공할 수 있습니다. 모델은 마지막 10초를 사용하여 3~10초 길이의 확장 동영상을 생성하고 이를 입력 동영상의 마지막 30초에 연결합니다(총 출력 길이는 최대 40초). Veo를 사용하면 입력 동영상의 길이는 1~30초여야 하며 7초(총 37초)까지 연장할 수 있습니다. Google Cloud 콘솔 또는 Agent Platform API를 사용하여 동영상을 확장할 수 있습니다.
다음 모델은 동영상 확장을 지원합니다.
Gemini Omni
클릭하여 지원되는 모델 펼치기
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 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 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스하는 경우 인증을 설정할 필요가 없습니다.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
Google Cloud CLI를 설치합니다.
외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.
Veo 제한사항
Veo를 사용하여 동영상을 확장할 때 입력 동영상에는 다음과 같은 제한사항이 적용됩니다.
- 입력 파일은 MP4여야 합니다.
- 길이는 1~30초여야 합니다.
- 프레임 속도는 초당 24프레임이어야 합니다.
- 해상도는 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를 사용하면 input 배열에 최대 2개의 선택적 참고 이미지("type": "image")를 포함하여 확장된 세그먼트를 안내하고, 재현 가능한 결과를 위해 generation_config.seed를 지정하고, 커스텀 메타데이터 라벨(labels)을 연결하여 요청을 구성하고 청구 비용을 추적할 수 있습니다.
REST
동영상 생성은 완료하는 데 1분 이상 걸릴 수 있습니다. 워크플로에 따라 여러 상호작용 모드 중에서 선택할 수 있습니다.
- 동기: 스테이트리스(Stateless): 서버에서 상호작용 상태를 유지하지 않고 단일 요청으로 동영상을 생성하려면
store를false로 설정합니다. - 동기식: 스테이트풀(Stateful):
store를true로 설정하여 상호작용 상태를 유지합니다. 이렇게 하면 나중에 결과를 검색하거나 멀티턴 동영상 편집을 위해 상호작용 ID를 참조할 수 있습니다. - 동기식: 스테이트풀(Stateful) 스트리밍:
store및stream를 모두true로 설정하여 모델 사고가 생성될 때마다 점진적으로 수신한 후 단일step.delta이벤트("type": "video")에서 출력 동영상을 수신합니다. - 비동기:
background를true로 설정하여 백그라운드에서 동영상 생성을 실행하고 나중에 상호작용 ID를 사용하여 결과를 가져옵니다.
저장된 비동기 상호작용은 최대 7일 동안 보관됩니다.
response_format에서 "delivery": "uri"를 구성할 때는 gcs_uri도 지정해야 합니다. "delivery"가 "uri"일 때 gcs_uri를 생략하면 400 INVALID_ARGUMENT 오류가 반환됩니다.
단일 응답은 steps[].content[].uri에서 Cloud Storage URI를 반환하고 스트리밍 응답은 delta.uri에서 반환합니다. 대신 응답에서 동영상 바이트를 인라인으로 반환하려면 "delivery": "inline"를 설정하고 gcs_uri를 생략합니다("delivery"가 "inline"인 경우 gcs_uri는 지원되지 않음). 인라인 전송을 사용하면 동영상 출력이 steps[].content[].data(단항 POST 및 GET) 또는 delta.data(SSE step.delta)의 "mime_type": "video/mp4"와 함께 base64로 인코딩된 바이트 문자열로 반환됩니다. 텍스트 또는 오디오 델타와 달리 인라인 동영상은 여러 step.delta 이벤트에 걸쳐 청크되지 않습니다. 생성된 각 동영상은 하나의 step.delta 이벤트에서 단일의 완전한 base64 페이로드로 전송됩니다.
대용량 또는 고해상도 동영상의 경우 "delivery": "uri"를 gcs_uri와 함께 사용하여 대규모 HTTP 또는 단일 이벤트 SSE 응답 페이로드를 방지합니다.
Interactions API와 함께 Gemini Omni 모델을 사용하는 방법에 대한 자세한 내용은 Interactions API를 참조하세요.
동기식: 스테이트리스(Stateless)
요청 데이터를 사용하기 전에 다음을 바꿉니다.
-
PROJECT_ID: Google Cloud 프로젝트 ID를 나타내는 문자열 -
MODEL_ID: 사용할 모델 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"를 설정하고response_format에서gcs_uri를 생략합니다. -
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",
"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 프로젝트 ID를 나타내는 문자열 -
MODEL_ID: 사용할 모델 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"를 설정하고response_format에서gcs_uri를 생략합니다. -
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",
"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 프로젝트 ID를 나타내는 문자열 -
INTERACTION_ID: 요청의 상호작용 ID입니다.
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 단계는 uri 대신 "mime_type": "video/mp4"와 함께 steps[].content[].data에서 base64로 인코딩된 바이트 문자열로 전체 동영상을 반환합니다.
{
"type": "model_output",
"content": [
{
"type": "video",
"data": "BASE64_ENCODED_VIDEO",
"mime_type": "video/mp4"
}
]
}동기식: 스테이트풀(Stateful) 스트리밍
요청 데이터를 사용하기 전에 다음을 바꿉니다.
-
PROJECT_ID: Google Cloud 프로젝트 ID를 나타내는 문자열 -
MODEL_ID: 사용할 모델 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"를 설정하고response_format에서gcs_uri를 생략합니다. -
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",
"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.uri 대신 "mime_type": "video/mp4"와 함께 base64로 인코딩된 문자열로 delta.data의 동영상 바이트를 반환합니다.
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 이벤트에 걸쳐 청크되지 않습니다. 생성된 각 동영상은 하나의 step.delta 이벤트("type": "video")에서 완전한 단일 base64 인코딩 페이로드로 전송됩니다. 여러 동영상 step.delta 이벤트에서 delta.data를 연결하지 마세요.
대용량 또는 고해상도 동영상의 경우 Cloud Storage 버킷(gcs_uri)과 함께 "delivery": "uri"를 사용하여 대규모 단일 이벤트 SSE 페이로드를 방지합니다.
INTERACTION_ID를 사용하여 저장된 상호작용과 생성된 동영상을 스트리밍합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
-
PROJECT_ID: Google Cloud 프로젝트 ID를 나타내는 문자열 -
INTERACTION_ID: 요청의 상호작용 ID입니다.
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.uri 대신 "mime_type": "video/mp4"와 함께 base64로 인코딩된 문자열로 delta.data의 동영상 바이트를 반환합니다.
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 이벤트에 걸쳐 청크되지 않습니다. 생성된 각 동영상은 하나의 step.delta 이벤트("type": "video")에서 완전한 단일 base64 인코딩 페이로드로 전송됩니다. 여러 동영상 step.delta 이벤트에서 delta.data를 연결하지 마세요.
대용량 또는 고해상도 동영상의 경우 Cloud Storage 버킷(gcs_uri)과 함께 "delivery": "uri"를 사용하여 대규모 단일 이벤트 SSE 페이로드를 방지합니다.
비동기식
요청 데이터를 사용하기 전에 다음을 바꿉니다.
-
PROJECT_ID: Google Cloud 프로젝트 ID를 나타내는 문자열 -
MODEL_ID: 사용할 모델 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"를 설정하고response_format에서gcs_uri를 생략합니다. -
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",
"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 프로젝트 ID를 나타내는 문자열 -
INTERACTION_ID: 요청의 상호작용 ID입니다.
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 단계는 uri 대신 "mime_type": "video/mp4"와 함께 steps[].content[].data에서 base64로 인코딩된 바이트 문자열로 전체 동영상을 반환합니다.
{
"type": "model_output",
"content": [
{
"type": "video",
"data": "BASE64_ENCODED_VIDEO",
"mime_type": "video/mp4"
}
]
}Veo를 사용하여 동영상 연장하기
다음 예시는 Veo 동영상을 확장하는 방법을 보여줍니다.
콘솔
Google Cloud 콘솔에서 Agent Platform > Media Studio 페이지로 이동합니다.
동영상을 클릭합니다.
태스크 메뉴에서 동영상 확장 프로그램을 선택합니다.
모델 메뉴에서 표시된 옵션 중 모델을 선택합니다.
입력 동영상 섹션에서 추가를 클릭합니다.
프롬프트 상자에 생성할 동영상을 설명하는 텍스트 프롬프트를 입력합니다.
선택사항: 다음 파라미터를 조정합니다.
결과 수: 슬라이더를 조정하거나 1~4 사이의 값을 입력합니다.
동영상 길이: 메뉴에서 동영상 길이를 선택합니다.
- 출력 디렉터리: 찾아보기를 클릭하여 생성된 파일을 저장할 Cloud Storage 버킷을 만들거나 선택합니다.
- 실행을 클릭합니다.
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
REST
Veo API에 대한 자세한 내용은 다음을 참조하세요.
- 메서드:
endpoints.predict VideoGenerationModelInstanceVideoGenerationModelParamsVideoGenerationModelResult
다음 명령어를 사용하여 동영상 생성 요청을 전송합니다. 이 요청은 장기 실행 작업을 시작하고 지정한 Cloud Storage 버킷에 출력을 저장합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
-
PROJECT_ID: Google Cloud 프로젝트 ID를 나타내는 문자열 -
MODEL_ID: 사용할 모델 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: 확장하려는 Veo 동영상의 Cloud Storage 경로를 나타내는 문자열. 예를 들면"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 프리뷰 모델만 해당)
기본값은
"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", "video": { "gcsUri": "PATH_TO_VIDEO", "mimeType": "video/mp4" } } ], "parameters": { "storageUri": "OUTPUT_STORAGE_URI", "sampleCount": RESPONSE_COUNT } }요청을 보내려면 다음 옵션 중 하나를 선택합니다.
이 요청은 고유한 작업 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: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 프로젝트 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
요청 본문을
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