---
title: "Start Stream Video Understanding"
method: POST
path: "/v1/understand/streamConnect"
tags: ["Stream Understanding"]
---

# Start Stream Video Understanding

`POST /v1/understand/streamConnect`

Start a real-time AI analysis session on a live RTMP video stream.

## Request body

- object
  - `url` string, required — RTMP stream URL for live video input
  - `user_prompt` string, required — Analysis instruction applied to each frame window
  - `system_prompt` string, required — Role or context for the AI
  - `callback` string, required — Public URL to receive continuous analysis results
  - `thinking` boolean — Enable reasoning mode for deeper analysis

## Response `200`

Stream started successfully

- object
  - `status` integer
  - `task_id` string
  - `text` string

---

[API](https://skmtc.net/memories/apis/screenplay-extraction-api.md) · [All operations](https://skmtc.net/memories/apis/screenplay-extraction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memories/screenplay-extraction-api/revisions/720c8c144ddc/schema)