Veo 3.1 API 문서

Google의 AI 비디오 생성 기능을 애플리케이션에 통합하기 위한 완전한 가이드입니다.

빠른 시작 가이드

몇 분 만에 Veo 3.1 API를 시작하고 실행할 수 있습니다.

1

API 키 받기

먼저 대시보드에서 API 키를 발급받아야 합니다.

2

첫 요청 보내기

1curl -X POST "https://veo3api.com/generate" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "prompt": "a dog running",
6 "model": "veo4",
7 "duration": 5,
8 "resolution": "720p"
9 }'
3

생성 상태 확인

비디오 생성은 비동기 방식입니다. https://veo3api.com/feed 엔드포인트를 사용해 상태를 확인하거나,

cURL
1curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
2 -H "Authorization: Bearer YOUR_API_KEY"

API 레퍼런스

Veo 3.1 API의 모든 엔드포인트, 파라미터, 응답 형식에 대한 완전한 레퍼런스입니다.

기본 URL

https://veo3api.com

엔드포인트는 /api 접두사를 사용하지 않습니다 — https://veo3api.com/ 형식으로 호출하세요 (예: https://veo3api.com/generate).

인증

모든 API 요청은 Authorization 헤더에 Bearer 토큰을 사용한 인증이 필요합니다.

Authorization: Bearer YOUR_API_KEY
POSThttps://veo3api.com/generate

텍스트 또는 이미지 프롬프트로 비디오 생성

요청 본문

파라미터유형필수설명
promptstring*비디오 생성을 위한 텍스트 프롬프트
modelstring*veo3(고품질, 180 크레딧), veo3-fast(빠른 생성, 25 크레딧) 또는 veo4(길이와 해상도 기반 요금, 아래 표 참조) 중 선택
durationintegerVeo 4 길이: 5초, 10초 또는 15초(기본값: 5초)
resolutionstringVeo 4 출력 해상도: 480p, 720p(기본값) 또는 1080p
aspect_ratiostring화면 비율: 16:9(기본, 1080P HD), 9:16(세로), 또는 Auto(이미지에 맞춤)
image_urlsstring[]이미지→비디오 생성을 위한 이미지 URL 배열
watermarkstring사용자 정의 워터마크 텍스트. 워터마크 없음은 null로 설정

요청 예시

JSON
1{
2 "prompt": "a dog running",
3 "model": "veo4",
4 "duration": 5,
5 "resolution": "720p",
6 "aspect_ratio": "16: 9"
7}

응답

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90a1b2c3d4e5f6sd20",
6 "status": "IN_PROGRESS",
7 "consumed_credits": 240,
8 "model": "veo4"
9 }
10}

크레딧 소모

모델 유형크레딧비용
veo3-fast25 credits$0.25
veo3180 credits$1.80
veo4480p · 5s / 10s / 15s160 / 320 / 480 credits$1.60 / $3.20 / $4.80
veo4720p · 5s / 10s / 15s240 / 480 / 720 credits$2.40 / $4.80 / $7.20
veo41080p · 5s / 10s / 15s360 / 720 / 1080 credits$3.60 / $7.20 / $10.80
extend원본과 동일-
get-1080p무료$0.00

Veo 4 요금은 길이와 해상도에 따라 결정되며 텍스트 및 이미지 입력에 동일한 요금이 적용됩니다.

참고: 비디오 생성이 성공적으로 완료된 경우에만 크레딧이 차감됩니다. 실패한 작업은 크레딧을 소모하지 않습니다.

GEThttps://veo3api.com/feed

비디오 생성 작업의 상태 확인

요청 예시

GET https://veo3api.com/feed?task_id=YOUR_TASK_ID

응답

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "request": {
6 "prompt": "a dog running",
7 "model": "veo4",
8 "duration": 5,
9 "resolution": "720p",
10 "aspect_ratio": "16: 9"
11 },
12 "response": [
13 "https://cdn.veo3api.com/video/example_watermarked.mp4"
14 ],
15 "status": "COMPLETED",
16 "consumed_credits": 240,
17 "type": "text-to-video",
18 "model": "veo4",
19 "created_at": "2025-10-29 12: 20: 46"
20 }
21}

💡 팁: 생성된 비디오 URL은 data.response 배열에서 확인할 수 있습니다.

POSThttps://veo3api.com/extend

기존 비디오를 새 프롬프트로 확장합니다. 확장된 비디오는 원본 비디오가 끝난 지점부터 이어집니다.

요청 본문

파라미터유형필수설명
task_idstring*확장할 원본 완료 비디오의 task_id
promptstring*비디오를 어떻게 이어갈지 설명하는 텍스트 프롬프트
seedsinteger재현 가능한 생성을 위한 랜덤 시드(10000-99999). 동일한 시드는 유사한 결과를 생성합니다.
watermarkstring사용자 정의 워터마크 텍스트. 워터마크 없음은 null로 설정

요청 예시

JSON
1{
2 "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
3 "prompt": "The dog continues running and jumps over a fence",
4 "watermark": "veo"
5}

응답

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
6 "original_task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
7 "credits_consumed": 25
8 }
9}

참고: 이 엔드포인트는 완료된 veo3 및 veo3-fast 작업만 지원합니다. Veo 4 작업에는 사용할 수 없으며 1080P로 변환된 비디오도 확장할 수 없습니다.

GEThttps://veo3api.com/get-1080p무료

완료된 비디오 작업의 1080P 고화질 버전을 가져옵니다. 이 엔드포인트는 무료이며 크레딧을 소모하지 않습니다.

요청 예시

GET https://veo3api.com/get-1080p?task_id=YOUR_TASK_ID

응답

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
6 "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
7 }
8}

💡 팁: 이 엔드포인트는 완료된 veo3 및 veo3-fast 작업만 지원하며 무료로 크레딧을 소모하지 않습니다. Veo 4는 작업 생성 시 1080p를 직접 선택할 수 있습니다.

HTTP 상태 코드

상태 코드설명
200요청 성공
400잘못된 요청 - 유효하지 않은 파라미터
401인증 실패 - 유효하지 않은 API 키
429요청 한도 초과
500내부 서버 오류