curl-X POST 'https://pollo.ai/api/platform/v1/generation/google/veo-3/video'\-H'Content-Type: application/json'\-H'x-api-key: YOUR_API_KEY'\-d'{ "input": { "prompt": "A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field", "negativePrompt": "blurry, low quality, distorted, watermark, text", "aspectRatio": "16:9", "duration": 4, "resolution": "720p", "generateAudio": true }}'
Du kan eventuelt inkludere webhookUrl for å motta et tilbakekall når oppgaven lykkes eller mislykkes.
Valgfritt forespørselsfelt
{"input":{"prompt":"A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field","negativePrompt":"blurry, low quality, distorted, watermark, text","aspectRatio":"16:9","duration":4,"resolution":"720p","generateAudio":true},"webhookUrl":"https://example.com/webhooks/pollo"}
Skjema
Inndatafelt for det valgte endepunktet og modusen.
Felt
Type
Obligatorisk
Beskrivelse
prompt
string
Ja
Text prompt describing the content to generate.
negativePrompt
string
Ingen
Text describing elements to avoid in the generated output.
aspectRatio
string
Ingen
Output aspect ratio, as width:height (e.g. 16:9).
duration
number
Ingen
The duration of the generated video, in seconds.
resolution
string
Ingen
Output resolution of the generated media (e.g. 720p, 1080p, 2K, 4K). Values are case-insensitive.
seed
integer
Ingen
Random seed for reproducible generation.
generateAudio
boolean
Ingen
Generate natural-sounding, fitting audio for the output video.
Veo 3에서는 오디오가 생성 계획의 일부입니다. 이 모델은 음성, 효과음, 주변 소음, 움직임, 카메라 방향을 함께 설명한 짧은 영상 클립을 만들 수 있습니다.
Pollo API의 Veo 3를 사용하면, 개발자는 시각 출력과 오디오 출력이 모두 포함된 생성 클립이 필요한 제품에 text-to-video 및 image-to-video 워크플로를 추가할 수 있습니다.
Veo 3 API 주요 기능
네이티브 오디오 출력
Veo 3는 영상과 함께 생성 오디오를 만들 수 있습니다. 여기에는 음성, 장면의 분위기음, 클립에서 보이는 동작과 연결된 효과음이 포함됩니다.
짧은 대화 처리
이 모델은 프롬프트가 화자, 대사, 제스처, 주변 반응을 압축된 장면으로 정의하는 짧은 발화 장면에 유용합니다.
움직임 및 물리 디테일
Veo 3는 오브젝트 이동, 조명 변화, 카메라 움직임, 환경 효과를 다뤄서 짧은 장면이 내부적으로 일관되게 느껴지도록 도와줘.
텍스트 및 이미지 가이드
프롬프트는 텍스트만으로 시작할 수도 있고, 인물/피사체, 오프닝 프레임, 제품, 오브젝트, 환경에 대한 시각적 맥락으로 이미지를 사용할 수도 있습니다.
사운드 인지 장면 설계
장면 지시에는 무엇이 들려야 하는지 포함할 수 있습니다. 예를 들면 발소리, 도구 소리, 알람, 실내 잔향, 물소리, 기계음, 또는 짧은 대사 같은 것들입니다.
컴팩트한 클립 구조
Veo 3는 장면에 메인 동작 하나, 명확한 카메라 아이디어 하나, 그리고 들리거나 보이는 엔딩 비트가 있을 때 더 쉽게 제어됩니다.
Veo 3 API 활용 사례
대화 클립 도구: 정의된 화자, 발화 대사, 일치하는 동작, 주변 분위기음을 갖춘 짧은 장면 생성.
트레이닝 시나리오: 직장, 안전, 온보딩 스크립트를 보이는 동작과 관련 오디오 큐가 포함된 짧은 클립으로 변환.
교육 시연: 내레이션, 오브젝트 움직임, 환경음으로 하나의 학습 포인트를 뒷받침하는 수업 클립 제작.
게임 및 스토리 장면: 음성, 움직임, 배경 디테일을 함께 필요로 하는 짧은 컷신, NPC 대사, 분기형 스토리 에셋 제작.
광고 콘셉트 초안: 제작 전에 짧은 광고 장면을 테스트. 특히 사운드, 액션, 타이밍이 아이디어에 영향을 줄 때 유용합니다.
크리에이터 앱 기능: 무음 클립을 별도 오디오 워크플로로 보내는 대신, 사용자가 생성 사운드가 있는 짧은 비디오 게시물을 만들게 해 줍니다.
image-to-video 애니메이션: 카메라 이동, 피사체 동작, 환경, 사운드 처리 방식을 정의해 업로드한 비주얼을 애니메이션화.
Veo 3 API 사용 방법
API 키 받기: Pollo API 계정을 만들고 개발자 대시보드에서 API 키를 생성합니다.
모델 선택:/generation/google/veo3의 Veo 3 경로를 호출해.
입력 추가: text-to-video용 prompt 또는 image-to-video용 image URL을 보내고, 필요하면 negativePrompt, length, aspectRatio, resolution, seed, generateAudio를 설정합니다.
생성 및 조회: 작업을 제출하고 반환된 작업 정보를 저장한 뒤, 생성이 완료되면 비디오를 가져옵니다.
Veo 3 API 프롬프트 작성 모범 사례
프롬프트를 짧은 장면 명세처럼 작성하세요. 피사체, 배경, 카메라 위치, 메인 동작, 오디오 요구사항, 필요 시 대사, 마지막 순간을 포함해.
간단한 프롬프트 공식
피사체 + 배경 + 카메라 위치 + 메인 동작 + 오디오 큐 또는 대화 + 시각 디테일 + 엔딩 비트
확인해야 할 점
오디오 범위: 클립에 음성, 분위기음, 효과음, 무음, 또는 특정 조합을 포함할지 명시해.
대화 길이: 특히 장면에 보이는 동작이나 반응도 필요할 때는 대사를 짧게 유지합니다.
동작-사운드 연결: 문 열림, 도구 회전, 물 붓기, 타이머 비프음처럼 자연스럽게 소리가 나는 동작을 설명해.
카메라 단순성: 짧은 출력에 여러 샷 전환을 넣기보다 명확한 카메라 아이디어 하나를 사용합니다.
이미지 목적: 이미지가 제공되면 피사체, 환경, 첫 프레임, 오브젝트 형태, 스타일 레퍼런스 중 무엇을 정의하는지 설명해.
종료 상태: 클립 끝에서 무엇이 성립해야 하는지 정의해. 예: 오브젝트 고정 완료, 문이 열림, 화자가 멈춤.
예시 프롬프트
환승 플랫폼 안내 방송
"이른 아침 기차 플랫폼을 배경으로 8초짜리 비디오를 만들어 줍니다. 역무원이 디지털 게시판을 확인하고 승객들을 다른 선로로 안내하며 '3번 플랫폼 탑승 시작입니다.'라고 말해. PA 잔향, 굴러가는 여행가방 소리, 차가운 조명, 느린 측면 트래킹 카메라를 포함해."
작업실 수리 클립
"고장 난 책상 스탠드의 업로드된 사진을 시작 이미지로 사용합니다. 손이 스위치를 교체하고, 스탠드가 한 번 깜빡인 뒤 안정적으로 켜지는 모습을 보여 줍니다. 작은 드라이버 소리, 조용한 작업대 분위기음, 따뜻한 그림자, 마지막 클로즈 푸시인을 포함해."
교실 화학 시연
"짧은 교실 시연을 만들어 줍니다. 선생님이 투명 비커에 파란 용액을 넣고, 학생들이 몸을 앞으로 기울이며, 액체가 초록색으로 변해. '반응이 시작되는 걸 봐'라는 대사, 유리 부딪힘 소리, 실내 분위기음, 상단에서 클로즈로 이어지는 안정적인 카메라 이동을 추가합니다."
비상 훈련 시나리오
"직장 안전 훈련 클립을 생성합니다. 복도 조명이 깜빡이고, 직원이 캐비닛을 닫고, 바닥 화살표를 따라가며 '대피 경로는 이상 없습니다.'라고 말해. 멀리서 들리는 알람, 발소리, 형광등 조명, 열린 계단실 문을 보여주는 마지막 샷을 포함해."
주방 타이머 순간
"8초짜리 주방 클립을 만들어 줍니다. 요리사가 오븐을 열면 김이 빠져나오고, 타이머가 두 번 비프음을 내며, '완벽해, 잠깐 식히자.'라고 말해. 근접 핸드헬드 프레이밍, 따뜻한 조리대 조명, 오븐 소리, 트레이에서 마무리 정지를 사용합니다."
Veo 3 vs Veo 3 Fast vs Veo 3.1
기능
Veo 3
Veo 3 Fast
Veo 3.1
주요 용도
비디오와 네이티브 오디오를 포함한 표준 Veo 3 생성
초안 및 프롬프트 테스트를 위한 속도 중심 반복
확장된 시각 제어를 갖춘 최신 Veo 워크플로
입력 적합성
텍스트 프롬프트 및 단일 이미지 가이드
빠른 변형 생성을 위한 텍스트/이미지 프롬프트
텍스트, 이미지, 레퍼런스, 제어된 프레임 워크플로
오디오 워크플로
짧은 클립에서 생성된 음성, 분위기음, 효과음
오디오-비디오 프롬프트 아이디어를 빠르게 테스트할 때 유용
오디오가 더 제어된 시각 입력을 따라야 할 때 유용
장면 제어
메인 동작 1개와 정의된 사운드 큐가 있는 간결한 장면
다양한 프롬프트 방향과 변형 탐색
레퍼런스 기반 또는 프레임 가이드 장면 기획
개발자 적합성
동일 워크플로에서 오디오 포함 생성 비디오가 필요한 Apps
프리뷰 도구, 배치 아이데이션, 짧은 반복 루프
더 엄격한 시각 연속성 또는 레퍼런스 처리가 필요한 워크플로
권장 대상
대화 클립, 설명 영상, 트레이닝 장면, image-to-video 출력
초안 작성, 테스트, 프롬프트 비교
더 엄격한 시각 제어가 필요한 캠페인/레퍼런스/스토리보드 에셋
왜 Veo 3 API를 선택해야 하나요?
Veo 3는 결과물에 움직이는 이미지뿐 아니라 생성 사운드도 포함돼야 할 때 실용적인 선택입니다. 음성, 분위기음, 동작 기반 오디오가 있는 짧은 장면에 잘 맞습니다.
Pollo API를 통해 팀은 Veo 3를 300개 이상의 이미지/영상 모델과 함께 사용할 수 있습니다. 단일 API 인터페이스, 깔끔한 문서, 더 낮은 비용, 확장 가능한 인프라, 사람의 지원까지 제공됩니다.
대화 클립, 트레이닝 장면, 교육 콘텐츠, 광고 초안, image-to-video 도구를 위해 오디오 인지형 영상 생성이 필요하다면 Pollo API의 Veo 3를 사용합니다.
Veo 3 API FAQ
Veo 3는 무엇인가요?
Veo 3는 Google의 영상 생성 모델로, 음성, 효과음, 분위기음, 사실적인 움직임, 텍스트 또는 이미지 가이드를 포함한 네이티브 오디오 기반의 짧은 영상을 만들 수 있습니다.
Veo 3 API는 text-to-video와 image-to-video를 지원하나요?
네. Pollo API의 Veo 3 API는 프롬프트 기반 생성과 이미지 가이드 생성을 지원하므로, 개발자는 작성한 장면이나 업로드한 비주얼에서 클립을 만들 수 있습니다.
Veo 3는 비디오와 함께 오디오를 생성할 수 있나요?
네. Veo 3는 짧은 음성, 배경 분위기음, 장면에서 보이는 동작과 관련된 효과음을 포함해 클립과 함께 오디오를 생성할 수 있습니다.
Veo 3 API는 대화 장면에 유용한가요?
네. 특히 짧은 대화에 유용합니다. 프롬프트에는 누가 말하는지, 대사, 보이는 동작, 주변 사운드 환경을 정의해야 해.
Veo 3는 Veo 3 Fast와 어떻게 다른가요?
Veo 3는 오디오 타이밍과 시각 디테일이 중요한 표준 생성에 더 적합합니다. Veo 3 Fast는 빠른 변형과 프롬프트 테스트에 더 유용합니다.
왜 Pollo API를 통해 Veo 3를 실행하나요?
Pollo API를 사용하면 개발자가 Veo 3를 다른 300개 이상의 이미지/영상 모델과 함께 쓸 수 있으므로, 비교, 워크플로 설계, 통합 관리가 더 쉬워져.
