Vidu Q3 Turbo API

About Vidu Q3 Turbo

Vidu Q3 Turbo is the fast tier of Vidu's Q3 line and publishes two endpoints: image-to-video and video-extend. An opening frame you supply sets the subject and the output shape, the prompt directs the movement, and clips run 1 to 16 seconds at 540p or 720p with audio generated in the same pass.

Call it with the model name vidu/q3-turbo/image-to-video on POST /jobs/createTask, from 32 credits for a 5-second clip ($0.32). New accounts get 30 free credits to try it in the Playground first.

Introduction

An opening frame in image_url sets the subject and the output shape, a required prompt directs the movement, camera and sound, and clips run 1 to 16 whole seconds at 540p or 720p, with 720p as the default. Audio is generated in the same pass and stays on unless you set generate_audio to false. The tier is set up for trying many movements from one still before you commit to a delivery take.

Key features

A draft value and a delivery value

resolution takes 540p or 720p, and 720p is both the default and the ceiling on this endpoint. The two values work as a pair: 540p for passes where the movement is still being decided, 720p for the take you deliver. Because resolution is a single field, moving between them leaves the prompt, the frame and the seed untouched.

Short variants from one frame

The duration range is 1 to 16 whole seconds, and one to four seconds is the practical range for variant passes. Run a batch of short takes from the same still, each with a different single movement, and keep the ones that read well instead of writing one elaborate brief and hoping it lands.

The still settles subject and shape

Subject, wardrobe, styling, framing and output shape come from the image, not the prompt, so two runs from one frame differ in movement rather than in who is on screen. movement_amplitude sets the overall amount of movement; the prompt decides what moves. Text that argues with the still produces a clip that negotiates between the two, so keep the prompt consistent with what the frame shows.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

Each task is rounded up to whole credits, so one run at the lowest tier costs 32 credits for a 5-second clip ($0.32).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Character reaction sets

One costume still becomes a curtsy, a wink, a wave and a head tilt – four requests, same frame, four prompts. Because the image fixes identity, the set stays consistent enough to cut together in a feed.

Square and vertical social cuts

Output shape comes from the still, so a 9:16 portrait and a 1:1 square are two exports from the image pass, not two different video settings. Each animates into a 720p clip with sound already in sync.

Camera-move tests on a single still

Use the same pattern to see whether a subject holds together as the crop closes, before you write a longer brief.

Prompt guide & pro tips

Export the still at the deliverable's shape

Crop to the shape you want back – square for a square clip, vertical for a vertical one – and keep the ratio between 1:4 and 4:1. Wardrobe, styling and framing are settled at this stage, because the video pass will not change them.

Write one sequence per request

Keep the prompt to the movement, the camera and the sound, and do not re-describe the frame. The published café example runs 5 seconds at 720p with generate_audio on, from a square still of a character in a cat-ear headband holding a tray.

She walks two steps toward camera balancing the tray, does a small curtsy, winks and mouths a silent greeting, the cat-ear headband bobbing. Handheld follow that stays with her, bright café chatter and an espresso machine behind.

Five seconds at 720p from one square still. The walk, the curtsy and the wink are written; the costume and the 1:1 frame came from the image.

Ask for timing and detail in words

Slow motion has no field, so write it into the prompt. The poolside example asks for slow motion and a slow push-in as she lifts herself out onto the pool edge, and the part to watch is the wet hair swept back with both hands: strands that clump and separate correctly are what separates a take from a moving photograph.

Finish the chosen take at 720p

Once a 540p draft reads well, change resolution to 720p and keep the prompt, the frame and seed. The seed keeps the comparison fair but is not a frame-identical guarantee, so review the delivery take on its own. Leave generate_audio on for a clip that is usable as delivered, or set it to false when the cut goes under an existing mix.

API quick start

Call the Vidu Q3 Turbo API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model vidu/q3-turbo/image-to-video and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "vidu/q3-turbo/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "movement_amplitude": "auto",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Vidu Q3 Turbo API questions

All Vidu models

Vidu Q3 reaches 1080p for the final delivery; Turbo is the cheaper way to explore movements first.

• Vidu Q4 Preview APIUp to 4K clips with sound and spoken dialogueFrom 34 credits for a 5-second clip
• Vidu Q3 Turbo APIFast image animation with sound, up to 16 secondsFrom 32 credits for a 5-second clip
• Vidu Q3 APIAnimate a frame for up to 16 seconds at 1080pFrom 53 credits for a 5-second clip
• Vidu Q3 Pro APIAnimate a frame with sound on by default, up to 16 secondsFrom 41 credits for a 5-second clip

Other video APIs

• MiniMax H3 APIExpressive clips with audio, up to 2KFrom 28 credits for a 5-second clip
• Seedance 2.5 APIByteDance's newest: 30-second clips with native audioFrom 56 credits for a 5-second clip
• Kling 3.0 API4K clips, multi-shot cuts and motion controlFrom 51 credits for a 5-second clip
• Wan 3.0 APIUp to 30-second clips with synced audioFrom 34 credits for a 5-second clip
• Kling O3 APIKling’s unified model: create, animate, reference and edit up to 4KFrom 51 credits for a 5-second clip
• MiniMax H3 Max APIFast clips with ambience, effects and musicFrom 38 credits for a 5-second clip

More about Vidu Q3 Turbo

Try it

Vidu Q3 Turbo Image to Video AI onlineCreate videos with Vidu Q3 Turbo in PopNow

Docs

Vidu Q3 Turbo model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage to video guide for the PopNow APIWebhooks: get Vidu Q3 Turbo results without polling