빠른 답변
- veo3.1-lite-official supports Text-to-Video, Image-to-Video, R2V, and Video Edit in one workflow.
- Use this model guide page to validate parameters with minimal request/response examples.
- Stabilize prompts here first, then move to production API integration.
주요 파라미터
- model | string | 필수 | Veo3.1-lite-official | - | Model identifier. Use the fixed value `Veo3.1-lite-official`.
- prompt | string | 필수 | - | - | Main instruction describing the subject, action, scene, and style.
- aspect_ratio | string | 선택 | 16:9 | 16:9 | 9:16 | Video aspect ratio. Defaults to `16:9`; supports `16:9 | 9:16`.
- duration | integer | 선택 | 8 | 4 | 6 | 8 | 출력 길이(초)입니다. 기본값은 `8`이며 `4 | 6 | 8`를 지원합니다.
- resolution | string | 선택 | 720p | 720p | 1080p | 출력 해상도입니다. 기본값은 `720p`이며 `720p | 1080p`를 지원합니다.
자주 발생하는 오류
- 400 invalid_request_error: 발생 조건=Request payload misses required fields or has invalid field types.; 해결=Validate model, mode, and input schema before request.; 재시도=Retry only after fixing payload; avoid blind retries.
- 401 authentication_error: 발생 조건=Missing Authorization header or invalid API key.; 해결=Verify Bearer token format and API key scope.; 재시도=Retry after auth fix; rotate key if repeated failures continue.
- 429 rate_limit_exceeded: 발생 조건=Request rate, concurrency, or current quota hits upstream rate limiting.; 해결=Apply exponential backoff first, then review request rate, concurrency, and quota usage.; 재시도=Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.
- 500 internal_error: 발생 조건=Transient upstream error or internal processing failure.; 해결=Capture request id and trigger retry workflow.; 재시도=Retry 2-3 times with short delays; escalate if persistent.







