Veo 3.1 API — 네이티브 오디오를 지원하는 Google의 텍스트-비디오, OpenAI 호환(2026)

Veo 3는 Google의 텍스트-비디오 모델이며, Veo 3 API는 텍스트 프롬프트나 정지 이미지에서 기본 동기화 오디오가 포함된 영화 같은 클립을 생성합니다. Kunavo는 전체 제품군(veo-3-lite, veo-3 Fast 및 veo-3-quality)을 OpenAI 스타일의 비디오 엔드포인트를 통해 제공하며, 하나의 bearer token으로 Google 정가보다 약 50–70% 낮은 가격에 이용할 수 있습니다.

Veo 3 API 호출

/app/keys에서 키를 생성하고 /v1/video/generations에 POST 요청을 보내세요. 생성에는 몇 분이 걸리므로 동기식 호출은 클립이 준비될 때까지 연결을 유지합니다.

import requests

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",                 # Fast tier; also veo-3-lite / veo-3-quality
        "prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
        "aspect_ratio": "16:9",
        "resolution": "720p",
    },
    timeout=600,  # Veo 3 generation takes minutes
)
print(resp.json()["data"][0]["url"])

curl을 사용한 동일한 호출:

curl https://api.kunavo.com/v1/video/generations \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 600 \
  -d '{
    "model": "veo-3",
    "prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

코드베이스의 나머지 부분이 이미 OpenAI SDK에서 실행되고 있다면 모든 작업에 하나의 클라이언트를 계속 사용할 수 있습니다. 채팅, 이미지, 비디오는 키와 base_url를 공유합니다.

# Already using the OpenAI SDK? Keep it — only base_url changes.
# Video isn't in the OpenAI SDK surface, so reuse its client for auth/config
# and post to the video route directly.
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",
)

resp = client.post(
    "/video/generations",
    body={"model": "veo-3", "prompt": "a neon-lit alley in the rain"},
    cast_to=object,
    options={"timeout": 600.0},
)
print(resp["data"][0]["url"])

duration은 초 단위 값으로, 초당 과금 모델, 즉 Seedance 모델들과 Wan 2.7에서 클립 길이를 지정합니다. Veo 모델은 이 값을 무시하며, 모든 Veo 클립은 8초이고 동영상당 과금됩니다.

반환되는 URL은 영구적입니다. 전체 매개변수(resolution, aspect_ratio, image_urls, image_mode)는 비디오 API 레퍼런스에 있습니다.

Kunavo에서 Veo에는 시드 매개변수도 네거티브 프롬프트 매개변수도 없습니다. 요청에 포함해도 해당 매개변수는 무시됩니다.

등급 및 가격

Veo 3에는 세 가지 품질 등급이 있습니다. 아래 동영상당 요금은 8초 720p 클립 기준이며, 1080p와 4K는 더 높은 요금이 적용됩니다. 실시간 요금은 각 모델 페이지에 표시됩니다.

이미지-동영상

정지 이미지에 애니메이션을 적용하려면 image_url를 전달하세요. 제품이나 캐릭터의 일관성을 유지하는 데 유용합니다. 제어된 전환을 위해 첫 프레임과 마지막 프레임을 전달하세요.

# Image-to-video: animate a still by passing image_url
requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",
        "prompt": "slow parallax, gentle wind through the grass",
        "image_url": "https://your-cdn.com/keyframe.png",
    },
    timeout=600,
)

프로덕션에서는 비동기 방식

대규모 환경에서 몇 분 동안 연결을 유지하지 마세요. /v1/videos에 작업을 제출하고 작업 ID를 받은 다음, 완료될 때까지 GET /v1/videos/{id}를 폴링하세요. 멱등성 키와 선택적 웹훅도 지원합니다. 전체 흐름은 비디오 문서에 있습니다.

Veo 3 프롬프트 작성

• 주제만이 아니라 장면을 설명하세요 — 카메라 이동(돌리, 팬, 푸시인), 렌즈 느낌, 조명과 속도감이 가장 중요합니다.
• 오디오를 적극 활용하세요 — Veo 3는 소리를 렌더링하므로 원하는 환경음이나 효과음을 명시하세요.
• 가로세로 비율을 명시하세요 — 가로 화면에는 16:9, 세로/소셜에는 9:16.
• 모든 Veo 클립은 8초입니다 — 각 장면을 이 길이에 맞춰 구성하고, 더 긴 시퀀스는 여러 생성 결과를 이어 붙이세요.

Kunavo와 Google 직접 호출 비교

Veo 3는 Gemini API와 Vertex AI를 통해 Google에서 직접 제공되기도 합니다. Google 자체의 SLA와 지원 계약이 필요하다면 이 경로가 적합합니다. 실제 차이는 다음과 같습니다.

요약하면, Kunavo는 설정 시간, 단위 가격, 모든 모달리티에 하나의 키를 사용하는 점에서 유리합니다. Google 직접 호출은 할당량 보장이나 엔터프라이즈 계약이 필요할 때 유리합니다.

Veo 3와 Sora 및 Kling 비교

Veo 3는 현재 일반적으로 제공되는 가장 강력한 텍스트-비디오 모델이며 Kunavo에서 실제로 사용할 수 있는 모델입니다. Sora와 Kling은 동일한 엔드포인트에서 제공될 예정입니다. 모델 구도는 텍스트-비디오 API 가이드를, 각 제품군은 Sora API 및 Kling API 가이드를 참고하세요.

이 제품군만이 아니라 가격을 기준으로 비디오 모델을 선택하고 있나요? 비디오 생성 API 비교에서는 동일한 8초 720p 클립을 기준으로 8개 모델의 가격을 비교합니다.

자주 묻는 질문