Veo 비디오 생성
AceDataCloud의 Google Veo API를 통해 AI 비디오를 생성합니다.
설정: 토큰 설정은 인증을 참조하세요.
빠른 시작
curl -X POST https://api.acedata.cloud/veo/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "a whale breaching in slow motion at golden hour", "model": "veo3", "callback_url": "https://api.acedata.cloud/health"}'
비동기: 비동기 작업 폴링을 참조하세요.
POST /veo/tasks에{"id": "..."}를 전송하여 폴링합니다. 위 명령은 작업 ID를 즉시 반환합니다. 결과를 폴링하려면:
curl -X POST https://api.acedata.cloud/veo/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<위에서 받은 task_id>"}'
모델
| 모델 | 오디오 | 최적 용도 |
|---|---|---|
veo2 | 없음 | 비용 효율적인 생성 |
veo2-fast | 없음 | 빠르고 비용 효율적인 생성 (기본값) |
veo3 | 있음 (네이티브) | 전체 시청각 생성 |
veo3-fast | 있음 (네이티브) | 더 빠른 시청각 생성 |
veo31 | 있음 (네이티브) | Veo 3.1, 최고 품질 |
veo31-fast | 있음 (네이티브) | Veo 3.1 고속 변형 |
veo31-fast-ingredients | 있음 (네이티브) | Veo 3.1 고속, 재료 모드 |
워크플로우
1. 텍스트-투-비디오
POST /veo/videos
{
"action": "text2video",
"prompt": "cinematic aerial shot of the Northern Lights over Iceland",
"model": "veo3",
"resolution": "1080p"
}
2. 이미지-투-비디오
정지 이미지를 비디오로 애니메이션화합니다.
POST /veo/videos
{
"action": "image2video",
"prompt": "the scene gently comes to life with wind and subtle motion",
"image_urls": ["https://example.com/landscape.jpg"],
"model": "veo2",
"aspect_ratio": "16:9"
}
3. 재료-투-비디오 (다중 이미지 블렌드)
1~3개의 레퍼런스 이미지를 비디오로 블렌드합니다 (veo31-fast-ingredients 전용).
POST /veo/videos
{
"action": "ingredients2video",
"image_urls": [
"https://example.com/img1.jpg",
"https://example.com/img2.jpg"
],
"model": "veo31-fast-ingredients"
}
4. 1080p 업스케일
이전에 생성된 비디오를 전체 1080p 해상도로 변환합니다.
POST /veo/videos
{
"action": "get1080p",
"video_id": "your-video-id",
"model": "veo3"
}
매개변수
| 매개변수 | 값 | 설명 |
|---|---|---|
action | "text2video", "image2video", "ingredients2video", "get1080p" | 생성 모드 |
model | 모델 표 참조 | 사용할 모델 (기본값: veo2-fast) |
resolution | "4k", "1080p", "gif" | 출력 해상도 (기본값: 720p) |
aspect_ratio | "16:9", "9:16", "1:1", "4:3", "3:4" | 화면 비율 — image2video에만 유효 |
image_urls | 문자열 배열 | 레퍼런스 이미지 URL — image2video(최대 2개) 또는 ingredients2video(최대 3개) |
video_id | 문자열 | 업스케일할 비디오 — get1080p 전용 |
translation | true / false | 프롬프트를 영어로 자동 번역 (기본값: false) |
생성 후 엔드포인트
비디오를 생성한 후 다음 엔드포인트를 사용하여 추가 처리합니다:
업샘플 (POST /veo/upsample)
생성된 비디오를 1080p, 4K로 업스케일하거나 GIF로 변환합니다.
POST /veo/upsample
{
"video_id": "your-video-id",
"action": "4k"
}
| 매개변수 | 값 | 설명 |
|---|---|---|
video_id | 문자열 | /veo/videos, /veo/extend, /veo/reshoot, 또는 /veo/objects의 작업 ID |
action | "1080p", "4k", "gif" | 업샘플 대상 |
확장 (POST /veo/extend)
기존 비디오를 계속 생성합니다 — AI가 자동으로 다음 세그먼트를 생성합니다.
POST /veo/extend
{
"video_id": "your-video-id",
"model": "veo31-fast",
"prompt": "the camera slowly zooms out"
}
| 매개변수 | 값 | 설명 |
|---|---|---|
video_id | 문자열 | /veo/videos 또는 이전 /veo/extend의 작업 ID |
model | "veo31-fast", "veo31" | Veo 3.1 시리즈만 지원 |
prompt | 문자열 | 선택 사항: 확장된 세그먼트 안내 |
재촬영 (POST /veo/reshoot)
동일한 콘텐츠를 유지하면서 새로운 카메라 모션을 적용하여 비디오를 다시 렌더링합니다.
POST /veo/reshoot
{
"video_id": "your-video-id",
"motion_type": "LEFT_TO_RIGHT"
}
| 매개변수 | 값 | 설명 |
|---|---|---|
video_id | 문자열 | /veo/videos의 작업 ID (/veo/extend 출력은 사용 불가) |
motion_type | 아래 표 참조 | 적용할 카메라 모션 |
motion_type 값:
STATIONARY, STATIONARY_UP, STATIONARY_DOWN, STATIONARY_LEFT, STATIONARY_RIGHT, STATIONARY_DOLLY_IN_ZOOM_OUT, STATIONARY_DOLLY_OUT_ZOOM_IN, UP, DOWN, LEFT_TO_RIGHT, RIGHT_TO_LEFT, FORWARD, BACKWARD, DOLLY_IN_ZOOM_OUT, DOLLY_OUT_ZOOM_IN
객체 (POST /veo/objects)
마스크 기반 인페인팅을 사용하여 비디오에서 객체를 삽입하거나 제거합니다.
POST /veo/objects
{
"video_id": "your-video-id",
"action": "insert",
"prompt": "add a flying bird"
}
POST /veo/objects
{
"video_id": "your-video-id",
"action": "remove",
"image_mask": "https://example.com/mask.jpg"
}
| 매개변수 | 값 | 설명 |
|---|---|---|
video_id | 문자열 | 작업 ID (/veo/extend 출력은 사용 불가) |
action | "insert", "remove" | 작업 유형 |
prompt | 문자열 | insert에 필수; remove에는 선택 사항 |
image_mask | 문자열 | URL 또는 base64 JPEG — 흰색 픽셀 = 대상 영역. remove에 필수; insert에는 선택 사항 |
주의사항
- Veo 3 및 3.1 모델은 네이티브 오디오를 생성합니다 —
veo2/veo2-fast는 오디오를 지원하지 않습니다 get1080p액션은video_id(이전 생성 결과)를 사용하며, URL이 아닙니다aspect_ratio는image2video액션에만 유효합니다image_urls는 배열을 허용합니다 —image2video의 경우 최대 2개,ingredients2video의 경우 최대 3개veo31-fast-ingredients는 이미지 입력이 필수이며, 텍스트 전용 생성이 불가능합니다translation: true는 중국어 또는 기타 비영어 프롬프트를 Veo에 전송하기 전에 자동 번역합니다- 작업 폴링 시
/veo/tasks요청 본문에id(task_id아님)를 사용합니다 - 작업 상태는
"succeeded"( "completed" 아님)를 사용합니다 — 폴링 시 이 값을 확인하십시오 /veo/extend출력은/veo/reshoot또는/veo/objects의 입력으로 사용할 수 없습니다
MCP:
pip install mcp-veo| 호스팅:https://veo.mcp.acedata.cloud/mcp| 모든 MCP 서버 참조