> ## Documentation Index > Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt > Use this file to discover all available pages before exploring further. # veo-3.1-generate-001 > API usage guide for veo-3.1-generate-001. {/* source_model_id: veo-3.1-generate-001 */} {/* source_updated_at: 1781741007 */} **Model ID** ```bash theme={null} veo-3.1-generate-001 ``` **Calling method:** async # veo-3.1-generate-001 API Usage Guide ## Overview **Veo 3.1** is Google's latest video generation model . It supports generating videos from text prompts, animating a single reference image, and generating videos guided by both a first and last frame. It offers 16:9 and 9:16 aspect ratios, durations of 4/6/8 seconds, and produces 24 FPS videos at 720p, 1080p, or 4K resolution (availability may vary by feature). ## Authentication All API requests require authentication using an API key. Include your API key in the Authorization header: ```bash theme={null} Authorization: Bearer YOUR_API_KEY ``` ## Submit Video Generation Request ### Base URL ``` https://console.gmicloud.ai ``` ### Endpoint ``` POST /api/v1/ie/requestqueue/apikey/requests ``` ### Request Format ```bash theme={null} curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "veo-3.1-generate-001", "payload": { "prompt": "A majestic eagle soaring through a mountain landscape at sunset", "reference_image": "https://example.com/reference_image.jpg", "image": "https://example.com/image.jpg", "lastFrame": "https://example.com/lastFrame.jpg", "durationSeconds": 6, "aspectRatio": "16:9", "generateAudio": true, "negativePrompt": "blurry, low quality, distorted", "personGeneration": "allow_all", "seed": 0, "resolution": "1080p" } }' ``` ### Request Parameters | Parameter | Type | Required | Description | Default | Constraints | | ------------------ | ------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------- | | `prompt` | string | Yes | Text description of the video to generate (max 2000 characters). Describe scenes, actions, camera moves, and visual style. | - | Required | | `reference_image` | string | No | Provide up to three images of a single person, character, or product. Veo preserves the subject's appearance in the output video.The aspect ratio MUST be 16:9 if a reference image is provided. Reference images will be ignored if a frame image is provided. Supported formats: jpeg, png, webp. | - | Max 3 images | | `image` | string | No | Optional first frame for two-frame guided video generation. Supported formats: JPEG/PNG/WebP. | - | Max 1 image | | `lastFrame` | string | No | Optional last frame for two-frame guided video generation. Supported formats: JPEG/PNG/WebP. | - | Max 1 image | | `durationSeconds` | integer | No | Video length in seconds (4, 6, or 8). Reference image to video only supports 8 seconds. | 6 | Options: "4, 6, 8 | | `aspectRatio` | string | No | Aspect ratio of the generated video. Some features may restrict supported aspect ratios. | "16:9" | Options: "16:9", "9:16" | | `generateAudio` | boolean | No | Whether generate audio. | true | Optional | | `negativePrompt` | string | No | Describe what you don't want to see in the video (max 500 characters). | - | Optional | | `personGeneration` | string | No | Control whether people can appear in the video. | "allow\_all" | Options: "allow\_all", "allow\_adult", "disallow" | | `seed` | integer | No | Random seed for reproducibility. Leave empty for random results. | - | Range: 0 to 4294967295 | | `resolution` | string | No | Output video resolution. Higher resolutions take longer to generate. | "720p" | Options: "720p", "1080p", "4k" | ### Response ```json theme={null} { "request_id": "550e8400-e29b-41d4-a716-446655440000", "model": "veo-3.1-generate-001", "status": "queued", "created_at": 1750442925, "updated_at": 1750442925, "queued_at": 1750442925 } ``` ## Check Request Status ### Endpoint ``` GET /api/v1/ie/requestqueue/apikey/requests/{request_id} ``` ### Example ```bash theme={null} curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Response ```json theme={null} { "request_id": "550e8400-e29b-41d4-a716-446655440000", "org_id": "your-org-id", "user_id": "your-user-id", "model": "veo-3.1-generate-001", "status": "success", "is_public": false, "payload": { "prompt": "A majestic eagle soaring through a mountain landscape at sunset", "reference_image": "https://example.com/reference_image.jpg", "image": "https://example.com/image.jpg", "lastFrame": "https://example.com/lastFrame.jpg", "durationSeconds": 6, "aspectRatio": "16:9", "generateAudio": true, "negativePrompt": "blurry, low quality, distorted", "personGeneration": "allow_all", "seed": 0, "resolution": "1080p" }, "outcome": { "video_url": "https://storage.googleapis.com/bucket/generated-video.mp4", "thumbnail_image_url": "https://storage.googleapis.com/bucket/thumbnail.jpg" }, "created_at": 1750442925, "updated_at": 1750442930, "queued_at": 1750442925 } ``` ## Request Status Values | Status | Description | | ------------ | --------------------------------------- | | `queued` | Request is waiting to be processed | | `processing` | Video generation is in progress | | `success` | Video generation completed successfully | | `failed` | Video generation failed | | `cancelled` | Request was cancelled | ## List Your Requests ### Endpoint ``` GET api/v1/ie/requestqueue/apikey/requests?model_id=veo-3.1-generate-001 ``` ### Example ```bash theme={null} curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=veo-3.1-generate-001" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ## Get Model Information ### Endpoint ``` GET /api/v1/ie/requestqueue/apikey/models/veo-3.1-generate-001 ``` ### Example ```bash theme={null} curl -X GET "https://api.example.com/api/v1/apikey/models/veo-3.1-generate-001" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ## List Available Models ### Endpoint ``` GET /api/v1/apikey/models ``` ### Example ```bash theme={null} curl -X GET "https://api.example.com/api/v1/apikey/models" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Response ```json theme={null} { "model_ids": [ "veo-3.1-generate-001", "other-model-1", "other-model-2" ] } ``` ## Pricing * **Pricing Type**: Video length based pricing * **Unit Price**: \$0.40 per second ## Tips for Better Results 1. **Clear, Descriptive Prompts**: Use specific, detailed descriptions for better video quality 2. **Negative Prompts**: Specify unwanted elements to improve quality