vidu/short-play-q3-drama

POST

/openapi/v2/vidu/short-play-q3-drama

Vidu Q3 Drama is built for short-form serial storytelling. Submit your script plus character, scene, and prop references to generate a complete episode with native audio-visual sync—ideal for vertical dramas, comic-style series, and narrative ads that need consistent casting and pacing.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "scriptName": "Su Wan's Cozy Afternoon",
    "scriptContent": "Character: Su Wan\\n[Visual Style: Healing realistic photography, warm yellow soft lighting, cozy indoor setting with vintage items, gentle and peaceful atmosphere]\\n\\nShot 1-1: (2s Medium Shot Eye-level Fixed)\\n@Su Wan sits by the window, gently wiping a floral ceramic teacup with a soft smile.\\n@Su Wan: A quiet afternoon, just me and my favorite teacup.\\n\\nShot 1-2: (2s Close-up High-angle Fixed)\\nShe gently places a carved handmade silver bracelet on the wooden table, the silver light catching the warm sun.\\n@Su Wan: This little bracelet always brings me comfort.\\n\\nShot 1-3: (2s Medium Shot Side-angle Fixed)\\n@Su Wan puts on the silver bracelet, raising her hand to admire it in the sunlight, smiling sweetly.\\n@Su Wan: So beautiful, it feels like a warm hug.\\n\\nShot 1-4: (2s Medium Shot Eye-level Fixed)\\nShe holds the warm teacup with both hands, looking out the window with a peaceful expression.\\n@Su Wan: Time slows down when I'm all by myself.\\n\\nShot 1-5: (2s Close-up Eye-level Fixed)\\n@Su Wan turns to the camera, her eyes sparkling with gentle joy.\\n@Su Wan: Wishing everyone a beautiful and peaceful day!",
    "assets": [
        "Example text"
    ],
    "placement": "upload",
    "duration": "5",
    "resolution": "1080p",
    "aspectRatio": "9:16",
    "style": "Realistic Photography"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.runninghub.ai/openapi/v2/vidu/short-play-q3-drama' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "scriptName": "Su Wan'\''s Cozy Afternoon",
    "scriptContent": "Character: Su Wan\\n[Visual Style: Healing realistic photography, warm yellow soft lighting, cozy indoor setting with vintage items, gentle and peaceful atmosphere]\\n\\nShot 1-1: (2s Medium Shot Eye-level Fixed)\\n@Su Wan sits by the window, gently wiping a floral ceramic teacup with a soft smile.\\n@Su Wan: A quiet afternoon, just me and my favorite teacup.\\n\\nShot 1-2: (2s Close-up High-angle Fixed)\\nShe gently places a carved handmade silver bracelet on the wooden table, the silver light catching the warm sun.\\n@Su Wan: This little bracelet always brings me comfort.\\n\\nShot 1-3: (2s Medium Shot Side-angle Fixed)\\n@Su Wan puts on the silver bracelet, raising her hand to admire it in the sunlight, smiling sweetly.\\n@Su Wan: So beautiful, it feels like a warm hug.\\n\\nShot 1-4: (2s Medium Shot Eye-level Fixed)\\nShe holds the warm teacup with both hands, looking out the window with a peaceful expression.\\n@Su Wan: Time slows down when I'\''m all by myself.\\n\\nShot 1-5: (2s Close-up Eye-level Fixed)\\n@Su Wan turns to the camera, her eyes sparkling with gentle joy.\\n@Su Wan: Wishing everyone a beautiful and peaceful day!",
    "assets": [
        "Example text"
    ],
    "placement": "upload",
    "duration": "5",
    "resolution": "1080p",
    "aspectRatio": "9:16",
    "style": "Realistic Photography"
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Bodyapplication/json

Examples

Submit response exampleTask success response example

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

Modified at 2026-07-30 07:05:33

rh-video-upscaler

kling-o3/element