Quick Answer

  • Veo3 1 Quality Official supports Text-to-Video, Image-to-Video, R2V, and Video Edit in one workflow.
  • Use this model guide page to validate parameters with minimal request/response examples.
  • Stabilize prompts here first, then move to production API integration.

Key Parameters

  • model | string | required | veo3-1-quality-official | - | Model identifier. Use exact API value.
  • mode | enum | required | text-to-video | text-to-video | image-to-video | r2v | video-edit | Selects generation/edit workflow.
  • input.prompt | string | required | - | - | Main instruction for output content and style.
  • input.duration | integer | optional | 5 | 2-15 | Output duration in seconds.
  • input.seed | integer | optional | - | >=0 | Improves reproducibility across runs.

Common Errors

  • 400 invalid_request_error: trigger=Request payload misses required fields or has invalid field types.; fix=Validate model, mode, and input schema before request.; retry=Retry only after fixing payload; avoid blind retries.
  • 401 authentication_error: trigger=Missing Authorization header or invalid API key.; fix=Verify Bearer token format and API key scope.; retry=Retry after auth fix; rotate key if repeated failures continue.
  • 429 rate_limit_exceeded: trigger=Request rate, concurrency, or current quota hits upstream rate limiting.; fix=Apply exponential backoff first, then review request rate, concurrency, and quota usage.; retry=Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.
  • 500 internal_error: trigger=Transient upstream error or internal processing failure.; fix=Capture request id and trigger retry workflow.; retry=Retry 2-3 times with short delays; escalate if persistent.

Model Guide

Veo3 1 Quality Official

Model ID: veo3-1-quality-official

Vendor: Google (Gemini)Modalities: VideoPrice: $0.1600 /secondUpdated: 2026-05-02

Veo3 1 Quality Official is provided by Google (Gemini) with Video capabilities. Current pricing reference: $0.1600 /second. This page helps you understand positioning, parameters, and production-ready use cases before integration.

Model Overview

Quick Answer

  • Veo3 1 Quality Official supports Text-to-Video, Image-to-Video, R2V, and Video Edit in one workflow.
  • Use this model guide page to validate parameters with minimal request/response examples.
  • Stabilize prompts here first, then move to production API integration.

Veo3 1 Quality Official Model Features

Core Section

Core capabilities and practical engineering value

Unified multi-mode testing

Switch across Text-to-Video, Image-to-Video, R2V, and Video Edit in one place.

Parameter-first validation

Iterate quickly on prompts, durations, and references before production rollout.

Production-ready handoff

Minimal request/response structure helps you move stable configs into API workflows.

How to Use Veo3 1 Quality Official API

  1. Select a mode (Text-to-Video / Image-to-Video / R2V / Video Edit).
  2. Fill prompt, references, and key parameters.
  3. Run, inspect output structure, then iterate.
  4. Move stable settings into production API.
Veo3 1 Quality Official

When to Use

  • When you need fast iteration across multiple generation modes.
  • When you need to validate parameters and error handling before integration.

Runtime Behavior

  • This model guide page is optimized for interaction and parameter rehearsal.
  • The output panel demonstrates task result structure for integration guidance.
Veo3 1 Quality Official

Key Parameters

ParameterTypeRequiredDefaultRangeDescription
modelstringYesveo3-1-quality-official-Model identifier. Use exact API value.
modeenumYestext-to-videotext-to-video | image-to-video | r2v | video-editSelects generation/edit workflow.
input.promptstringYes--Main instruction for output content and style.
input.durationintegerNo52-15Output duration in seconds.
input.seedintegerNo->=0Improves reproducibility across runs.

Common Errors

400 invalid_request_error

Trigger: Request payload misses required fields or has invalid field types.

Fix: Validate model, mode, and input schema before request.

Retry: Retry only after fixing payload; avoid blind retries.

401 authentication_error

Trigger: Missing Authorization header or invalid API key.

Fix: Verify Bearer token format and API key scope.

Retry: Retry after auth fix; rotate key if repeated failures continue.

429 rate_limit_exceeded

Trigger: Request rate, concurrency, or current quota hits upstream rate limiting.

Fix: Apply exponential backoff first, then review request rate, concurrency, and quota usage.

Retry: Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.

500 internal_error

Trigger: Transient upstream error or internal processing failure.

Fix: Capture request id and trigger retry workflow.

Retry: Retry 2-3 times with short delays; escalate if persistent.

Veo3 1 Quality Official

FAQ

When should I use Veo3 1 Quality Official?

Use it to validate video concepts quickly, compare mode behavior, and converge prompts before API rollout.

How do I choose Text-to-Video vs Image-to-Video?

Use Text-to-Video when you only have instructions; use Image-to-Video when you already have key frames or composition.

What is the difference between R2V and Video Edit?

R2V focuses on reference-guided generation, while Video Edit focuses on modifying existing video assets.

Image or video model error: invalid apitype: -1

This usually means the request was sent to the wrong endpoint. Image and video models typically do not use the chat endpoint. Instead, submit the documented HTTP task request and poll the task status endpoint for results. Check the actual request code, URL, and payload first.

An image or video task failed, but the user was still charged

Ask the user for the task log or screenshot first and check whether input or output token usage appears. If token accounting shows up, the request was likely sent through a chat endpoint instead of the proper media workflow. Image and video models usually run as async HTTP task APIs: submit the task first, then poll by task id according to the relevant docs.

Mode Notes

Text to Video with Veo3 1 Quality Official

Generate videos directly from prompts.

Mode Parameters

promptnegative_promptdurationratioseed

Best Scenarios

  • Ad storyboard preview
  • Shot draft generation
  • Social content prototyping

Image to Video with Veo3 1 Quality Official

Animate still images with motion prompts.

Mode Parameters

image_urlpromptdurationcamera_motionstrength

Best Scenarios

  • Product image animation
  • Character photo motion
  • Poster-to-video

R2V with Veo3 1 Quality Official

Reference-guided generation with stronger consistency.

Mode Parameters

reference_urlpromptstrengthdurationseed

Best Scenarios

  • Brand style consistency
  • Character consistency
  • Multi-shot continuity

Video Edit with Veo3 1 Quality Official

Edit and enhance existing video assets.

Mode Parameters

video_urlinstructiondurationedit_regionoutput_quality

Best Scenarios

  • Style transfer
  • Localized edit
  • Post enhancement

Related APIs

今すぐ始めませんか?

無料登録して、エンタープライズ級 AI API ゲートウェイの実力を体験してください

ToAPIs

エンタープライズ向け AI API ゲートウェイ。GPT-5、Claude、Gemini など 50 以上のモデルに 1 つの API でアクセスできます。

会社情報

法務

© 2026 ToAPIs. All rights reserved.

すべてのシステムは正常に稼働中