> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # VEO 3.1 Video Generation > Fast and high-quality 8-second video generation with Google's VEO 3.1 1. After submission, a `task_id` will be returned. If you provided a `callback_url`, when the task status becomes `finished` or `failed`, a POST request will be sent to the `callback_url`. 2. Regardless of whether `callback_url` is provided, you can retrieve the response result through the unified [Query Task Status](/api-manual/task-management/status) endpoint. # VEO 3.1 Video Generation Generate fast or high-quality 8-second videos with Google's VEO 3.1 model. Supports text-to-video and image-to-video generation. ## Available Models * **veo3.1-fast** - Fast 8-second generation * **veo3.1-quality** - High-quality 8-second generation ## Duration Options * **8 seconds** - Fixed duration for all generations ## Key Features * Asynchronous processing that returns a `task_id` for status tracking * Supports text-to-video and image-to-video generation * Supports up to 4k output resolution * Generated video URLs are valid for 24 hours ## Advanced Parameters ### Generation Type * `frame` - Frame-to-video (two images) * `reference` - Reference image video (three images) * If omitted, inferred by `image_urls` count: 2 images for `frame`, 3 images for `reference` ### Image URLs * Supports up to 3 images * Frame mode: first image is the start frame, second image is the end frame * Maximum file size: 10MB * Supported formats: .jpeg, .jpg, .png, .webp ### Resolution * `720p` (default), `1080p`, or `4k` ## OpenAPI ````yaml /api-manual/video-series/veo-3-1.json POST /api/generate/submit openapi: 3.0.0 info: title: PoYo AI - VEO 3.1 API description: Fast and high-quality 8-second video generation with Google's VEO 3.1 version: 1.0.0 servers: - url: https://api.poyo.ai description: Production server security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - VEO 3.1 summary: Submit VEO 3.1 Video Generation Task description: Fast and high-quality 8-second video generation using Google's VEO 3.1 operationId: submitVEO3Task requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SubmitRequest' examples: veo3.1-fast: summary: VEO 3.1 Fast video generation value: model: veo3.1-fast callback_url: https://your-domain.com/callback input: prompt: Dolphins jumping in a bright blue ocean duration: 8 aspect_ratio: '16:9' veo3.1-quality: summary: VEO 3.1 Quality 4k generation value: model: veo3.1-quality callback_url: https://your-domain.com/callback input: prompt: A high-detail aerial view of a coastal city at dusk duration: 8 aspect_ratio: '16:9' resolution: 4k responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/SubmitResponse' '400': description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 400 error: message: Invalid request parameters type: invalid_request_error '401': description: Unauthorized - Invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 error: message: Unauthorized - Invalid API key type: authentication_error components: schemas: SubmitRequest: type: object required: - model properties: model: type: string description: VEO 3.1 model identifier enum: - veo3.1-fast - veo3.1-quality callback_url: type: string format: uri description: Webhook callback URL for result notifications example: https://your-domain.com/callback input: type: object required: - prompt description: Input parameters for generation properties: prompt: type: string description: Generation prompt describing the desired output maxLength: 1000 example: A cinematic video scene image_urls: type: array items: type: string format: uri maxItems: 3 description: >- Reference image URLs for image-to-video. Supports public http/https URLs; maximum 3 images; frame mode: first image is the start frame, second image is the end frame; maximum file size 10MB; supported formats: .jpeg, .jpg, .png, .webp. example: [] generation_type: type: string description: >- Video generation type. `frame` (Frame-to-video, two images) or `reference` (Reference image video, three images). If omitted, inferred by `image_urls` count: 2 for `frame`, 3 for `reference`. enum: - frame - reference example: frame duration: type: integer description: Video duration in seconds (fixed at 8). enum: - 8 example: 8 aspect_ratio: type: string description: Video aspect ratio enum: - '16:9' - '9:16' example: '16:9' resolution: type: string description: >- Output resolution. `720p` (default), `1080p` (Full HD), or `4k` (Ultra HD). enum: - 720p - 1080p - 4k default: 720p example: 1080p SubmitResponse: type: object required: - code - data properties: code: type: integer example: 200 description: HTTP status code data: type: object required: - task_id - status - created_time properties: task_id: type: string example: task-unified-1757165031-uyujaw3d description: Unique task identifier for status tracking status: type: string enum: - not_started example: not_started description: Initial task status created_time: type: string format: date-time example: '2025-11-12T10:30:00' description: ISO 8601 timestamp when the task was created ErrorResponse: type: object required: - code - error properties: code: type: integer example: 400 description: HTTP status code error: type: object required: - message - type properties: message: type: string example: Invalid request parameters description: Error message describing what went wrong type: type: string example: invalid_request_error description: Error type identifier securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- All API endpoints require Bearer Token authentication Get your API Key: Visit the [API Key Management Page](https://poyo.ai/dashboard/api-key) to get your API Key Add it to the request header: ``` Authorization: Bearer PoYo_API_KEY ``` ````