Veo 3.1 Quality (per second) API

Pricing

Default example: 8-second video at 720p costs 421 credits, or $8.21 at the shared USD reference.

Accepted inputs

Kind

video

Durations

4s, 6s, 8s

Resolutions

720p, 1080p, 4k

Aspect ratios

16:9, 9:16

Defaults

8s · 720p · 16:9

Sample request

The request uses the current default settings for this model and the public GenerateMediaRequest schema.

curl -X POST "https://reviral.ai/api/v1/generate-media" \
  -H "Authorization: Bearer $REVIRAL_API_KEY" \
  -H "Idempotency-Key: first-video" \
  -H "Content-Type: application/json" \
  --data '{"model":"veo-3.1-quality-per-second","prompt":"A slow camera move across a quiet lake at sunrise","durationSec":8,"resolution":"720p","aspectRatio":"16:9","maxCredits":421}'

Response and output

{
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "kind": "video",
    "model": "veo-3.1-quality-per-second",
    "creditsCharged": 421,
    "status": "queued",
    "statusUrl": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "kind": "video",
    "model": "veo-3.1-quality-per-second",
    "creditsCharged": 421,
    "status": "ready",
    "statusUrl": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000",
    "outputUrl": "https://reviral.ai/signed-output",
    "durationSec": 8
  }
}

Error cases

• 404 model_not_available: the ID is no longer in the live catalog.
• 409 price_changed: the current cost differs from maxCredits.
• 422 validation_error: duration, resolution, aspect ratio, size, or count is not accepted.
• 429 rate_limit_exceeded: wait for Retry-After before retrying.

Frequently asked questions

How much does the Veo 3.1 Quality (per second) API cost?

The default 8-second video at 720p costs 421 credits, about $8.21 at the shared USD reference. Read the live models endpoint before submitting.

Which inputs does Veo 3.1 Quality (per second) accept?

It accepts a prompt plus the listed durations, resolutions, and aspect ratios. Reference inputs are not available through this v1 endpoint.

How do I retrieve Veo 3.1 Quality (per second) output?

Poll the returned status URL until the job is ready, then download the signed output URL or URLs before they expire.