Veo3 Video - Image to Video
Transform static images into dynamic videos using Google's advanced Veo3 video generation model with comprehensive control over video quality, duration, and audio generation.
Note: Image files must first be uploaded using the Asset API before processing. The imageUrl parameter should contain the path returned from the Asset API upload.
Endpoint
Request Headers
| Field | Value |
|---|---|
| API-KEY | <api-key> |
| Content-Type | application/json |
Request Parameters
| Field Name | Type | Example | Description | Required |
|---|---|---|---|---|
| type | string | IMAGE_TO_VIDEO | Feature identifier | ✔️ |
| model | string | veo3 | AI model to use | ✔️ |
| conversationId | string | IMAGE_TO_VIDEO | Conversation context | ✔️ |
| promptObject.imageUrl | string | images/example.jpg | Source image path from Asset API upload | ✔️ |
| promptObject.prompt | string | gentle waves moving | Text description of desired motion/scene | ✔️ |
| promptObject.fast_mode | boolean | true | Enable fast generation mode for quicker results | ❌ |
| promptObject.generate_audio | boolean | true | Generate audio for the video | ❌ |
| promptObject.aspect_ratio | string | 16:9 | Video aspect ratio | ❌ |
| promptObject.veo3_duration | string | 8s | Video duration | ❌ |
| promptObject.resolution | string | 1080p | Video resolution quality | ❌ |
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": "IMAGE_TO_VIDEO",
"model": "veo3-video",
"conversationId": "IMAGE_TO_VIDEO",
"promptObject": {
"imageUrl": "images/2025_10_22_08_29_30_730_cat.png",
"fast_mode": true,
"generate_audio": true,
"aspect_ratio": "16:9",
"veo3_duration": "8s",
"resolution": "1080p",
"prompt": "hello"
}
}'
fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
type: 'IMAGE_TO_VIDEO',
model: 'veo3-video',
conversationId: 'IMAGE_TO_VIDEO',
promptObject: {
imageUrl: 'images/2025_10_22_08_29_30_730_cat.png',
fast_mode: true,
generate_audio: true,
aspect_ratio: '16:9',
veo3_duration: '8s',
resolution: '1080p',
prompt: 'hello'
}
})
})
import requests
url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}
data = {
"type": "IMAGE_TO_VIDEO",
"model": "veo3-video",
"conversationId": "IMAGE_TO_VIDEO",
"promptObject": {
"imageUrl": "images/2025_10_22_08_29_30_730_cat.png",
"fast_mode": True,
"generate_audio": True,
"aspect_ratio": "16:9",
"veo3_duration": "8s",
"resolution": "1080p",
"prompt": "hello"
}
}
response = requests.post(url, headers=headers, json=data)
Interactive Playground
API Playground
https://api.1min.ai/api/featuresPath to the source image file uploaded via Asset API
Describe the motion and animation you want to see in the video
Enable fast generation mode for quicker results with slightly lower quality
Generate accompanying audio for the video
Choose the aspect ratio for your video output
Choose the duration for your generated video
Choose the video resolution quality
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": "IMAGE_TO_VIDEO",
"model": "veo3-video",
"conversationId": "IMAGE_TO_VIDEO",
"promptObject": {
"imageUrl": "images/2025_10_22_08_29_30_730_cat.png",
"fast_mode": true,
"generate_audio": true,
"aspect_ratio": "16:9",
"veo3_duration": "8s",
"resolution": "1080p",
"prompt": "hello"
}
}'
Response
{
"aiRecord": {
"uuid": "73ae328e-9fa2-492a-be60-7b9b98909471",
"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": 25491660,
"createdAt": "2025-10-20T04:13:40.847Z",
"createdBy": "SYSTEM",
"updatedAt": "2025-10-22T08:31:13.089Z",
"updatedBy": "SYSTEM"
},
"model": "veo3-video",
"type": "IMAGE_TO_VIDEO",
"metadata": null,
"rating": null,
"feedback": null,
"conversationId": null,
"status": "SUCCESS",
"createdAt": "2025-10-22T08:36:21.976Z",
"aiRecordDetail": {
"promptObject": {
"prompt": "hello",
"imageUrl": "images/2025_10_22_08_29_30_730_cat.png",
"fast_mode": true,
"resolution": "1080p",
"aspect_ratio": "16:9",
"veo3_duration": "8s",
"generate_audio": true
},
"resultObject": [
"development/videos/2025_10_22_15_39_03_377_651521.mp4"
],
"responseObject": {}
},
"additionalData": null,
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/videos/2025_10_22_15_39_03_377_651521.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=20251022T083909Z&X-Amz-Expires=604800&X-Amz-Signature=d35bc5d4b8fc4b383b1029b4a730315a69a86b18c077e8f1c459f91fa2584f21&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}