Veo3 Video - Text to Video
Generate high-quality videos from text descriptions using Google's latest Veo3 Video model. Create stunning videos with advanced controls including aspect ratio, resolution, veo3_duration, and audio generation capabilities.
Endpoint
Request Headers
| Field | Value |
|---|---|
| API-KEY | <api-key> |
| Content-Type | application/json |
Request Parameters
| Field Name | Type | Example | Description | Required |
|---|---|---|---|---|
| type | string | TEXT_TO_VIDEO | Feature identifier | ✔️ |
| model | string | veo3 | AI model to use | ✔️ |
| conversationId | string | TEXT_TO_VIDEO | Conversation context | ✔️ |
| promptObject.prompt | string | a cat playing in the garden | Text description of the video to generate | ✔️ |
| promptObject.negativePrompt | string | wall, street | What not to include in the video | ❌ |
| promptObject.fast_mode | boolean | false | Enable fast generation mode (lower quality, faster) | ❌ |
| promptObject.generate_audio | boolean | true | Generate audio for the video | ❌ |
| promptObject.aspect_ratio | string | auto | Video aspect ratio (auto, 16:9, 9:16, 1:1) | ❌ |
| promptObject.veo3_duration | string | 8s | Video duration (8 seconds) | ❌ |
| promptObject.resolution | string | 720p | Video resolution (720p, 1080p) | ❌ |
Parameter Options
aspect_ratio:
auto- Automatically determined16:9- Widescreen format9:16- Vertical format1:1- Square format
veo3_duration:
8s- 8 second video
resolution:
720p- HD quality (1280x720)1080p- Full HD quality (1920x1080)
Code Examples
- cURL
- JavaScript
- Python
curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "TEXT_TO_VIDEO",
"model": "veo3",
"conversationId": "TEXT_TO_VIDEO",
"promptObject": {
"prompt": "a majestic eagle soaring through mountain peaks at golden hour",
"negativePrompt": "buildings, cars, people",
"fast_mode": false,
"generate_audio": true,
"aspect_ratio": "16:9",
"veo3_duration": "8s",
"resolution": "1080p"
}
}'
fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
type: 'TEXT_TO_VIDEO',
model: 'veo3-video',
conversationId: 'TEXT_TO_VIDEO',
promptObject: {
prompt: 'a majestic eagle soaring through mountain peaks at golden hour',
negativePrompt: 'buildings, cars, people',
fast_mode: false,
generate_audio: true,
aspect_ratio: '16:9',
veo3_duration: '8s',
resolution: '1080p'
}
})
})
import requests
url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}
data = {
"type": "TEXT_TO_VIDEO",
"model": "veo3-video",
"conversationId": "TEXT_TO_VIDEO",
"promptObject": {
"prompt": "a majestic eagle soaring through mountain peaks at golden hour",
"negativePrompt": "buildings, cars, people",
"fast_mode": False,
"generate_audio": True,
"aspect_ratio": "16:9",
"veo3_duration": "8s",
"resolution": "1080p"
}
}
response = requests.post(url, headers=headers, json=data)
Interactive Playground
API Playground
https://api.1min.ai/api/featuresEnable fast generation mode (lower quality, faster processing)
Include audio generation for the video
Generated cURL Command:
curl -X POST "https://api.1min.ai/api/features" \
-H "API-KEY: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"type": "TEXT_TO_VIDEO",
"model": "veo3-video",
"conversationId": "TEXT_TO_VIDEO",
"promptObject": {
"prompt": "a majestic eagle soaring through mountain peaks at golden hour",
"negativePrompt": "buildings, cars, people",
"fast_mode": false,
"generate_audio": true,
"aspect_ratio": "16:9",
"veo3_duration": "8s",
"resolution": "1080p"
}
}'
Response
{
"aiRecord": {
"uuid": "df4c388d-c755-40b6-a28c-bfac789c2c4d",
"userId": "c937fbcc-fa8f-4565-a440-c4d87f56fcb2",
"teamId": "a4e176b2-dabb-451e-9c58-62b451fa9630",
"teamUser": {
"teamId": "a4e176b2-dabb-451e-9c58-62b451fa9630",
"userId": "c937fbcc-fa8f-4565-a440-c4d87f56fcb2",
"userName": "John Doe",
"userAvatar": "https://lh3.googleusercontent.com/a/ACg8ocLqgsNsHRfmWF9d-E1RvJetVsEzxNOsOg-NXWNTpMxLDPJbwELI=s96-c",
"status": "ACTIVE",
"role": "ADMIN",
"creditLimit": 100000000,
"usedCredit": 9529078,
"createdAt": "2025-10-20T04:13:40.847Z",
"createdBy": "SYSTEM",
"updatedAt": "2025-10-22T04:13:59.504Z",
"updatedBy": "SYSTEM"
},
"model": "veo3-video",
"type": "TEXT_TO_VIDEO",
"metadata": null,
"rating": null,
"feedback": null,
"conversationId": null,
"status": "SUCCESS",
"createdAt": "2025-10-22T04:11:59.197Z",
"aiRecordDetail": {
"promptObject": {
"prompt": "a majestic eagle soaring through mountain peaks at golden hour",
"fast_mode": false,
"resolution": "1080p",
"aspect_ratio": "16:9",
"veo3_duration": "8 seconds",
"generate_audio": true,
"negativePrompt": "buildings, cars, people"
},
"resultObject": [
"development/videos/2025_10_22_11_13_52_939_591508.mp4"
],
"responseObject": {}
},
"additionalData": null,
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/videos/2025_10_22_11_13_52_939_591508.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVRUVQEFIHSKAXGE7%2F20251022%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251022T041400Z&X-Amz-Expires=604800&X-Amz-Signature=766758f68983e7ba46db8859126dcf136fc0030aee91c0a0962977a141bf5f4c&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}
Features
Advanced Controls
- Fast Mode: Toggle between quality and speed
- Audio Generation: Automatically generate matching audio
- Multiple Aspect Ratios: Support for various video formats
- Flexible veo3_duration: Choose between 8 or 16 second videos
- High Resolution: Up to 1080p output quality
Negative Prompting
Use negative prompts to exclude unwanted elements from your video generation, giving you precise control over the final output.
Quality Options
Choose between standard and fast generation modes based on your needs for quality versus processing time.