Release notes

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 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 and 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 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:

pip install --upgrade twelvelabs

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 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 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).
• Custom task identifier: Attach a custom identifier to async analysis tasks to correlate them across responses.

For migration instructions, see the Migration guides. For details about each feature, see the original announcements on April 20, April 27, and May 7.