사용자가 '비디오 생성' 버튼을 누르고 기다립니다. 20초가 지나도 아무 일도 일어나지 않고, 1분 뒤에도 마찬가지입니다. 바로 이 순간, 제품이 실제로 약속해야 하는 것이 무엇인지 드러납니다. 결과로 이어지는 명확한 경로인가, 아니면 침묵하는 스피너(Spinner)인가 하는 점입니다.

Veo에 대한 접근 권한이 확인되었다는 것은 단지 서버가 무엇을 할 수 있는지에 대한 질문에만 답할 뿐입니다. 이는 사용자가 4분 동안 기다릴 때 무엇을 보게 될지, 혹은 필터링으로 인해 생성이 조용히 중단되었을 때 무엇을 보게 될지에 대한 질문에는 답하지 않습니다. 사용자는 응답 코드 200이 찍힌 콘솔의 한 줄이 아니라, 버튼을 누른 시점부터 완성된 영상에 도달하거나 혹은 정직한 거절을 받기까지의 과정이라는 '약속'에 비용을 지불합니다.

따라서 작업 순서를 뒤집어야 합니다. 먼저 상태의 스토리보드(Storyboard)를 설계해야 합니다: 시작, 대기, 제한, 오류, 재시도, 결과 출력 순서입니다. 그 이후에야 접근 권한과 결제 문제가 결정되어야 합니다. 아래의 분석은 2026-07-18 기준으로 확인된 Gemini API 및 Vertex AI의 문서와 Google의 공개 리포지토리에서 관찰된 한 가지 장애 사례를 바탕으로 작성되었습니다.

사용자가 구매하는 것: 접근 권한인가, 약속인가?

'키(Key)가 있다'와 '약속이 있다'는 동일한 것이 아닙니다. 전자는 기술적 준비 상태에 관한 것이고, 후자는 제품적 준비 상태에 관한 것입니다. Veo API 키(api key veo)를 얻는 데는 5분이면 충분합니다. 접근 권한을 신청하고, 모델을 호출하고, 요청이 통과되는지 확인하면 됩니다. 하지만 이것은 아직 사용자에게 주는 약속이 아닙니다. 긴 지연이 발생할 때 무엇을 보여줄지, 오류가 발생했을 때 무엇을 보여줄지, 그리고 장애 발생 후 무엇을 해야 할지에 대한 세 가지 질문에 대한 답이 없다면, 그 기능은 검증 가능한 계약(Contract)을 갖추지 못한 것입니다.

'api veo'라는 일반적인 검색어에 대해 사람들은 대부분 기술 문서에 도달합니다. 그 문서는 모델을 호출하는 방법은 알려주지만, 보안 필터가 특정 프롬프트를 차단했을 때 어떤 일이 벌어지는지는 알려주지 않습니다. 'veo api' 검색에서도 동일한 격차가 나타납니다. 이는 이미 통합(Integration) 단계에 더 가깝지만, 여전히 거절 시나리오에 대해서는 답을 주지 못하고 있습니다.

여기서 전체 분석의 규범적인 입장이 도출됩니다: 비디오 기능은 거절(refusal)을 포함하여, 정직하게 끝까지 완수할 수 있는 시나리오만을 약속해야 합니다. 스토리보드(Storyboard)라는 방법론이 필요한 이유는 바로 약속되지 않은 상태(unpromised states)를 밖으로 끌어내기 위해서입니다. 경로가 성공(success)만을 위해 그려져 있다면, 제품은 정확히 어느 지점에서 멈추게 될지를 보지 못합니다.

왜 대기 시간은 스피너(Spinner)가 아닌 별도의 화면이어야 하는가

Veo 3.1 API를 통한 비디오 생성은 비동기(Asynchronous) 방식입니다. Gemini API 문서에 따르면, generate_videos() 호출은 done 플래그가 포함된 장기 작업(Long-running operation) 객체를 반환하며, 클라이언트는 이 플래그가 참(true)이 될 때까지 반드시 operations.get()을 폴링(Polling)해야 합니다. 그래야만 operation.response에서 결과를 읽을 수 있습니다. 공식 예제는 10초마다 폴링을 수행합니다. 이것은 백엔드의 세부 사항이 아닙니다. 대기 시간이 무한한 애니메이션이 아닌, 정직한 메시지를 담은 별도의 화면을 가져야 하는 이유입니다.

대기 시간이 얼마나 길어질 수 있는지에 대해 문서는 명확히 밝히고 있습니다: 최소 11초에서 피크 시간대에는 최대 6분입니다. 대기 화면은 즉각적인 응답이 아니라, 몇 분이 걸릴 수 있는 최악의 상황(Worst-case scenario)을 고려하여 설계해야 합니다. 비디오가 몇 초 안에 나올 것이라고 약속받은 사용자는, 생성 작업이 정상적으로 진행 중임에도 불구하고 3분째에 모든 것이 고장 났다고 판단하고 떠나버릴 것입니다.

import time
from google import genai

...

또한 여기서 데이터 보관의 첫 번째 규칙이 적용됩니다. Google은 생성된 비디오를 최대 2일 동안 보관합니다. "나중에 다운로드하세요" 또는 "내일 영상을 확인하러 오세요"와 같은 모든 약속은 이 기간을 고려해야 합니다. 이틀이 지나면 링크는 더 이상 존재하지 않으며, 만약 사용자 측에 파일이 저장되지 않았다면 그 약속은 빈말이 됩니다. 스토리보드(Storyboard)에서 이는 작은 글씨의 각주가 아니라, 별도의 노드(Node)로 다뤄져야 합니다.

또한 버전에 대한 솔직한 이야기 하나를 더 덧붙이자면, Gemini API를 통해 veo-3.1-generate-preview, veo-3.1-fast-generate-preview, 그리고 veo-3.1-lite-generate-preview 옵션을 사용할 수 있습니다. 현재 접근 가능한 시점에서 Standard, Fast, Lite 모델은 일반 가용성 (General Availability, GA)이 아닌 프리뷰 (Preview) 상태로 문서화되어 있습니다. 프리뷰 상태라는 것은 엔드포인트 (Endpoint), 모델 식별자 (Model ID), 그리고 지연 시간 (Latency)을 포함한 동작 방식이 정식 출시 전까지 변경될 수 있음을 의미합니다. 따라서 접근 조건은 반년 전의 기사를 그대로 믿기보다는 통합 (Integration) 직전에 반드시 다시 확인해야 합니다.

비용은 얼마이며, 언제 결제되지 않는가

Veo에는 무료 요금제 (Free Tier)가 없습니다. 유료 요금제가 필요하며, 가격은 초 단위로 계산되고 각 옵션과 해상도에 따라 별도로 책정됩니다. Gemini API 가격 문서에 따르면, Veo 3.1 Standard는 720p 및 1080p에서 초당 $0.40, 4K에서 초당 $0.60이며, Fast는 초당 $0.10–0.30, Lite는 초당 $0.05–0.08입니다 (데이터는 2026-07-18 접근 시점 기준 확인됨). 'api veo 3'라는 모호한 표현만으로는 사용자가 정확히 어떤 옵션과 해상도를 염두에 두었는지 알 수 없으며, 그 사이의 가격 차이는 몇 배에 달합니다.

다행히 빌링 (Billing) 시스템에 좋은 소식이 포함되어 있습니다. Google은 사용자가 생성이 성공했을 때만 비용을 청구한다고 명시하고 있으며, 오디오 처리 문제로 인해 생성이 방해받을 수 있다는 점을 별도로 언급하고 있습니다. 즉, 실패하거나 필터링된 시도는 조용히 돈이 빠져나가는 것이 아니라, 문서화된 '무료 결과'입니다. 오류 화면은 이를 명확한 텍스트로 보여주어야 합니다. "실패했습니다. 비용은 청구되지 않았습니다"라는 문구 하나가 사용자의 불안감을 절반으로 줄여줄 것입니다.

요금제 분기점은 곧 제품의 분기점이기도 합니다. Lite 버전은 Standard 버전보다 훨씬 저렴하며, 만약 사용자에게 제공하는 약속이 "빠른 초안"이라면 이를 저렴한 옵션으로 처리하고, 비싼 Standard 버전은 최종 렌더링(Final Render)용으로 남겨두는 것이 논리적입니다. "veo3 api 구매" 검색어는 이미 비용을 지불할 준비가 되었지만, 어떤 대기 시간과 거절 과정을 거치며 돈을 지불하게 될지 아직 모르는 사람들에게서 나타납니다. 이들이 바로 스토리보드(Storyboard)가 필요한 바로 그 독자층입니다.

두 번째 시도에서 통과되는 오류

가장 과소평가된 상태는 서버의 거절이 아니라 필터의 작동입니다. Vertex AI의 책임감 있는 AI(Responsible AI)에 관한 문서에 따르면, Veo의 프롬프트(Prompt)와 결과물은 안전 카테고리(폭력, 성적, 비하, 유해 콘텐츠)에 의해 검사됩니다. 차단된 생성은 "The prompt couldn't be submitted or it might violate our policies"와 같은 명시적인 오류로 나타나거나, 요청한 것보다 적은 수의 영상과 함께 해당 카테고리 코드가 반환될 수 있습니다. 여기서 "결과"와 "오류"는 이분법적이지 않습니다. 예를 들어, 4개의 영상을 요청하고 실제로 2개만 받을 수도 있습니다.

그다음부터는 불쾌한 상황이 시작됩니다. js-genai 리포지토리의 이슈(Issue)에는 Veo 3.1의 오디오 안전 필터가 비결정론적(Non-deterministic)인 오탐(False Block)을 발생시킨다는 기록이 있습니다. 즉, 동일한 이미지와 동일한 프롬프트가 한 번은 실패하고 다음에는 통과되는 식입니다. 보고자들은 정확히 동일한 요청을 3~5회 반복하면 보통 최소 한 번은 성공한다고 작성하고 있습니다. 이는 Google 리포지토리에 올라온 사용자 관찰 결과이며 공식적인 정상 동작 선언은 아니지만, 운영 측면에서 '재시도(Retry)' 버튼의 정당성을 부여합니다. 단 한 번의 실패가 반드시 최종적인 것은 아니기 때문입니다.

동일한 스레드가 구체적인 수정 없이 "계획되지 않음 (not planned)" 상태로 메인테이너(Maintainer)들에 의해 종료되었습니다. 필터의 비결정성(Non-determinism)은 곧 수정될 일시적인 버그가 아니라, 제품 설계 시 고려해야 할 지속적인 조건으로 간주해야 합니다. 그렇다고 해서 이를 일반화해서는 안 됩니다. 하나의 이슈(Issue)만으로 모든 프롬프트, 지역, 날짜에 걸친 Veo의 전반적인 신뢰성을 결론지을 수는 없습니다. 이는 구체적으로 관찰된 패턴일 뿐, 보증은 아닙니다.

여기서 스토리보드(Storyboard)를 위한 재시도 규칙이 도출됩니다. 필터 오류 발생 시 사용자에게 막다른 길을 보여주는 대신, 시도 횟수에 제한을 두고 성공적인 생성에 대해서만 비용이 청구된다는 정직한 안내와 함께 재시도를 제안해야 합니다. 카운터(Counter) 없는 재시도는 값비싼 루프(Loop)가 되고, 설명 없는 재시도는 제품의 결함처럼 보입니다. 그 어느 쪽도 약속으로서 판매되어서는 안 됩니다.

액세스(Access)는 단일 조건이 아니다

생성 비용을 지불하기 전에, Veo에 대한 액세스가 단일하지 않다는 점을 명확히 해야 합니다. Vertex AI 개요 문서는 Veo에 대한 액세스를 Vertex AI Generative AI의 더 넓은 영역의 일부로 설명합니다. 즉, Vertex AI가 활성화된 Google Cloud 프로젝트를 통해 접근하는 방식입니다. 이는 Gemini API를 통해 키(Key)로 접근하는 방식과는 별개의 경로입니다. veo 3 api 요청 시 단어의 순서가 바뀐다고 해서 본질이 변하지는 않습니다. 두 경로 모두 기본적으로 동일하다고 간주할 것이 아니라, 각 경로에 대해 통합(Integration) 과정을 별도로 확인해야 합니다.

제한 사항(Limits)에 대해서도 유사한 불확실성이 존재합니다. Gemini API 제한 페이지에는 고정된 RPM(분당 요청 수)이나 동시성(Concurrency) 수치가 게시되어 있지 않습니다. 이러한 수치는 요금제(Tier)에 따라 달라지며, Google AI Studio의 실시간 대시보드에서 특정 계정별로 확인해야 합니다. 'google veo api'를 검색하는 사용자는 보통 제3자의 블로그를 통한 재해석이 아닌 원천 정보(Primary source)에 도달하기를 원하며, 이는 올바른 본능입니다. 제3자 자료에 나온 구체적인 제한 수치는 검증된 사실이 아니며, 요청의 병렬성에 대한 모든 가정은 자신의 계정에서 제한 사항을 확인하기 전까지는 가설로 남아 있습니다.

러시아 팀의 경우, 이 두 가지 갈림길에 결제라는 세 번째 갈림길이 추가됩니다. Google은 자체적인 결제 모델을 가지고 있으며, 무엇으로 어떻게 결제할 것인가의 문제는 UX 문제보다 먼저 발생합니다. 만약 반드시 Veo를 사용해야 한다면, 대기 시간(Wait time)과 오류에 대한 스토리보드(Storyboard)를 위 문서에 따라 준비해야 합니다. 반면, 특정 모델 자체보다 러시아 내에서의 원활한 비디오 생성 작업이 중요하다면, 일부 팀에게는 별도의 미디어 서비스가 해결책이 될 수 있습니다. 예를 들어, provod.ai는 자체 비디오 편집기와 비디오 생성 기능을 갖추고 있으며, 해외 카드나 VPN 없이도 루블, 카드, SBP(Fast Payment System) 또는 계좌 이체를 통해 접근 비용을 결제할 수 있습니다. 이는 Veo를 재포장한 것이 아니라 자체적인 시나리오를 가진 독립적인 제품이며, 이들 사이의 선택은 사용자에게 어떤 약속을 지키는 것이 더 편리한가에 따라 결정됩니다.

아래는 각 상태에 대한 제품 규칙(Product rule)을 포함하여 정리한 상태별 스토리보드입니다. 이는 접근 권한 문제를 논하기 전에 확정되어야 합니다.

스토리보드의 경계: 접근성, 버전, 신뢰성, 인프라

Storyboard는 Veo의 가용성(Availability)을 확인해주지 않으며, 지역적 조건(Regional conditions) 확인을 대체하지도 않습니다. 이는 사용자에게 무엇을 약속할 것인지를 기술할 뿐, 모델이 바로 오늘, 혹은 특정 지역에서 반드시 사용 가능하다는 것을 보장하지는 않습니다. Google의 캐릭터 및 지역 제한 사항은 예고 없이 변경될 수 있으므로, 통합(Integration) 전에는 기사가 아닌 최신 정책 페이지를 직접 확인해야 합니다.

또한, 이는 버전 확인(Version check)을 생략해도 된다는 의미가 아닙니다. preview 상태인 veo-3.1은 정식 출시 전까지 엔드포인트(Endpoint), 식별자(Identifier), 동작 방식이 변경될 수 있습니다. 본 분석에서 조건 재검증(Revalidation) 날짜는 2026-07-18로 설정되어 있으며, 실제 출시 전에는 이 날짜를 조정해야 합니다.