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

POSThttps://api.1min.ai/api/features

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.task_type	string	veo3-video	Model variant to use (see available task types below)	❌
promptObject.generate_audio	boolean	true	Generate audio for the video	❌
promptObject.aspect_ratio	string	16:9	Video aspect ratio (16:9, 9:16, 1:1)	❌
promptObject.veo3_duration	string	8s	Video duration (8s)	❌
promptObject.resolution	string	720p	Video resolution (720p, 1080p)	❌
promptObject.reference_image_urls	string[]	["images/ref1.jpg"]	Reference images for style/content (max 3, only with 8s duration & 16:9 ratio)	❌

Parameter Options

task_type (Model Variants):

• veo3-video - Standard quality Veo3 (default)
• veo3-video-fast - Fast generation mode (lower quality, faster processing)
• veo3.1-video - Veo3.1 model for enhanced quality
• veo3.1-video-fast - Veo3.1 fast mode

aspect_ratio:

• 16:9 - Widescreen format (default)
• 9:16 - Vertical format
• 1:1 - Square format

veo3_duration:

• 8s - 8 second video

resolution:

• 720p - HD quality (1280x720, default)
• 1080p - Full HD quality (1920x1080)

reference_image_urls:

• Array of up to 3 image URLs for style/content reference
• Only supported when duration is 8s and aspect_ratio is 16:9
• Images must be uploaded via Asset API first

Code Examples

cURL

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",
  "task_type": "veo3-video",
  "generate_audio": true,
  "aspect_ratio": "16:9",
  "veo3_duration": "8s",
  "resolution": "1080p"
}
}'

JavaScript

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',
    task_type: 'veo3-video',
    generate_audio: true,
    aspect_ratio: '16:9',
    veo3_duration: '8s',
    resolution: '1080p'
  }
})
})

Python

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",
  "task_type": "veo3-video",
  "generate_audio": True,
  "aspect_ratio": "16:9",
  "veo3_duration": "8s",
  "resolution": "1080p"
}
}

response = requests.post(url, headers=headers, json=data)

Interactive Playground

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/features

AI Model *Google Veo3 Video

Video Description *a majestic eagle soaring through mountain peaks at golden hour

Negative Prompt buildings, cars, people

Model Variant

Choose model variant - Standard for quality, Fast for speed, 3.1 for latest features

Veo3 StandardVeo3 Fast ModeVeo3.1 StandardVeo3.1 Fast Mode

Generate Audio

Include audio generation for the video

YesNo

Aspect Ratio 16:9 (Widescreen)9:16 (Vertical)1:1 (Square)

veo3_duration 8 seconds

Resolution 720p (HD)1080p (Full HD)

Reference Images

Comma-separated image URLs for reference (max 3, only with 8s & 16:9)

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",
    "task_type": "veo3-video",
    "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"
}
}