Veo 3.1 Fast

ID:google/veo-3

Veo 3.1 Fast — 네이티브 오디오(대사 및 사운드 이펙트), 이미지-투-비디오, 최대 1080p 해상도를 지원하는 Google DeepMind의 고속·저비용 Veo 3.1 영상 모델.

텍스트-투-비디오이미지-투-비디오오디오 생성1080p

개요

Veo 3.1 Fast — 네이티브 오디오(대사 및 사운드 이펙트), 이미지-투-비디오, 최대 1080p 해상도를 지원하는 Google DeepMind의 고속·저비용 Veo 3.1 영상 모델.

인증

모든 API 요청은 Authorization 헤더에 Bearer 방식으로 유효한 API 키를 전달해야 합니다.

빠른 시작

인증 정보

RUNBASE_API_KEY 환경 변수를 설정하세요.

Shell

export RUNBASE_API_KEY=your-api-key

실행 생성

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

실행

실행은 비동기로 처리됩니다. 요청을 제출한 후 결과를 폴링하세요.

실행 생성

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

실행 상태 조회

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

결과 조회

status가 "succeeded"가 될 때까지 상태 엔드포인트를 폴링한 후 응답에서 output.urls를 읽으세요.

입력 스키마

매개변수	유형	필수	설명
prompt	string	필수	Prompt
aspect_ratio	string	선택	Aspect ratio옵션: `16:99:16`
resolution	string	선택	Resolution옵션: `720p1080p`
image_urls	string[]	선택	Frame images

출력 스키마

필드	유형	설명
urls	string[]	생성된 출력 URL

오류

API는 표준 HTTP 상태 코드를 사용하여 성공 또는 실패를 나타냅니다.

상태 코드	설명
400	Request không hợp lệ - thiếu hoặc sai định dạng tham số
401	Xác thực thất bại - thiếu hoặc sai khóa API
402	Không đủ tín dụng
403	Bị từ chối - IP không được phép hoặc khóa API vượt giới hạn chi tiêu
404	Không tìm thấy lượt chạy
429	Vượt giới hạn tốc độ
500	Lỗi máy chủ nội bộ