Veo 3.1

Highest-quality AI video generation. Generate videos from text prompts or images at up to 4K resolution, 4-8 seconds.

POST/v1/media/queue

$0.25/call

Overview

Highest-quality video generation from text prompts or images. Async operation — submit a job, poll for completion.

Property	Value
Model ID	`google/veo-3`
Upstream Model	`veo-3.1-generate-preview`
Resolutions	720p, 1080p, 4K
Duration	4, 6, or 8 seconds
Pricing	$0.80/sec (720p-1080p), $1.20/sec (4K)

Usage

All media models use the async job queue. Submit a job, then poll for the result.

Step 1: Submit Job

const res = await fetch('https://api.yepapi.com/v1/media/queue', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'google/veo-3',
    prompt: 'A timelapse of a flower blooming in a garden',
    options: {
      aspectRatio: '16:9',
      resolution: '1080p',
      duration: '6',
    },
  }),
});
const { data } = await res.json();
// data.jobId — use this to poll for results

curl -X POST https://api.yepapi.com/v1/media/queue \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/veo-3", "prompt": "A timelapse of a flower blooming", "options": {"aspectRatio": "16:9", "resolution": "1080p", "duration": "6"}}'

Step 2: Poll for Result

const status = await fetch(`https://api.yepapi.com/v1/media/status/${data.jobId}`, {
  headers: { 'x-api-key': 'YOUR_API_KEY' },
});
const { data: job } = await status.json();
// job.status — "pending" | "processing" | "completed" | "failed"
// job.result.video — { mimeType, base64 } when completed

curl https://api.yepapi.com/v1/media/status/JOB_ID \
  -H "x-api-key: YOUR_API_KEY"

Request Body

Parameter	Type	Required	Description	Default
`model`	`string`	Yes	`google/veo-3`	—
`prompt`	`string`	Yes	Text description of the video	—
`options.aspectRatio`	`string`	No	`16:9` or `9:16`	`16:9`
`options.resolution`	`string`	No	`720p`, `1080p`, or `4K`	`1080p`
`options.duration`	`string`	No	`4`, `6`, or `8` (seconds)	`6`

Pricing

Resolution	Cost/sec
720p-1080p	$0.80
4K	$1.20

Example: 8-second 1080p video = 8 x $0.80 = $6.40.

Info

Latency: 11 seconds minimum, up to 6 minutes during peak. Results retained for 1 hour.

Under the Hood