ToAPIs

快速结论

  • Veo3 1 Fast 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.

关键参数

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

常见错误

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

模型解析页

Veo3 1 Fast

模型 ID: veo3-1-fast

厂商: Google (Gemini)能力类型: Video价格: $0.0800 /request更新于: 2026-05-02

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

在 Playground 中打开文档

模型概览

快速结论

  • Veo3 1 Fast 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 Fast模型特点

核心能力

能力一览与工程实践价值

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.

如何使用 Veo3 1 Fast 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 Fast

适用场景

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

API 运行特性

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

关键参数

参数类型必填默认值取值范围说明
modelstring是veo3-1-fast-Model identifier. Use exact API value.
modeenum是text-to-videotext-to-video | image-to-video | r2v | video-editSelects generation/edit workflow.
input.promptstring是--Main instruction for output content and style.
input.durationinteger否52-15Output duration in seconds.
input.seedinteger否->=0Improves reproducibility across runs.

常见错误

400 invalid_request_error

触发条件: Request payload misses required fields or has invalid field types.

修复建议: Validate model, mode, and input schema before request.

重试策略: Retry only after fixing payload; avoid blind retries.

401 authentication_error

触发条件: Missing Authorization header or invalid API key.

修复建议: Verify Bearer token format and API key scope.

重试策略: Retry after auth fix; rotate key if repeated failures continue.

429 rate_limit_exceeded

触发条件: Request rate, concurrency, or current quota hits upstream rate limiting.

修复建议: Apply exponential backoff first, then review request rate, concurrency, and quota usage.

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

500 internal_error

触发条件: Transient upstream error or internal processing failure.

修复建议: Capture request id and trigger retry workflow.

重试策略: Retry 2-3 times with short delays; escalate if persistent.

Veo3 1 Fast

FAQ

When should I use Veo3 1 Fast?

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.

图像视频模型报错：invalid apitype: -1

这类错误通常说明接口走错了。图像和视频模型一般不走 chat 接口，而是按对应文档发起 HTTP 任务请求，并通过任务状态接口轮询结果。排查时建议先看用户的实际请求代码、请求地址和请求体。

用户进行生成图片/视频的任务时出现任务失败，但是扣款

先让用户提供任务日志或截图，重点看是否出现了输入或输出 token 统计。如果有这类 token 记录，大概率是用户把图片/视频模型走成了 chat 接口；这不是正确用法。图片和视频模型通常是异步任务接口，需要通过 HTTP 请求先提交任务，再拿到任务 ID 轮询状态，详细以对应文档为准。

模式说明

Text to Video 模式（Veo3 1 Fast）

Generate videos directly from prompts.

模式参数

promptnegative_promptdurationratioseed

最佳应用场景

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

Image to Video 模式（Veo3 1 Fast）

Animate still images with motion prompts.

模式参数

image_urlpromptdurationcamera_motionstrength

最佳应用场景

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

R2V 模式（Veo3 1 Fast）

Reference-guided generation with stronger consistency.

模式参数

reference_urlpromptstrengthdurationseed

最佳应用场景

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

Video Edit 模式（Veo3 1 Fast）

Edit and enhance existing video assets.

模式参数

video_urlinstructiondurationedit_regionoutput_quality

最佳应用场景

  • Style transfer
  • Localized edit
  • Post enhancement

相关 API

準備好開始了嗎？

免費註冊，立即體驗企業级 AI API 網關的強大功能

免費開始查看定價