twelvelabs-js 1.2.3 → 1.2.5

package/api/resources/analyzeAsync/resources/tasks/client/Client.js

@@ -74,7 +74,8 @@ class Tasks {
      *         status: "queued",
      *         videoUrl: "https://example.com/video.mp4",
      *         assetId: "69abc123def456789012abcd",
-     *         analysisMode: "time_based_metadata"
+     *         videoId: "6298d673f1090f1100476d4c",
+     *         analysisMode: "general"
      *     })
      */
     list(request = {}, requestOptions) {
@@ -83,7 +84,7 @@ class Tasks {
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b;
-            const { page, pageLimit, status, videoUrl, assetId, analysisMode } = request;
+            const { page, pageLimit, status, videoUrl, assetId, videoId, analysisMode } = request;
             const _queryParams = {};
             if (page != null) {
                 _queryParams["page"] = page.toString();
@@ -102,17 +103,20 @@ class Tasks {
             if (assetId != null) {
                 _queryParams["asset_id"] = assetId;
             }
+            if (videoId != null) {
+                _queryParams["video_id"] = videoId;
+            }
             if (analysisMode != null) {
                 _queryParams["analysis_mode"] = serializers.analyzeAsync.TasksListRequestAnalysisMode.jsonOrThrow(analysisMode, { unrecognizedObjectKeys: "strip" });
             }
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, "analyze/tasks"),
                 method: "GET",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.5", "User-Agent": "twelvelabs-js/1.2.5", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
@@ -157,7 +161,7 @@ class Tasks {
         });
     }
     /**
-     * This method asynchronously analyzes your videos. It supports two modes: general analysis (prompt-based text generation) with Pegasus 1.2 and video segmentation with Pegasus 1.5.
+     * This method asynchronously analyzes your videos. It supports two analysis modes: general analysis (prompt-based text generation) and video segmentation with custom segment definitions. Video segmentation requires Pegasus 1.5.
      *
      * <Accordion title="Input requirements">
      * - Minimum duration: 4 seconds
@@ -168,8 +172,8 @@ class Tasks {
      * </Accordion>
      *
      * **When to use this method**:
-     * - Generate custom text from your video using a prompt (Pegasus 1.2 only)
-     * - Extract timestamped metadata with custom fields from your video (Pegasus 1.5 only)
+     * - Generate custom text from your video using a prompt (general analysis)
+     * - Extract timestamped metadata with custom segment definitions from your video (Pegasus 1.5 only)
      * - Analyze videos longer than 1 hour
      * - Process videos asynchronously without blocking your application
      *
@@ -194,6 +198,7 @@ class Tasks {
      *
      * @example
      *     await client.analyzeAsync.tasks.create({
+     *         customId: "prod-segment-analysis-42",
      *         video: {
      *             type: "url",
      *             url: "https://example.com/video.mp4"
@@ -234,6 +239,130 @@ class Tasks {
      *         minSegmentDuration: 5,
      *         maxSegmentDuration: 30
      *     })
+     *
+     * @example
+     *     await client.analyzeAsync.tasks.create({
+     *         modelName: "pegasus1.5",
+     *         video: {
+     *             type: "url",
+     *             url: "https://example.com/video.mp4"
+     *         },
+     *         prompt: "Summarize the key events in this clip.",
+     *         maxTokens: 4096,
+     *         startTime: 10,
+     *         endTime: 60
+     *     })
+     *
+     * @example
+     *     await client.analyzeAsync.tasks.create({
+     *         modelName: "pegasus1.5",
+     *         video: {
+     *             type: "url",
+     *             url: "https://example.com/video.mp4"
+     *         },
+     *         analysisMode: "time_based_metadata",
+     *         responseFormat: {
+     *             type: "segment_definitions",
+     *             segmentDefinitions: [{
+     *                     id: "scenes",
+     *                     description: "Scene changes.",
+     *                     timeRanges: [{
+     *                             startTime: 0,
+     *                             endTime: 4
+     *                         }, {
+     *                             startTime: 10,
+     *                             endTime: 14
+     *                         }]
+     *                 }]
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.analyzeAsync.tasks.create({
+     *         modelName: "pegasus1.5",
+     *         video: {
+     *             type: "url",
+     *             url: "https://example.com/video.mp4"
+     *         },
+     *         analysisMode: "time_based_metadata",
+     *         responseFormat: {
+     *             type: "segment_definitions",
+     *             segmentDefinitions: [{
+     *                     id: "scenes",
+     *                     description: "Detect scenes and label them.",
+     *                     fields: [{
+     *                             name: "label",
+     *                             type: "string",
+     *                             description: "A short label for this scene."
+     *                         }, {
+     *                             name: "highlight_at",
+     *                             type: "timestamp",
+     *                             description: "The single most representative moment in this scene.",
+     *                             format: "seconds"
+     *                         }]
+     *                 }],
+     *             segmentTimeFormat: "hh:mm:ss"
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.analyzeAsync.tasks.create({
+     *         modelName: "pegasus1.5",
+     *         video: {
+     *             type: "url",
+     *             url: "https://example.com/video.mp4"
+     *         },
+     *         promptV2: {
+     *             inputText: "Is there a <@tiger-1> in the video?",
+     *             mediaSources: [{
+     *                     name: "tiger-1",
+     *                     mediaType: "image",
+     *                     url: "https://example.com/tiger.jpg"
+     *                 }]
+     *         },
+     *         maxTokens: 4096
+     *     })
+     *
+     * @example
+     *     await client.analyzeAsync.tasks.create({
+     *         modelName: "pegasus1.5",
+     *         video: {
+     *             type: "url",
+     *             url: "https://example.com/video.mp4"
+     *         },
+     *         prompt: "Identify intro, main content, and outro clips.",
+     *         responseFormat: {
+     *             type: "json_schema",
+     *             jsonSchema: {
+     *                 "type": "object",
+     *                 "properties": {
+     *                     "clip_start": {
+     *                         "type": "timestamp",
+     *                         "format": "seconds"
+     *                     },
+     *                     "events": {
+     *                         "type": "array",
+     *                         "items": {
+     *                             "type": "object",
+     *                             "properties": {
+     *                                 "intro_end": {
+     *                                     "type": "timestamp",
+     *                                     "format": "hh:mm:ss"
+     *                                 },
+     *                                 "outro_start": {
+     *                                     "type": "timestamp",
+     *                                     "format": "hh:mm:ss.fff"
+     *                                 },
+     *                                 "label": {
+     *                                     "type": "string"
+     *                                 }
+     *                             }
+     *                         }
+     *                     }
+     *                 }
+     *             }
+     *         }
+     *     })
      */
     create(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
@@ -244,13 +373,13 @@ class Tasks {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, "analyze/tasks"),
                 method: "POST",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.5", "User-Agent": "twelvelabs-js/1.2.5", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.analyzeAsync.CreateAsyncAnalyzeRequest.jsonOrThrow(request, {
                     unrecognizedObjectKeys: "strip",
                 }),
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
@@ -325,10 +454,10 @@ class Tasks {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `analyze/tasks/${encodeURIComponent(taskId)}`),
                 method: "GET",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.5", "User-Agent": "twelvelabs-js/1.2.5", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
@@ -393,10 +522,10 @@ class Tasks {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `analyze/tasks/${encodeURIComponent(taskId)}`),
                 method: "DELETE",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.5", "User-Agent": "twelvelabs-js/1.2.5", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 600000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });

package/api/resources/analyzeAsync/resources/tasks/client/requests/CreateAsyncAnalyzeRequest.d.ts

@@ -5,6 +5,7 @@ import * as TwelvelabsApi from "../../../../../../index";
 /**
  * @example
  *     {
+ *         customId: "prod-segment-analysis-42",
  *         video: {
  *             type: "url",
  *             url: "https://example.com/video.mp4"
@@ -45,23 +46,158 @@ import * as TwelvelabsApi from "../../../../../../index";
  *         minSegmentDuration: 5,
  *         maxSegmentDuration: 30
  *     }
+ *
+ * @example
+ *     {
+ *         modelName: "pegasus1.5",
+ *         video: {
+ *             type: "url",
+ *             url: "https://example.com/video.mp4"
+ *         },
+ *         prompt: "Summarize the key events in this clip.",
+ *         maxTokens: 4096,
+ *         startTime: 10,
+ *         endTime: 60
+ *     }
+ *
+ * @example
+ *     {
+ *         modelName: "pegasus1.5",
+ *         video: {
+ *             type: "url",
+ *             url: "https://example.com/video.mp4"
+ *         },
+ *         analysisMode: "time_based_metadata",
+ *         responseFormat: {
+ *             type: "segment_definitions",
+ *             segmentDefinitions: [{
+ *                     id: "scenes",
+ *                     description: "Scene changes.",
+ *                     timeRanges: [{
+ *                             startTime: 0,
+ *                             endTime: 4
+ *                         }, {
+ *                             startTime: 10,
+ *                             endTime: 14
+ *                         }]
+ *                 }]
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         modelName: "pegasus1.5",
+ *         video: {
+ *             type: "url",
+ *             url: "https://example.com/video.mp4"
+ *         },
+ *         analysisMode: "time_based_metadata",
+ *         responseFormat: {
+ *             type: "segment_definitions",
+ *             segmentDefinitions: [{
+ *                     id: "scenes",
+ *                     description: "Detect scenes and label them.",
+ *                     fields: [{
+ *                             name: "label",
+ *                             type: "string",
+ *                             description: "A short label for this scene."
+ *                         }, {
+ *                             name: "highlight_at",
+ *                             type: "timestamp",
+ *                             description: "The single most representative moment in this scene.",
+ *                             format: "seconds"
+ *                         }]
+ *                 }],
+ *             segmentTimeFormat: "hh:mm:ss"
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         modelName: "pegasus1.5",
+ *         video: {
+ *             type: "url",
+ *             url: "https://example.com/video.mp4"
+ *         },
+ *         promptV2: {
+ *             inputText: "Is there a <@tiger-1> in the video?",
+ *             mediaSources: [{
+ *                     name: "tiger-1",
+ *                     mediaType: "image",
+ *                     url: "https://example.com/tiger.jpg"
+ *                 }]
+ *         },
+ *         maxTokens: 4096
+ *     }
+ *
+ * @example
+ *     {
+ *         modelName: "pegasus1.5",
+ *         video: {
+ *             type: "url",
+ *             url: "https://example.com/video.mp4"
+ *         },
+ *         prompt: "Identify intro, main content, and outro clips.",
+ *         responseFormat: {
+ *             type: "json_schema",
+ *             jsonSchema: {
+ *                 "type": "object",
+ *                 "properties": {
+ *                     "clip_start": {
+ *                         "type": "timestamp",
+ *                         "format": "seconds"
+ *                     },
+ *                     "events": {
+ *                         "type": "array",
+ *                         "items": {
+ *                             "type": "object",
+ *                             "properties": {
+ *                                 "intro_end": {
+ *                                     "type": "timestamp",
+ *                                     "format": "hh:mm:ss"
+ *                                 },
+ *                                 "outro_start": {
+ *                                     "type": "timestamp",
+ *                                     "format": "hh:mm:ss.fff"
+ *                                 },
+ *                                 "label": {
+ *                                     "type": "string"
+ *                                 }
+ *                             }
+ *                         }
+ *                     }
+ *                 }
+ *             }
+ *         }
+ *     }
  */
 export interface CreateAsyncAnalyzeRequest {
     /**
      * The video understanding model to use for analysis.
-     * - `pegasus1.2` (default): Analyzes pre-indexed videos. Pass a `video_id` to reference your video.
-     * - `pegasus1.5`: Analyzes videos directly from a URL, asset, or base64 string. Supports video segmentation with custom segment definitions.
+     * - `pegasus1.2`: General analysis (prompt-based text generation).
+     * - `pegasus1.5`: General analysis (prompt-based text generation) with video clipping, structured prompts with reference images, and video segmentation. See the [Pegasus](/v1.3/docs/concepts/models/pegasus#context-window) page for token limits.
+     *
+     * **Default:** `pegasus1.2`
      */
     modelName?: TwelvelabsApi.analyzeAsync.CreateAsyncAnalyzeRequestModelName;
+    /**
+     * An optional identifier that you set when you create the task. Use this field to correlate tasks across responses, for example, to distinguish tasks by type or environment.
+     *
+     * The platform stores this value unchanged and returns it in the following responses:
+     * - The [`GET`](/v1.3/api-reference/analyze-videos/retrieve-analysis-task-status-results) method of the `/analyze/tasks/{task_id}` endpoint
+     * - The [`GET`](/v1.3/api-reference/analyze-videos/list-async-analysis-tasks) method of the `/analyze/tasks` endpoint
+     * - The `analyze.task.ready` and `analyze.task.failed` webhook payloads
+     *
+     * **Format**: 1–64 characters. Alphanumeric, hyphens (`-`), and underscores (`_`) only. An empty string is rejected with a `400 Bad Request`.
+     *
+     * This field does not enforce uniqueness. You can submit multiple tasks with the same `custom_id`. To prevent duplicate task creation, use an `Idempotency-Key` header instead.
+     */
+    customId?: string;
     video: TwelvelabsApi.VideoContext;
     /**
-     * A natural-language text that provides instructions for analyzing the video. Required for general-mode analysis. Not supported when `analysis_mode` is `time_based_metadata`.
+     * Natural-language instructions for analyzing the video. Required for general analysis (prompt-based text generation). Not supported when `analysis_mode` is `time_based_metadata`. To include reference images in your prompt, use the `prompt_v2` parameter instead (Pegasus 1.5 only). Mutually exclusive with the `prompt_v2` parameter.
      *
-     * <Note title="Notes">
-     * - Even though the model behind this endpoint is trained to a high degree of accuracy, the preciseness of the generated text may vary based on the nature and quality of the video and the clarity of the prompt.
-     * - Your prompts can be instructive or descriptive, or you can also phrase them as questions.
-     * - The maximum length of a prompt is 2,000 tokens.
-     * </Note>
+     * Your prompts can be instructive or descriptive, or you can phrase them as questions. Pegasus 1.2 limits prompts to 2,000 tokens. For Pegasus 1.5, this text counts toward the [context window](/v1.3/docs/concepts/models/pegasus#context-window).
      *
      * **Examples**:
      *
@@ -69,26 +205,64 @@ export interface CreateAsyncAnalyzeRequest {
      * - I want to generate a description for my video with the following format: Title of the video, followed by a summary in 2-3 sentences, highlighting the main topic, key events, and concluding remarks.
      */
     prompt?: string;
-    /** Sets the analysis mode to `time_based_metadata`, which segments your video into time-based intervals and extracts custom metadata for each segment. Requires `model_name` set to `pegasus1.5` and `response_format.type` set to `segment_definitions`. */
+    /**
+     * A structured prompt with `<@name>` placeholders for referencing images. Requires the `model_name` parameter set to `pegasus1.5`. Mutually exclusive with the `prompt` parameter.
+     *
+     * The prompt text and reference images count toward the [context window](/v1.3/docs/concepts/models/pegasus#context-window).
+     */
+    promptV2?: TwelvelabsApi.AnalyzePromptV2;
+    /**
+     * The analysis approach for this task.
+     * - `general`: Analyze the video and generate a response based on your prompt. Supports both free-form text and structured output via `response_format`.
+     * - `time_based_metadata`: Segment the video into time-based intervals and extract custom metadata for each segment. Requires `model_name` set to `pegasus1.5` and `response_format.type` set to `segment_definitions`.
+     *
+     * **Default:** `general`
+     */
     analysisMode?: TwelvelabsApi.analyzeAsync.CreateAsyncAnalyzeRequestAnalysisMode;
     temperature?: TwelvelabsApi.AnalyzeTemperature;
     /**
-     * The maximum number of tokens to generate. The allowed range depends on the model:
-     * - `pegasus1.2`: **Min:** 1, **Max:** 4,096
-     * - `pegasus1.5`: **Min:** 2,048, **Max:** 32,768, **Default:** 32,768
+     * The maximum response length, in tokens. The allowed range depends on the model and analysis mode:
+     *
+     * | Model | Mode | Min | Max | Default |
+     * |-------|------|-----|-----|---------|
+     * | Pegasus 1.2 | — | 1 | 4,096 | 4096 |
+     * | Pegasus 1.5 | `general` | 512 | 98,304 | 4,096 |
+     * | Pegasus 1.5 | `time_based_metadata` | 2,048 | 98,304 | 32,768 |
      */
     maxTokens?: number;
     responseFormat?: TwelvelabsApi.AsyncResponseFormat;
     /**
-     * Minimum duration for each extracted segment, in seconds. Set this to prevent the model from creating very short segments. Requires `model_name` set to `pegasus1.5` and `analysis_mode` set to `time_based_metadata`.
+     * Minimum duration for each extracted segment, in seconds. Set this value to enforce a minimum segment length. Requires `model_name` set to `pegasus1.5` and `analysis_mode` set to `time_based_metadata`. Mutually exclusive with `response_format.segment_definitions[].time_ranges`.
      *
      * **Min:** 2
      */
     minSegmentDuration?: number;
     /**
-     * Maximum duration for each extracted segment, in seconds. Set this to break long continuous sections into shorter segments. Must be greater than or equal to `min_segment_duration`. Requires `model_name` set to `pegasus1.5` and `analysis_mode` set to `time_based_metadata`.
+     * Maximum duration for each extracted segment, in seconds. Set this value to split long continuous sections into shorter segments. Must be greater than or equal to `min_segment_duration`. Requires `model_name` set to `pegasus1.5` and `analysis_mode` set to `time_based_metadata`. Mutually exclusive with `response_format.segment_definitions[].time_ranges`.
      *
      * **Min:** 2
      */
     maxSegmentDuration?: number;
+    /**
+     * Start of the analysis window, in seconds. Use with `end_time` to analyze only a portion of the video. Requires `model_name` set to `pegasus1.5`.
+     *
+     * <Note title="Notes">
+     * - If omitted, defaults to `0`.
+     * - Must be less than `end_time` and less than the video duration. The clip (`end_time - start_time`) must be at least `4` seconds.
+     * - Mutually exclusive with `response_format.segment_definitions[].time_ranges`.
+     * - Together with `end_time`, this parameter determines the billable video duration. If you omit both, billing uses the full video duration. For details, see the [Frequently asked questions](/v1.3/docs/resources/frequently-asked-questions#how-is-video-segmentation-priced) page.
+     * </Note>
+     */
+    startTime?: number;
+    /**
+     * End of the analysis window, in seconds. Use with `start_time` to analyze only a portion of the video. Requires `model_name` set to `pegasus1.5`.
+     *
+     * <Note title="Notes">
+     * - If omitted, defaults to the video duration.
+     * - Must be greater than `start_time` and less than or equal to the video duration. The clip (`end_time - start_time`) must be at least `4` seconds.
+     * - Mutually exclusive with `response_format.segment_definitions[].time_ranges`.
+     * - Together with `start_time`, this parameter determines the billable video duration. If you omit both, billing uses the full video duration. For details, see the [Frequently asked questions](/v1.3/docs/resources/frequently-asked-questions#how-is-video-segmentation-priced) page.
+     * </Note>
+     */
+    endTime?: number;
 }

package/api/resources/analyzeAsync/resources/tasks/client/requests/TasksListRequest.d.ts

@@ -10,7 +10,8 @@ import * as TwelvelabsApi from "../../../../../../index";
  *         status: "queued",
  *         videoUrl: "https://example.com/video.mp4",
  *         assetId: "69abc123def456789012abcd",
- *         analysisMode: "time_based_metadata"
+ *         videoId: "6298d673f1090f1100476d4c",
+ *         analysisMode: "general"
  *     }
  *
  * @example
@@ -20,7 +21,8 @@ import * as TwelvelabsApi from "../../../../../../index";
  *         status: "queued",
  *         videoUrl: "https://example.com/video.mp4",
  *         assetId: "69abc123def456789012abcd",
- *         analysisMode: "time_based_metadata"
+ *         videoId: "6298d673f1090f1100476d4c",
+ *         analysisMode: "general"
  *     }
  */
 export interface TasksListRequest {
@@ -50,6 +52,10 @@ export interface TasksListRequest {
      * Filter tasks by asset ID.
      */
     assetId?: string;
+    /**
+     * Filter tasks by video ID for pre-indexed videos (Pegasus 1.2 only). Deprecated — use `asset_id` instead.
+     */
+    videoId?: string;
     /**
      * Filter tasks by the analysis mode used when creating the task.
      */

package/api/resources/analyzeAsync/resources/tasks/types/CreateAsyncAnalyzeRequestAnalysisMode.d.ts

@@ -2,9 +2,14 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 /**
- * Sets the analysis mode to `time_based_metadata`, which segments your video into time-based intervals and extracts custom metadata for each segment. Requires `model_name` set to `pegasus1.5` and `response_format.type` set to `segment_definitions`.
+ * The analysis approach for this task.
+ * - `general`: Analyze the video and generate a response based on your prompt. Supports both free-form text and structured output via `response_format`.
+ * - `time_based_metadata`: Segment the video into time-based intervals and extract custom metadata for each segment. Requires `model_name` set to `pegasus1.5` and `response_format.type` set to `segment_definitions`.
+ *
+ * **Default:** `general`
  */
-export type CreateAsyncAnalyzeRequestAnalysisMode = "time_based_metadata";
+export type CreateAsyncAnalyzeRequestAnalysisMode = "general" | "time_based_metadata";
 export declare const CreateAsyncAnalyzeRequestAnalysisMode: {
+    readonly General: "general";
     readonly TimeBasedMetadata: "time_based_metadata";
 };

package/api/resources/analyzeAsync/resources/tasks/types/CreateAsyncAnalyzeRequestAnalysisMode.js

@@ -5,5 +5,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateAsyncAnalyzeRequestAnalysisMode = void 0;
 exports.CreateAsyncAnalyzeRequestAnalysisMode = {
+    General: "general",
     TimeBasedMetadata: "time_based_metadata",
 };

package/api/resources/analyzeAsync/resources/tasks/types/CreateAsyncAnalyzeRequestModelName.d.ts

@@ -3,8 +3,10 @@
  */
 /**
  * The video understanding model to use for analysis.
- * - `pegasus1.2` (default): Analyzes pre-indexed videos. Pass a `video_id` to reference your video.
- * - `pegasus1.5`: Analyzes videos directly from a URL, asset, or base64 string. Supports video segmentation with custom segment definitions.
+ * - `pegasus1.2`: General analysis (prompt-based text generation).
+ * - `pegasus1.5`: General analysis (prompt-based text generation) with video clipping, structured prompts with reference images, and video segmentation. See the [Pegasus](/v1.3/docs/concepts/models/pegasus#context-window) page for token limits.
+ *
+ * **Default:** `pegasus1.2`
  */
 export type CreateAsyncAnalyzeRequestModelName = "pegasus1.2" | "pegasus1.5";
 export declare const CreateAsyncAnalyzeRequestModelName: {

package/api/resources/analyzeAsync/resources/tasks/types/TasksListRequestAnalysisMode.d.ts

@@ -1,7 +1,8 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export type TasksListRequestAnalysisMode = "time_based_metadata";
+export type TasksListRequestAnalysisMode = "general" | "time_based_metadata";
 export declare const TasksListRequestAnalysisMode: {
+    readonly General: "general";
     readonly TimeBasedMetadata: "time_based_metadata";
 };

package/api/resources/analyzeAsync/resources/tasks/types/TasksListRequestAnalysisMode.js

@@ -5,5 +5,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TasksListRequestAnalysisMode = void 0;
 exports.TasksListRequestAnalysisMode = {
+    General: "general",
     TimeBasedMetadata: "time_based_metadata",
 };

package/api/resources/assets/client/Client.d.ts

@@ -52,7 +52,10 @@ export declare class Assets {
      * - **Local file**: Set the `method` parameter to `direct` and use the `file` parameter to specify the file.
      * - **Publicly accessible URL**: Set the `method` parameter to `url` and use the `url` parameter to specify the URL of your file.
      *
-     * **File size**: Up to 4 GB.
+     * **Upload limits**:
+     * - **Video and audio, local files**: Up to 200 MB
+     * - **Video and audio, public URLs**: Up to 4 GB
+     * - **Images**: Up to 5 MB
      *
      * **Additional requirements** depend on your workflow:
      * - **Search**: [Marengo requirements](/v1.3/docs/concepts/models/marengo#video-file-requirements)
@@ -112,6 +115,50 @@ export declare class Assets {
      */
     delete(assetId: string, request?: TwelvelabsApi.AssetsDeleteRequest, requestOptions?: Assets.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
+    /**
+     * This method deletes the user-defined metadata of the specified asset.
+     *
+     * This action cannot be undone.
+     *
+     * @param {string} assetId - The unique identifier of the asset whose user-defined metadata to delete.
+     * @param {Assets.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TwelvelabsApi.BadRequestError}
+     * @throws {@link TwelvelabsApi.NotFoundError}
+     *
+     * @example
+     *     await client.assets.deleteUserMetadata("6298d673f1090f1100476d4c")
+     */
+    deleteUserMetadata(assetId: string, requestOptions?: Assets.RequestOptions): core.HttpResponsePromise<void>;
+    private __deleteUserMetadata;
+    /**
+     * This method updates the user-defined metadata of the specified asset. The platform merges your changes with the existing metadata:
+     * - A key with a value creates or replaces that key.
+     * - A key set to `null` deletes that key.
+     * - A key set to an empty string (`""`) is ignored.
+     * - A key you omit from the request keeps its current value.
+     *
+     * To replace all metadata, first delete it using [`DELETE`](/v1.3/api-reference/upload-content/direct-uploads/delete-asset-user-metadata) method of the `/assets/{asset_id}/user-metadata` endpoint, then use this method to set the new values.
+     *
+     * @param {string} assetId - The unique identifier of the asset whose user-defined metadata to update.
+     * @param {TwelvelabsApi.AssetsUpdateUserMetadataRequest} request
+     * @param {Assets.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TwelvelabsApi.BadRequestError}
+     * @throws {@link TwelvelabsApi.NotFoundError}
+     *
+     * @example
+     *     await client.assets.updateUserMetadata("6298d673f1090f1100476d4c", {
+     *         userMetadata: {
+     *             "category": "recentlyAdded",
+     *             "batchNumber": 5,
+     *             "rating": 9.3,
+     *             "needsReview": true
+     *         }
+     *     })
+     */
+    updateUserMetadata(assetId: string, request: TwelvelabsApi.AssetsUpdateUserMetadataRequest, requestOptions?: Assets.RequestOptions): core.HttpResponsePromise<void>;
+    private __updateUserMetadata;
     protected _getCustomAuthorizationHeaders(): Promise<{
         "x-api-key": string;
     }>;