Vidu Q3 Pro API
Vidu Q3 Pro API on APIMart (model ID viduq3-pro, often written vidu-q3-pro): ShengShu's Vidu model for text to video, image to video and first-and-last-frame video, with 1–16 second clips at 540p, 720p or 1080p and generated dialogue and sound effects on by default. It is the higher tier of the Vidu Q3 Pro and Turbo pair.
Service Highlights
- Official Discounts
- Pay-as-you-go
- Fast & Low Latency
Video link valid for 72 hours
Vidu Q3 Pro API Pricing
Transparent pricing with no hidden fees. Pay only for what you use.
| Variant | Tier | GoldCurrent price | Platinum | Diamond | Official | Your savings |
|---|---|---|---|---|---|---|
viduq3-pro | 540P | 0.56Credits(~$0.056)/sec | 0.532Credits(~$0.0532)/sec | 0.504Credits(~$0.0504)/sec | 0.7Credits(~$0.07)/sec | 20% |
| 720P | 1.2Credits(~$0.12)/sec | 1.14Credits(~$0.114)/sec | 1.08Credits(~$0.108)/sec | 1.5Credits(~$0.15)/sec | 20% | |
| 1080P | 1.28Credits(~$0.128)/sec | 1.216Credits(~$0.1216)/sec | 1.152Credits(~$0.1152)/sec | 1.6Credits(~$0.16)/sec | 20% |
* Actual costs are subject to final output.
Vidu Q3 Pro API: text, image and first-last frame to video
Create Vidu Q3 Pro videos online in the generator above or call the API from your app. Send a prompt for text to video, one image for image to video, or two images for a first and last frame. Choose 1–16 seconds at 540p, 720p or 1080p; audio is on by default.
50K+
Active Users
99.9%
Uptime
2x
Faster
—
Cost Savings
Vidu Q3 Pro API Example: Text to Video and Image to Video
Call Vidu Q3 Pro on APIMart with one POST request. Generation is asynchronous: submit a task, then poll the task endpoint to get the video URL.
- 1
Authenticate Vidu Q3 Pro API requests
Save your APIMart key in the APIMART_API_KEY environment variable and send it as Authorization: Bearer <key> on every request.
- 2
Submit a Vidu Q3 Pro task
POST /v1/videos/generations with model viduq3-pro and the inputs shown in the example. The task ID is in data[0].task_id.
- 3
Get the Vidu Q3 Pro video
Poll GET /v1/tasks/{task_id} until status is completed, then read the video URL from data.result.videos[0].url[0]. Results are kept for 72 hours, so download them in time.
See the Vidu Q3 Pro API reference for every parameter, input rule and response field.
curl -X POST https://api.apimart.ai/v1/videos/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "viduq3-pro",
"prompt": "A paper boat sails down a rain-soaked street, camera tracking low, soft rain sounds",
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9",
"audio": true
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "viduq3-pro",
"prompt": "A paper boat sails down a rain-soaked street, camera tracking low, soft rain sounds",
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9",
"audio": True
}
resp = requests.post(f"{API_BASE}/v1/videos/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["videos"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(10)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/videos/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "viduq3-pro",
"prompt": "The scene comes to life as the camera slowly pulls back",
"image_urls": [
"https://example.com/first-frame.jpg"
],
"duration": 5,
"resolution": "1080p",
"audio": true
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"Vidu Q3 Pro API Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Required | Default: — | Use viduq3-pro. |
prompt | string | Required | Default: — | Up to 2,000 characters. Send a prompt in every mode, including image to video and first-last frame. |
image_urls | string[] | Optional | Default: — | Leave out for text to video, 1 image for image to video, 2 images for first and last frame. |
duration | integer | Optional | Default: 5 | Clip length in seconds: 1–16. Default 5. |
resolution | string | Optional | Default: 720p | Output resolution: 540p, 720p or 1080p. Default 720p. |
aspect_ratio | string | Optional | Default: — | 16:9, 9:16, 4:3, 3:4 or 1:1, text to video only. With images, the image sets the ratio. |
audio | boolean | Optional | Default: true | Generate dialogue and sound effects. Default true; false returns a silent video. |
seed | integer | Optional | Default: — | Integer seed that controls randomness. Omit it for a random seed. |
Vidu API Model Family
Compare every Vidu video model on APIMart. One API key calls all of them, billed per second of video.
| Model | Best for | Resolution | Duration |
|---|---|---|---|
| Vidu Q4 Preview API | Newest generation: animate a first frame, or combine 1–15 reference images with up to 3 audio clips | 540p – 4K | 3–16s |
| Vidu Q3 Pro APIThis page | Text-to-video, image-to-video and first-last frame, with audio on by default | 540p / 720p / 1080p | 1–16s |
| Vidu Q3 Turbo API | Same modes as Vidu Q3 Pro at the lowest per-second rate in the Vidu series | 540p / 720p / 1080p | 1–16s |
| Vidu Q3 API | Everyday reference-to-video from 1–7 images, with smart multi-angle camera switching | 540p / 720p / 1080p | 3–16s |
| Vidu Q3 Mix API | Premium reference-to-video from 1–7 images, with stronger smart transitions and short motion effects | 720p / 1080p | 1–16s |
