vidu-q3 API
Vidu Q3 已通过 API in One 接入真实生产路由 /api/v1/videos/generations,后端节点为 node66。一个 API Key 即可调用并按成功请求计费。
请求体中的 model 字段。
当前已实现的 BFF 路由。
输入类型:text, image
密钥由共享 Dashboard 管理。
该路由不依赖 webhook。
服务亮点
用市场页形式展示真实已接入能力,不复用外部平台的 SLA、折扣或账号流程。
当前页面只展示已在 /api/v1 中实现的端点。 /api/v1/videos/generations
该模型直接返回响应,不需要创建媒体任务。
充值、订单、积分余额和个人资料继续使用现有共享控制台与旧逻辑。
浏览器只持有 API in One Key,上游 Provider 调用由服务端处理。
调用契约
复制这些字段即可接入当前真实模型路由。
- Base URL
https://apiin.one客户端调用同源 API,服务端 BFF 转发到 Worker。- 鉴权
Authorization: Bearer <API_KEY>由现有 Dashboard API Keys 页面管理。- Model 字段
vidu-q3放在请求体 model 字段中。- 结果查询
/api/v1/tasks/{task_id}异步任务返回 task_id 后查询。- 计费入口
/billing/credits使用现有积分、订单和充值旧逻辑。
运行方式
该模型创建异步任务,返回 task_id 后通过真实状态接口取回结果。
API Console
像模型市场一样直接切换同端点真实模型、端点和语言,右侧示例由当前 live catalog 的 payload 生成。
curl --request POST \
--url https://apiin.one/api/v1/videos/generations \
--header 'Authorization: Bearer <API_KEY>'
--header 'Content-Type: application/json' \
--data-raw '{
"model": "vidu-q3",
"prompt": "A woman walking through a rainy city street with neon reflections, cinematic",
"resolution": "720p",
"duration": 5,
"style": "general",
"generate_audio": true
}'/api/v1/tasks/{task_id}端点评估
基于当前真实 endpoint 下的已上线模型,快速判断成本、供应商覆盖和生产接入方式。
按基础积分从低到高排序。
异步媒体和工具任务使用 /api/v1/tasks/{task_id} 查询结果;对话模型直接返回响应。
真实能力
以下能力来自当前已接入的模型配置和后端路由,不展示未上线 API。
稳定生产路由
Superior character consistency across frames
统一接口
Anime and general style modes
透明计费
Audio and BGM generation support
快速接入
Movement amplitude control for motion intensity
请求方式
浏览器端只调用同源 API,服务端 BFF 再转发到对应 Worker。
参数
promptstringText description of the video to generate
必填imagestringReference image URL for image-to-video mode
可选resolutionstringOutput resolution: "540p", "720p", or "1080p"
可选 · 默认 720pdurationnumberVideo duration in seconds (1–16)
可选 · 默认 5aspect_ratiostringAspect ratio: 16:9, 9:16, 4:3, 3:4, 1:1
可选stylestringVisual style: "general" or "anime"
可选 · 默认 generalmovement_amplitudestringMotion intensity: "auto", "small", "medium", "large"
可选 · 默认 autogenerate_audiobooleanGenerate audio in the video. Enabled by default; disable it to halve Q3 base pricing.
可选 · 默认 truebgmbooleanAdd background music
可选 · 默认 falseseednumberRandom seed for reproducibility
可选示例请求
curl -X POST https://apiin.one/api/v1/videos/generations \
-H "Authorization: Bearer aio_your_api_key" \
-H "Content-Type: application/json" \
--data-raw '{
"model": "vidu-q3",
"prompt": "A woman walking through a rainy city street with neon reflections, cinematic",
"resolution": "720p",
"duration": 5,
"style": "general",
"generate_audio": true
}'同端点可切换模型
这些模型使用同一个已实现 BFF endpoint,可通过请求体中的 model 字段切换。
同端点模型对比
同一个真实路由下的模型差异,便于按成本、输入输出和后端节点选择。
node66
grok-videoxAI异步任务text + image -> video24 积分$0.24node31🎞️ltx-2LightTricks / WaveSpeed异步任务text + image + video + audio -> video24 积分$0.24node50node38node51
wan-2-6Alibaba异步任务text + image + video -> video80 积分$0.80node35node65
kling-3Kuaishou异步任务text + image -> video300 积分$3.00node75接入流程
这些步骤基于当前真实路由和共享账号体系,不新增独立登录、支付或订单流程。
创建共享 API Key
在现有 Dashboard 创建密钥,充值、订单、积分和个人信息仍走共享控制台。
调用真实端点
使用当前页面列出的 endpoint、model id 和参数发送请求。 /api/v1/videos/generations
查询任务状态
异步媒体和工具任务使用 /api/v1/tasks/{task_id} 查询结果;对话模型直接返回响应。
任务状态查询
图像、视频、音频和工具任务创建后,使用真实任务端点查询结果。
GET/api/v1/tasks/{task_id}查询生成任务状态和结果。价格
16–620 credits per video (~$0.16–$6.20); default 720p 5s Q3 with audio is 300 credits
使用场景
这些场景可通过当前模型和对应后端节点实现。
Create character-consistent video clips for storytelling
Generate animated scenes from reference images
Build AI video features into creative applications
Produce social media video content at scale
常见问题
How much does the Vidu Q3 API cost?
Pricing depends on resolution, model family, duration, and audio. For Q3 without audio, 540p 5s costs 70 credits, 720p 5s costs 150 credits, and 1080p 5s costs 180 credits. Audio doubles the cost; the default 720p 5s request with audio costs 300 credits.
What makes Vidu Q3 different?
Vidu Q3 excels at character consistency, anime-style generation, and supports movement amplitude control and audio/BGM generation.
Does Vidu Q3 support image-to-video?
Yes. Provide a reference image to animate into a video while preserving the subject's appearance.
What styles does Vidu Q3 support?
Vidu Q3 supports "general" and "anime" styles for different visual outputs.