ToAPIs
home

快速结论

  • viduq3-pro-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 | 必填 | viduq3-pro-fast | - | Model identifier. Use the fixed value `viduq3-pro-fast`.
  • prompt | string | 必填 | - | - | Main instruction describing the subject, action, scene, and style.
  • aspect_ratio | string | 可选 | 16:9 | 16:9 | 9:16 | Video aspect ratio. Defaults to `16:9`; supports `16:9 | 9:16`.
  • duration | integer | 可选 | 5 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | Output duration in seconds. Defaults to `5`; supports `1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16`.
  • resolution | string | 可选 | 720P | 720P | 1080P | Output resolution. Defaults to `720P`; supports `720P | 1080P`.

常见错误

  • 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.
返回模型广场

模型解析页

viduq3-pro-fast

viduq3-pro-fast is provided by Vidu with Video capabilities. Current pricing reference: 7.5 credits /second. This page helps you understand positioning, parameters, and production-ready use cases before integration.

厂商

Vidu

能力

Video

价格

7.5 credits /second

更新

2026-07-21

在 Playground 中打开文档

模型概览

快速结论

  • viduq3-pro-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.

viduq3-pro-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.

如何使用 viduq3-pro-fast API

  1. Fill prompt and key parameters.
  2. Run, inspect output structure, then iterate.
  3. Move stable settings into production API.

关键参数

参数类型必填默认值取值范围说明
modelstring是viduq3-pro-fast-Model identifier. Use the fixed value `viduq3-pro-fast`.
promptstring是--Main instruction describing the subject, action, scene, and style.
aspect_ratiostring否16:916:9 | 9:16Video aspect ratio. Defaults to `16:9`; supports `16:9 | 9:16`.
durationinteger否51 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16Output duration in seconds. Defaults to `5`; supports `1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16`.
resolutionstring否720P720P | 1080POutput resolution. Defaults to `720P`; supports `720P | 1080P`.

常见错误

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.

FAQ

When should I use viduq3-pro-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 轮询状态，详细以对应文档为准。

準備好開始了嗎？

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

免費開始查看定價