> This page is for version v1.3 (default).
> For other versions, use one of these documentation indexes:
> - v1.3 (default): https://docs.twelvelabs.io/v1.3/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.twelvelabs.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.twelvelabs.io/_mcp/server.

## Combined video hours limit on the Free plan

The Free plan now includes a single 10-hour limit shared across indexing and video analysis. Previously, only indexing hours counted toward this limit. You can split the 10 hours however you choose between indexing and analysis.

For details, see the [Frequently asked questions](/v1.3/docs/resources/frequently-asked-questions#what-are-the-video-hours-and-video-count-limits-per-index) page.

## Video segmentation pricing update for paid plans

On paid plans, video segmentation pricing now factors in the number of segment definitions per request. The cost equals the billable video duration multiplied by the number of segment definitions. If you provide the [`start_time`](/v1.3/api-reference/analyze-videos/create-async-analysis-task#request.body.start_time) and [`end_time`](/v1.3/api-reference/analyze-videos/create-async-analysis-task#request.body.end_time) parameters, the billable duration covers that time range only. Otherwise, it covers the full video duration.

On the Free plan, the number of segment definitions does not affect your limit.

For details and examples, see the [Frequently asked questions](/v1.3/docs/resources/frequently-asked-questions#how-is-video-segmentation-priced) page.

## SDK support for Pegasus 1.5

All Pegasus 1.5 features are now available in the Python and Node.js SDKs. Upgrade to the latest version:

**`Python SDK`**

```sh Python SDK
pip install --upgrade twelvelabs
```

**`Node.js SDK`**

```sh Node.js SDK
npm install twelvelabs-js@latest
```

### Breaking changes

The following change requires updates to your code when you upgrade the SDK:

* **ResponseFormat type split**: The `ResponseFormat` type has been split into `SyncResponseFormat` (for sync analysis) and `AsyncResponseFormat` (for async analysis). Update your imports and type references. See the [Pegasus 1.2 to 1.5 migration guide](/v1.3/docs/get-started/migration-guides/pegasus-1-2-to-1-5) for details.

### New features

The following features are opt-in. Your existing code continues to work without changes.

* **Video segmentation**: Extract structured, timestamped metadata with custom segment definitions. See the [Segment videos](/v1.3/docs/guides/segment-videos) guide.
* **Structured prompts with reference images**: Use the `prompt_v2` parameter to include up to 4 reference images in your prompt.
* **Video clipping**: Use the `start_time` and `end_time` parameters to analyze a specific portion of the video.
* **Per-definition time ranges for segmentation**: Restrict segment extraction to specific time windows within the video.

### Enhancements

The following improvements take effect automatically. No code changes required.

* **Analysis task response echo**: The `request_params` object in task responses now includes the full set of parameters you submitted when creating the task.
* **Longer responses**: Pegasus 1.5 supports responses up to 98,304 tokens (raised from 65,536 on [May 28, 2026](/docs/get-started/release-notes/2026/5/28)).
* **Custom task identifier**: Attach a custom identifier to async analysis tasks to correlate them across responses.

For migration instructions, see the [Migration guides](/v1.3/docs/get-started/migration-guides). For details about each feature, see the original announcements on [April 20](/docs/get-started/release-notes/2026/4/20), [April 27](/docs/get-started/release-notes/2026/4/27#2026-04-27-general-analysis-for-pegasus-15), and [May 7](/docs/get-started/release-notes/2026/5/6).