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": "veo3-fast",
7 "watermark": "veo"
8 }'
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 크레딧) 중 선택
aspect_ratiostring화면 비율: 16:9(기본, 1080P HD), 9:16(세로), 또는 Auto(이미지에 맞춤)
image_urlsstring[]이미지→비디오 생성을 위한 이미지 URL 배열
watermarkstring사용자 정의 워터마크 텍스트. 워터마크 없음은 null로 설정

요청 예시

JSON
1{
2 "prompt": "a dog running",
3 "model": "veo3-fast",
4 "watermark": "veo"
5}

응답

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv"
6 }
7}

크레딧 소모

모델 유형크레딧비용
veo3-fast25 credits$0.25
veo3180 credits$1.80
extend원본과 동일-
get-1080p무료$0.00

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

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": "veo3-fast",
8 "watermark": "veo"
9 },
10 "response": [
11 "https://cdn.veo3api.com/video/example_watermarked.mp4"
12 ],
13 "status": "COMPLETED",
14 "created_at": "2025-10-29 12: 20: 46"
15 }
16}

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

POSThttps://veo3api.com/extend

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

요청 본문

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

요청 예시

JSON
1{
2 "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
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": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
7 "credits_consumed": 25
8 }
9}

참고: 완료된 비디오 작업만 확장할 수 있습니다. 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": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
6 "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
7 }
8}

💡 팁: 이 엔드포인트는 완전히 무료입니다. 완료된 모든 비디오의 1080P 버전을 크레딧 소모 없이 받을 수 있습니다.

HTTP 상태 코드

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