Vidu Q3 Drama API | WaveSpeedAI

Vidu Q3 Drama

Vidu Q3 Drama generates a story-driven drama video from a script and a structured asset list. It is designed for one-click drama creation: provide the story, characters, scenes, tools, and references, and the model helps organize the narrative structure, scene pacing, and final video output.

Why Choose This?

One-click drama generation
Generate a complete drama-style video in a single request instead of producing isolated clips one by one.
Script-driven storytelling
Use content to describe the full drama plot, character actions, dialogue, emotions, camera movement, and scene details.
Structured asset control
Define characters, scenes, and tools with IDs, names, types, reference images, and descriptions.
Reference-based consistency
Use asset reference images to guide character identity, scene appearance, props, and visual details.
Flexible placement control
Use image and placement to guide positioning, panorama, or step-based references.
Quality and layout options
Choose quality, resolution, aspect ratio, and style to match your drama format and visual direction.

Properties

Property	Required	Type	Description
name	Yes	string	Task name.
content	Yes	string	Full drama script or story content. Supports up to 5000 characters.
assets	Yes	array<object>	Asset list. Up to 14 assets are supported; 3–10 are recommended.
assets.id	Yes	string	Asset ID, using numeric strings such as `01`, `02`, `03`.
assets.name	Yes	string	Asset name, up to 30 characters.
assets.type	Yes	string enum	Asset type. Supported values: `character`, `scene`, `tool`.
assets.image_uri	Yes	string	Reference image for this asset. Supports public image URL or Base64 image data.
assets.description	No	string	Asset description, such as identity, appearance, age, role, scene details, or tool details.
image	No	string	Positioning reference image uploaded by the user.
placement	No	string enum	Placement mode: `upload`, `panorama`, or `step`. Default: `upload`.
quality	No	string enum	Quality level: `standard` or `high`. Default: `high`.
duration	No	integer	Duration value used for generation and pricing. Current pricing is calculated within the 2–30 second range.
resolution	No	string enum	Output resolution: `720p` or `1080p`. Default: `1080p`.
aspect_ratio	No	string enum	Output aspect ratio: `9:16` or `16:9`. Default: `9:16`.
style	No	string	Video style, such as realistic, 3D modeling, or 2D animation. Limit: 30 characters; punctuation is not recommended.

Image Requirements

assets.image_uri supports image URL or Base64 image data.
Supported image formats: PNG, JPEG, JPG, and WebP.
Base64 input should include the content type prefix, for example: data:image/png;base64,{base64_encode}.
Each asset can correspond to one image.
Keep image URLs publicly accessible.
Keep images within the documented size, aspect ratio, and request body limits.

How to Use

Enter task name — Set name for the drama generation task.
Write the story — Add the full drama script or story in content.
Add assets — Provide characters, scenes, or tools in the assets list.
Set asset IDs — Use numeric strings such as 01, 02, 03, and so on.
Upload asset images — Provide image_uri for every asset.
Add asset descriptions optional — Describe identity, appearance, scene details, or tool details.
Add positioning reference optional — Provide image and choose placement if needed.
Choose output settings — Select quality, resolution, aspect ratio, duration, and style.
Submit — Generate the drama video.

Pricing

Pricing is based on the selected duration. The rate is $0.14 per second, calculated from $1.12 per 8 seconds.

Duration	Price
2s	$0.28
5s	$0.70
8s	$1.12
10s	$1.40
15s	$2.10
20s	$2.80
30s	$4.20

Best Use Cases

Short drama generation — Create story-driven drama videos from a complete script and asset list.
Character-driven storytelling — Generate narrative clips with defined characters, scenes, tools, and references.
Story ads — Produce short promotional stories with structured characters and plot progression.
Serialized hooks — Create dramatic short-form hooks for episodic content or social platforms.
Product storytelling — Use characters, scenes, and props to present a product through a narrative format.
Creative prototyping — Quickly test story structure, scene pacing, and character presentation.

Pro Tips

Use clear asset IDs such as 01, 02, and 03 to keep references organized.
Provide 3–10 assets for better structure and easier scene planning.
Write content as a complete story, including plot, actions, emotions, dialogue, camera movement, and scene details.
Use detailed asset descriptions to clarify character identity, outfit, role, scene style, or tool appearance.
Use high quality for a more polished drama result.
Choose 9:16 for vertical short drama content and 16:9 for widescreen storytelling.
Keep style concise, such as realistic, 3D modeling, or 2D animation.

Q3 Drama API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/vidu/q3/drama with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Q3 Drama below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/vidu/q3/drama" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "image": "https://example.com/your-input.jpg",
    "placement": "panorama",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("vidu/q3/drama", {
        "image": "https://example.com/your-input.jpg",
        "placement": "panorama",
        "duration": 8,
        "resolution": "1080p",
        "aspect_ratio": "9:16"
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "vidu/q3/drama",
    {
    "image": "https://example.com/your-input.jpg",
    "placement": "panorama",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
}
)

print(output["outputs"][0])  # → URL of the generated output

Q3 Drama API — Frequently asked questions

What is the Q3 Drama API?

Q3 Drama is a Vidu model for video generation from images, exposed as a REST API on WaveSpeedAI. Vidu Q3 Drama generates complete script-driven drama videos from scripts and structured assets, including characters, scenes, tools, and references. It plans the narrative structure, scene pacing, and transitions to create a story-driven drama in one request, supporting up to 180 seconds. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Q3 Drama API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/vidu/vidu-q3-drama.

How much does Q3 Drama cost per run?

Q3 Drama starts at $1.12 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Q3 Drama accept?

Key inputs: `image`, `aspect_ratio`, `resolution`, `duration`, `assets`, `content`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/vidu/vidu-q3-drama.

How do I get started with the Q3 Drama API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Q3 Drama outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Vidu). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

ExemplesTout voir

Modèles associés

README