The "Short Drama · Film Narration Intelligence" operator can automatically build a plot event index based on multiple episodes of short dramas or a single movie, and plan jump-cut narration videos according to story clues within three approximate duration ranges: short, mid, and long. The operator automatically completes video editing, narration script generation, TTS voiceover, subtitle generation, audio mixing and rendering, and result uploading. It supports narration in both Chinese and English, optional reference audio voice cloning, as well as subtitle background and position control. Each task produces highlight narration material suitable for distribution on video platforms.

Operator ID: las_short_drama_highlight_narration

Applicable scenarios #

• Short drama distribution material production: Generates highlight narration videos based on short drama materials, which can be used for promotion on video platforms.
• Film secondary creation: Identifies narratable plot clues from movies or long videos and generates narration shorts suitable for short video dissemination.

Core capabilities #

• Cross-episode plot understanding: Automatically analyzes multiple episodes of short dramas or movie materials to extract key events, character relationships, conflict progression, and visual highlights.
• Clue discovery and selection: Discovers and selects candidate clues suitable for generating highlight narration, including the main storyline, character lines, conflict lines, and relationship lines.
• Multilingual narration: Supports generating Chinese or English narration via narration_language.
• TTS voice control: Supports providing reference audio via tts_clone_prompt_audio_url; if not provided, the default voice of the execution service is used.
• Subtitle style and position control: Supports selecting semi-transparent blur, white rounded, or black rounded subtitle backgrounds, and controlling subtitle position via subtitle_position.
• Distribution-oriented dense narration: By default, generates narration scripts with a tight rhythm, hooks at the beginning, and suspense at the end, and automatically completes TTS voiceover and subtitle rendering.

Effect demonstration #

Supported regions #

• Beijing: cn-beijing

Operator performance #

Input requirements #

Output requirements #

• Billing standards

  Sub-items	Billing standards description
  Billing items	There are two billing items: Input original video understanding fee and Output narration video fee. The actual task cost generated by the operator is the sum of the two billing items. Input original video understanding fee: Billed based on the total duration of all input original videos. Output narration video fee: Billed based on the total duration of all output narration videos. You can quickly view the duration (in seconds) of each output video using the duration_s parameter returned by the poll interface.
  Billing type	Usage-based billing, unit: CNY/minute, billed hourly based on actual usage. Billing precision: millisecond-level precision, rounded down
  Unit price	The unit price varies for different sub-billing items. Details are as follows.

• Billing details
  Billing formula: Total cost = Input original video understanding fee + Output narration video fee

  Sub-billing items	Subdivision	Unit price
  Input original video understanding fee	Input original video [0min, 60min] segment	0.2 CNY/minute
  	Input original video segment exceeding 60min	0.3 CNY/minute
  Output narration video fee	Not applicable	1.2 CNY/minute

• Billing example

  • Example scenario: 30 short drama videos of 3 minutes each are input, and after operator processing, 20 narration videos of 1 minute each are output.
  • Cost details:
    • Total duration of all input original videos = 30 * 3 minutes = 90 minutes;
    • Total duration of all output narration videos = 20 * 1 minute = 20 minutes;
    • Total cost = Input original video understanding fee + Output narration video fee
      = (60 minutes * 0.2 CNY/minute + 30 minutes * 0.3 CNY/minute) + 20 minutes * 1.2 CNY/minute
      = 45 CNY

• Billing unit
  The billing unit displayed in the billing details for charges incurred by invoking this operator is "Script Generation". Please pay attention to this difference when reviewing your bill.

API invocation instructions #

• The API for this operator is an asynchronous task interface. You need to submit a task via the Submit interface to obtain the task's task_id, then use the Poll interface to check the status of the corresponding task (task_id) and retrieve the operator's processing result.
• Caution: After submitting a task, the task_id is valid for 3 days. After 3 days, you will not be able to use this task_id to obtain the operator's processing result.

Submit #

Interface instructions #

Submit a "Short Drama · Film Commentary Intelligent Creation" task. After a successful submission, a task ID is returned. You can query the task status and retrieve the generated video via the Poll interface.

Request parameters #

Response parameters #

Example #

Request example

# Optional: Set OUTPUT_TOS_PATH to a TOS directory writable by this account
export OUTPUT_TOS_PATH="tos://bucket/output/highlight_narration/"
# Optional: Set TTS voice cloning reference audio; if not set, please remove the corresponding field from the request
export TTS_CLONE_PROMPT_AUDIO_URL="tos://bucket/audio/voice.wav"

curl --location "https://operator.las.cn-beijing.volces.com/api/v1/submit" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $LAS_API_KEY" \
--data '{
    "operator_id": "las_short_drama_highlight_narration",
    "operator_version": "v1",
    "pending_timeout_minutes": 120,
    "data": {
        "input_videos": [
            "https://${LAS_TOS_BUCKET}.${TOS_ENDPOINT}/operator_cards_serving/public/${LAS_ENVIRONMENT}/las_short_drama_highlight_narration/v1/episode_01.mp4",
            "https://${LAS_TOS_BUCKET}.${TOS_ENDPOINT}/operator_cards_serving/public/${LAS_ENVIRONMENT}/las_short_drama_highlight_narration/v1/episode_02.mp4"
        ],
        "target_narration_duration": "short",
        "narration_language": "zh",
        "subtitle_blur_mode": "gaussian",
        "subtitle_position": "bottom",
        "tts_clone_prompt_audio_url": "$TTS_CLONE_PROMPT_AUDIO_URL",
        "output_tos_path": "$OUTPUT_TOS_PATH"
    }
}'

Response example

{
  "metadata": {
    "task_id": "task-20260715120000-abc123",
    "task_status": "PENDING",
    "business_code": "0",
    "error_msg": "",
    "request_id": "20260819120000ABCDEF"
  }
}

Error code #

Failures in media download, format/duration/size validation, model processing, voice reference audio, and TOS read/write are considered asynchronous task failures and will not be returned as synchronous HTTP 400 responses in the Submit response after successful acceptance. Please use Poll to obtain the business code and error information returned by the execution side.

Poll #

Interface instructions #

Query the execution status and result of the "Short Drama · Film Commentary Intelligent Creation" task. Once the task is completed, you can obtain the generated video.

Request parameters #

Response parameters #

Example #

Request example

curl --location "https://operator.las.cn-beijing.volces.com/api/v1/poll" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $LAS_API_KEY" \
--data '{
    "operator_id": "las_short_drama_highlight_narration",
    "operator_version": "v1",
    "task_id": "task-20260715120000-abc123"
}'

Response example

{
  "metadata": {
    "task_id": "task-20260715120000-abc123",
    "task_status": "COMPLETED",
    "business_code": "0",
    "error_msg": "",
    "request_id": "20260819120500ABCDEF",
    "submit_time": "2026-08-19T12:00:00+08:00",
    "end_time": "2026-08-19T12:05:00+08:00"
  },
  "data": {
    "videos": [
      {
        "video_id": "v_main_storyline_01",
        "duration_s": 95.1,
        "final_video_path": "tos://bucket/output/highlight_narration/main_storyline/v_main_storyline_01/final.mp4",
        "final_video_url": "https://example.com/final_01.mp4"
      }
    ]
  }
}

Error code #

Asynchronous execution failures are also returned via HTTP 200 in the Poll response: metadata.task_status is FAILED, EXPIRED, CANCELLED, or TIMEOUT. The business code and error information provided by the execution side are retained in metadata.business_code and metadata.error_msg. Do not determine task success solely based on the HTTP status of Poll.