Vidu Q3 API — AI Video Generation | Character-Consistent Video API

Provider

Shengshu Technology

Pricing

70–720+ credits per video

Speed

60–180 seconds

Output

video

Quick Start

Send a request to the Vidu Q3 API:

bash

curl -X POST https://apiin.one/api/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "vidu-q3",
  "prompt": "A woman walking through a rainy city street with neon reflections, cinematic",
  "resolution": "720p",
  "duration": 5,
  "style": "general"
}'

API Endpoint

POST/api/v1/videos/generationsVidu Q3

Send a POST request with your API key to generate content using Vidu Q3.

Headers

Header	类型	必填	描述
`Authorization`	string	必填	Bearer YOUR_API_KEY
`Content-Type`	string	必填	application/json

Body Parameters

参数	类型	必填	描述
`model`	string	必填	Model identifier: "vidu-q3"
`prompt`	string	必填	Text description of the video to generate
`image`	string	可选	Reference image URL for image-to-video mode
`resolution`	string	可选	Output resolution: "540p", "720p", or "1080p" (默认值: 720p)
`duration`	number	可选	Video duration in seconds (1–16) (默认值: 5)
`aspect_ratio`	string	可选	Aspect ratio: 16:9, 9:16, 4:3, 3:4, 1:1
`style`	string	可选	Visual style: "general" or "anime" (默认值: general)
`movement_amplitude`	string	可选	Motion intensity: "auto", "small", "medium", "large" (默认值: auto)
`generate_audio`	boolean	可选	Generate audio in the video (默认值: false)
`bgm`	boolean	可选	Add background music (默认值: false)
`seed`	number	可选	Random seed for reproducibility

Example Request

json

{
  "model": "vidu-q3",
  "prompt": "A woman walking through a rainy city street with neon reflections, cinematic",
  "resolution": "720p",
  "duration": 5,
  "style": "general"
}

Example Response

Successful task creation response.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n66xxxx_viduq3",
    "status": "IN_PROGRESS"
  }
}

Check Task Status

For asynchronous tasks, poll the status endpoint to check when your task is complete:

GET/api/v1/tasks/{task_id}Poll task status

Returns the current status of a generation task. Poll until status is 'completed' or 'failed'.

bash

curl https://apiin.one/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer aio_your_key"

Use Cases

✓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

API Tester

Test the Vidu Q3 API directly from your browser:

API 测试沙盒POST

基础 URL

端点

请求头

请求体

Error Codes

{
  "error": {
    "code": 400,
    "message": "Invalid parameters",
    "type": "invalid_request"
  }
}

Frequently Asked Questions

How much does the Vidu Q3 API cost?

Pricing depends on resolution and duration. For example: 540p 5s costs 70 credits, 720p 5s costs 150 credits, 1080p 5s costs 260 credits. Each additional second adds 30–60 credits.