ai-world-sdk 1.3.2 → 1.3.5

package/dist/config.d.ts

@@ -9,7 +9,7 @@
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.3.2";
+export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.3.5";
 /**
  * 版本兼容性错误
  */
@@ -34,8 +34,8 @@ declare class SDKConfig {
     private _authenticated;
     private _authCheckPromise;
     private _currentUser;
-    readonly sdkSignature = "AI_WORLD_SDK_V:1.3.2";
-    readonly sdkVersion = "1.3.2";
+    readonly sdkSignature = "AI_WORLD_SDK_V:1.3.5";
+    readonly sdkVersion = "1.3.5";
     constructor();
     /**
      * Set global base URL

package/dist/config.js

@@ -7,7 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.sdkConfig = exports.VersionCompatibilityError = exports.SDK_SIGNATURE = void 0;
 // SDK 版本号（构建时自动从 package.json 更新）
 // 此版本号会在运行 npm run build 时自动从 package.json 读取并更新
-const SDK_VERSION = "1.3.2";
+const SDK_VERSION = "1.3.5";
 /**
  * SDK 特征码 - 用于在构建后的 JS 文件中识别 SDK 版本
  * 格式: AI_WORLD_SDK_V:版本号
@@ -15,7 +15,7 @@ const SDK_VERSION = "1.3.2";
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.3.2";
+exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.3.5";
 /**
  * 版本兼容性错误
  */

package/dist/index.d.ts

@@ -7,7 +7,7 @@
 import { BaseChatModel, BaseChatModelParams } from "./base";
 import { DoubaoImageGenerationClient, DoubaoImageSize, type DoubaoImageGenerationConfig, type DoubaoImageGenerationRequest, type DoubaoImageGenerationResponse } from "./doubao-image-generation";
 import { GeminiImageGenerationClient, type GeminiImageGenerationConfig, type GeminiImageGenerationRequest, type GeminiImageGenerationResponse } from "./gemini-image-generation";
-import { VideoGenerationClient, type VideoGenerationConfig, type VideoGenerationRequest, type ContentGenerationTaskID, type ContentGenerationTask } from "./video_generation";
+import { VideoGenerationClient, type VideoGenerationConfig, type VideoGenerationRequest, type ContentGenerationTaskID, type ContentGenerationTask, VideoUnderstandingClient, type VideoUnderstandingConfig, type VideoUnderstandingRequest, type VideoUnderstandingResponse, type VideoUnderstandingStreamChunk, type VideoUnderstandingMessage, type VideoUnderstandingContent } from "./video_generation";
 import { OpenAIVideoGenerationClient, type OpenAIVideoGenerationConfig, type OpenAIVideoGenerationRequest, type OpenAIVideoTaskResponse } from "./openai_video_generation";
 import { DownloadClient, type DownloadConfig, type DownloadOptions, type StreamDownloadOptions } from "./download";
 import { AuthClient, getCurrentUserInfo, type AuthConfig, type UserInfo } from "./auth";
@@ -25,11 +25,12 @@ export interface LangchainClientConfig {
 export { DoubaoImageGenerationClient, type DoubaoImageGenerationConfig, type DoubaoImageGenerationRequest, type DoubaoImageGenerationResponse, type DoubaoImageSize, };
 export { GeminiImageGenerationClient, type GeminiImageGenerationConfig, type GeminiImageGenerationRequest, type GeminiImageGenerationResponse, };
 export { VideoGenerationClient, type VideoGenerationConfig, type VideoGenerationRequest, type ContentGenerationTaskID, type ContentGenerationTask, };
+export { VideoUnderstandingClient, type VideoUnderstandingConfig, type VideoUnderstandingRequest, type VideoUnderstandingResponse, type VideoUnderstandingStreamChunk, type VideoUnderstandingMessage, type VideoUnderstandingContent, };
 export { OpenAIVideoGenerationClient, type OpenAIVideoGenerationConfig, type OpenAIVideoGenerationRequest, type OpenAIVideoTaskResponse, };
 export { DownloadClient, type DownloadConfig, type DownloadOptions, type StreamDownloadOptions, };
 export { MinioStorageClient, type MinioStorageConfig, type UploadResponse, type ObjectInfo, type PresignedUrlResponse, type UploadOptions, type ListOptions, } from "./minio";
 export { ResourceClient, type ResourceClientConfig, type ResourceInfo, type AccessLevel, type UploadResourceOptions, type ListResourceOptions, } from "./resource";
-export { DatabaseRequestClient, type DatabaseRequestClientConfig, type DatabaseRequestInfo, type RequestType, type RequestStatus, type ColumnDefinition, type IndexDefinition, type ForeignKeyDefinition, type SchemaDefinition, type SubmitCreateRequestOptions, type SubmitMigrateRequestOptions, type ListRequestsOptions, } from "./database-requests";
+export { VersionedResourceClient, type VersionedResourceClientConfig, type VersionedResourceInfo, type VersionedResourceSummary, type VersionedResourceListResponse, type ListVersionedResourceOptions, } from "./versioned-resource";
 export { AgentSkillClient, type AgentSkillClientConfig, type AgentSkillInfo, type AgentSkillListResponse, type ListSkillsOptions, } from "./agent-skills";
 export { AuthClient, getCurrentUserInfo, type AuthConfig, type UserInfo, };
 export { sdkConfig, VersionCompatibilityError, SDK_SIGNATURE, type AuthenticatedUser } from "./config";

package/dist/index.js

@@ -20,7 +20,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDK_SIGNATURE = exports.VersionCompatibilityError = exports.sdkConfig = exports.getCurrentUserInfo = exports.AuthClient = exports.AgentSkillClient = exports.DatabaseRequestClient = exports.ResourceClient = exports.MinioStorageClient = exports.DownloadClient = exports.OpenAIVideoGenerationClient = exports.VideoGenerationClient = exports.GeminiImageGenerationClient = exports.DoubaoImageGenerationClient = exports.ChatAnthropic = exports.ChatGoogleGenerativeAI = exports.ChatOpenAI = exports.BaseChatModel = exports.AIMessageChunk = exports.SystemMessage = exports.AIMessage = exports.HumanMessage = void 0;
+exports.SDK_SIGNATURE = exports.VersionCompatibilityError = exports.sdkConfig = exports.getCurrentUserInfo = exports.AuthClient = exports.AgentSkillClient = exports.VersionedResourceClient = exports.ResourceClient = exports.MinioStorageClient = exports.DownloadClient = exports.OpenAIVideoGenerationClient = exports.VideoUnderstandingClient = exports.VideoGenerationClient = exports.GeminiImageGenerationClient = exports.DoubaoImageGenerationClient = exports.ChatAnthropic = exports.ChatGoogleGenerativeAI = exports.ChatOpenAI = exports.BaseChatModel = exports.AIMessageChunk = exports.SystemMessage = exports.AIMessage = exports.HumanMessage = void 0;
 exports.createChatModel = createChatModel;
 const openai_1 = require("./chat_models/openai");
 const google_1 = require("./chat_models/google");
@@ -30,6 +30,7 @@ const gemini_image_generation_1 = require("./gemini-image-generation");
 Object.defineProperty(exports, "GeminiImageGenerationClient", { enumerable: true, get: function () { return gemini_image_generation_1.GeminiImageGenerationClient; } });
 const video_generation_1 = require("./video_generation");
 Object.defineProperty(exports, "VideoGenerationClient", { enumerable: true, get: function () { return video_generation_1.VideoGenerationClient; } });
+Object.defineProperty(exports, "VideoUnderstandingClient", { enumerable: true, get: function () { return video_generation_1.VideoUnderstandingClient; } });
 const openai_video_generation_1 = require("./openai_video_generation");
 Object.defineProperty(exports, "OpenAIVideoGenerationClient", { enumerable: true, get: function () { return openai_video_generation_1.OpenAIVideoGenerationClient; } });
 const download_1 = require("./download");
@@ -59,9 +60,9 @@ Object.defineProperty(exports, "MinioStorageClient", { enumerable: true, get: fu
 // Export resource management client
 var resource_1 = require("./resource");
 Object.defineProperty(exports, "ResourceClient", { enumerable: true, get: function () { return resource_1.ResourceClient; } });
-// Export database request client
-var database_requests_1 = require("./database-requests");
-Object.defineProperty(exports, "DatabaseRequestClient", { enumerable: true, get: function () { return database_requests_1.DatabaseRequestClient; } });
+// Export versioned resource client
+var versioned_resource_1 = require("./versioned-resource");
+Object.defineProperty(exports, "VersionedResourceClient", { enumerable: true, get: function () { return versioned_resource_1.VersionedResourceClient; } });
 // Export agent skill client
 var agent_skills_1 = require("./agent-skills");
 Object.defineProperty(exports, "AgentSkillClient", { enumerable: true, get: function () { return agent_skills_1.AgentSkillClient; } });

package/dist/llm.js

@@ -32,6 +32,10 @@ function createProvider(provider, endpointType, pluginId) {
         settings.baseURL = `${serverUrl}/api/llm/openrouter`;
         return (0, ai_sdk_provider_1.createOpenRouter)(settings);
     }
+    else if (provider === "kunpo") {
+        settings.baseURL = `${serverUrl}/api/llm/kunpo`;
+        return (0, ai_sdk_provider_1.createOpenRouter)(settings);
+    }
     switch (endpointType) {
         case "openai":
             return (0, openai_1.createOpenAI)(settings);

package/dist/provider_config.d.ts

@@ -1,7 +1,7 @@
 /**
  * 模型提供商
  */
-export type AIModelProvider = "api2img" | "aihubmix" | "doubao" | "gemini" | "shubiaobiao" | "anthropic" | "aiping" | "openrouter";
+export type AIModelProvider = "api2img" | "aihubmix" | "doubao" | "gemini" | "shubiaobiao" | "anthropic" | "aiping" | "openrouter" | "kunpo";
 /**
  * 模型端点类型
  * - openai: OpenAI 兼容 API（/v1/chat/completions 等）

package/dist/provider_config.js

@@ -11,6 +11,7 @@ exports.PROVIDER_CONFIGS = {
     gemini: { provider: "gemini", modelType: "gemini" },
     anthropic: { provider: "anthropic", modelType: "anthropic" },
     openrouter: { provider: "openrouter", modelType: "openai" },
+    kunpo: { provider: "kunpo", modelType: "openai" },
 };
 function getProviderConfig(provider) {
     return exports.PROVIDER_CONFIGS[provider];

package/dist/versioned-resource.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端
+ * 通过后端 /api/versioned-resources 操作版本化资源系统
+ * 资源名称为全局唯一标识，支持语义化版本号管理
+ */
+export interface VersionedResourceClientConfig {
+    baseUrl?: string;
+    token?: string;
+    headers?: Record<string, string>;
+}
+export interface VersionedResourceInfo {
+    id: number;
+    name: string;
+    version: string;
+    description?: string;
+    filename: string;
+    size: number;
+    content_type: string;
+    uploader_id: number;
+    uploader_name?: string;
+    created_at: string;
+}
+export interface VersionedResourceSummary {
+    name: string;
+    latest_version: string;
+    description?: string;
+    filename: string;
+    size: number;
+    content_type: string;
+    version_count: number;
+    latest_uploader_name?: string;
+    created_at: string;
+}
+export interface VersionedResourceListResponse {
+    items: VersionedResourceSummary[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface ListVersionedResourceOptions {
+    page?: number;
+    pageSize?: number;
+    search?: string;
+}
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端类
+ *
+ * @example
+ * ```typescript
+ * import { VersionedResourceClient } from 'ai-world-sdk';
+ *
+ * const vr = new VersionedResourceClient();
+ *
+ * // 上传新版本
+ * const file = new File(['content'], 'config.json', { type: 'application/json' });
+ * const res = await vr.upload('my-config', '1.0.0', file, '初始版本');
+ *
+ * // 获取最新版本
+ * const latest = await vr.getLatest('my-config');
+ *
+ * // 列出所有版本
+ * const versions = await vr.listVersions('my-config');
+ *
+ * // 下载指定版本
+ * const blob = await vr.download('my-config', '1.0.0');
+ *
+ * // 下载最新版本
+ * const latestBlob = await vr.download('my-config', 'latest');
+ * ```
+ */
+export declare class VersionedResourceClient {
+    private baseUrl;
+    private headers;
+    constructor(config?: VersionedResourceClientConfig);
+    private handleErrorResponse;
+    /**
+     * 上传新版本
+     * @param name 资源名称（全局唯一标识）
+     * @param version 语义化版本号（必须高于当前最新版本）
+     * @param file 文件
+     * @param description 可选的版本描述
+     */
+    upload(name: string, version: string, file: File | Blob, description?: string): Promise<VersionedResourceInfo>;
+    /**
+     * 分页列出所有版本化资源（聚合最新版本信息）
+     */
+    list(options?: ListVersionedResourceOptions): Promise<VersionedResourceListResponse>;
+    /**
+     * 列出指定资源的所有版本（按版本号降序）
+     */
+    listVersions(name: string): Promise<VersionedResourceInfo[]>;
+    /**
+     * 获取指定资源的最新版本信息
+     */
+    getLatest(name: string): Promise<VersionedResourceInfo>;
+    /**
+     * 获取指定版本信息
+     */
+    getVersion(name: string, version: string): Promise<VersionedResourceInfo>;
+    /**
+     * 下载指定版本文件（version 可传 "latest" 下载最新版本）
+     */
+    download(name: string, version: string): Promise<Blob>;
+    /**
+     * 删除指定版本
+     */
+    deleteVersion(name: string, version: string): Promise<{
+        name: string;
+        version: string;
+        deleted: boolean;
+    }>;
+}

package/dist/versioned-resource.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端
+ * 通过后端 /api/versioned-resources 操作版本化资源系统
+ * 资源名称为全局唯一标识，支持语义化版本号管理
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionedResourceClient = void 0;
+const config_1 = require("./config");
+const log_1 = require("./log");
+// ==================== VersionedResourceClient ====================
+/**
+ * Versioned Resource Client
+ * 版本化资源管理客户端类
+ *
+ * @example
+ * ```typescript
+ * import { VersionedResourceClient } from 'ai-world-sdk';
+ *
+ * const vr = new VersionedResourceClient();
+ *
+ * // 上传新版本
+ * const file = new File(['content'], 'config.json', { type: 'application/json' });
+ * const res = await vr.upload('my-config', '1.0.0', file, '初始版本');
+ *
+ * // 获取最新版本
+ * const latest = await vr.getLatest('my-config');
+ *
+ * // 列出所有版本
+ * const versions = await vr.listVersions('my-config');
+ *
+ * // 下载指定版本
+ * const blob = await vr.download('my-config', '1.0.0');
+ *
+ * // 下载最新版本
+ * const latestBlob = await vr.download('my-config', 'latest');
+ * ```
+ */
+class VersionedResourceClient {
+    constructor(config = {}) {
+        this.baseUrl =
+            config.baseUrl ||
+                config_1.sdkConfig.getServerUrl() ||
+                (typeof window !== "undefined" ? window.location.origin : "");
+        const globalHeaders = config_1.sdkConfig.getHeaders();
+        const globalToken = config.token || config_1.sdkConfig.getToken();
+        this.headers = {
+            ...globalHeaders,
+            ...config.headers,
+        };
+        if (globalToken) {
+            this.headers["Authorization"] = `Bearer ${globalToken}`;
+        }
+    }
+    async handleErrorResponse(response) {
+        let errorMessage = `Request failed: ${response.status} ${response.statusText}`;
+        try {
+            const errorText = await response.text();
+            const errorJson = JSON.parse(errorText);
+            errorMessage = errorJson.detail || errorMessage;
+        }
+        catch {
+            // ignore parse error
+        }
+        throw new Error(errorMessage);
+    }
+    /**
+     * 上传新版本
+     * @param name 资源名称（全局唯一标识）
+     * @param version 语义化版本号（必须高于当前最新版本）
+     * @param file 文件
+     * @param description 可选的版本描述
+     */
+    async upload(name, version, file, description) {
+        const params = new URLSearchParams();
+        params.append("name", name);
+        params.append("version", version);
+        if (description)
+            params.append("description", description);
+        const url = `${this.baseUrl}/api/versioned-resources/upload?${params.toString()}`;
+        const formData = new FormData();
+        formData.append("file", file);
+        (0, log_1.debugLog)("VersionedResource", `Uploading ${name}@${version}`);
+        (0, log_1.logRequest)("POST", url);
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                ...this.headers,
+            },
+            body: formData,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 分页列出所有版本化资源（聚合最新版本信息）
+     */
+    async list(options = {}) {
+        const params = new URLSearchParams();
+        if (options.page)
+            params.append("page", options.page.toString());
+        if (options.pageSize)
+            params.append("page_size", options.pageSize.toString());
+        if (options.search)
+            params.append("search", options.search);
+        const url = `${this.baseUrl}/api/versioned-resources/?${params.toString()}`;
+        (0, log_1.debugLog)("VersionedResource", `Listing resources`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 列出指定资源的所有版本（按版本号降序）
+     */
+    async listVersions(name) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/versions`;
+        (0, log_1.debugLog)("VersionedResource", `Listing versions of ${name}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 获取指定资源的最新版本信息
+     */
+    async getLatest(name) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/latest`;
+        (0, log_1.debugLog)("VersionedResource", `Getting latest version of ${name}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 获取指定版本信息
+     */
+    async getVersion(name, version) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/${encodeURIComponent(version)}`;
+        (0, log_1.debugLog)("VersionedResource", `Getting ${name}@${version}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * 下载指定版本文件（version 可传 "latest" 下载最新版本）
+     */
+    async download(name, version) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/${encodeURIComponent(version)}/download`;
+        (0, log_1.debugLog)("VersionedResource", `Downloading ${name}@${version}`);
+        (0, log_1.logRequest)("GET", url);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.blob();
+    }
+    /**
+     * 删除指定版本
+     */
+    async deleteVersion(name, version) {
+        const url = `${this.baseUrl}/api/versioned-resources/${encodeURIComponent(name)}/${encodeURIComponent(version)}`;
+        (0, log_1.debugLog)("VersionedResource", `Deleting ${name}@${version}`);
+        (0, log_1.logRequest)("DELETE", url);
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, response.body);
+        if (!response.ok) {
+            return this.handleErrorResponse(response);
+        }
+        return response.json();
+    }
+}
+exports.VersionedResourceClient = VersionedResourceClient;

package/dist/video_generation.d.ts

@@ -1,6 +1,6 @@
 /**
- * Video Generation Client
- * 视频生成客户端
+ * Video Generation & Understanding Client
+ * 视频生成 & 视频理解客户端
  */
 export interface VideoGenerationConfig {
     baseUrl?: string;
@@ -88,3 +88,150 @@ export declare class VideoGenerationClient {
         timeout?: number;
     }): Promise<ContentGenerationTask>;
 }
+export interface VideoUnderstandingConfig {
+    baseUrl?: string;
+    token?: string;
+    headers?: Record<string, string>;
+}
+export interface VideoUnderstandingVideoURL {
+    url: string;
+    fps?: number;
+}
+export interface VideoUnderstandingContentText {
+    type: "text";
+    text: string;
+}
+export interface VideoUnderstandingContentVideo {
+    type: "video_url";
+    video_url: VideoUnderstandingVideoURL;
+}
+export interface VideoUnderstandingContentImage {
+    type: "image_url";
+    image_url: {
+        url: string;
+    };
+}
+export type VideoUnderstandingContent = VideoUnderstandingContentText | VideoUnderstandingContentVideo | VideoUnderstandingContentImage;
+export interface VideoUnderstandingMessage {
+    role: "system" | "user" | "assistant";
+    content: string | VideoUnderstandingContent[];
+}
+export interface VideoUnderstandingRequest {
+    model?: string;
+    /** 视频 URL（简化参数，与 messages 二选一） */
+    video_url?: string;
+    /** 文本提示词（配合 video_url 使用） */
+    prompt?: string;
+    /** 视频采样帧率 */
+    fps?: number;
+    /** 完整消息列表（高级用法）。提供时忽略 video_url/prompt/fps */
+    messages?: VideoUnderstandingMessage[];
+    /** 是否流式输出 */
+    stream?: boolean;
+    /** 最大输出 token 数 */
+    max_tokens?: number;
+    /** 采样温度 */
+    temperature?: number;
+    /** 核采样参数 */
+    top_p?: number;
+    /** 用户标识 */
+    user?: string;
+}
+/** 视频理解使用情况 */
+export interface VideoUnderstandingUsage {
+    /** 提示 token 数 */
+    prompt_tokens: number;
+    /** 完成 token 数 */
+    completion_tokens: number;
+    /** 总 token 数 */
+    total_tokens: number;
+}
+/** 视频理解选择 */
+export interface VideoUnderstandingChoice {
+    /** 索引 */
+    index: number;
+    /** 消息 */
+    message: {
+        /** 角色 */
+        role: string;
+        /** 内容 */
+        content: string;
+    };
+    /** 完成原因 */
+    finish_reason: string | null;
+}
+export interface VideoUnderstandingResponse {
+    /** 任务 ID */
+    id: string;
+    /** 对象 */
+    object: string;
+    /** 模型 */
+    model: string;
+    /** 选择 */
+    choices: VideoUnderstandingChoice[];
+    /** 使用情况 */
+    usage?: VideoUnderstandingUsage;
+}
+export interface VideoUnderstandingStreamDelta {
+    /** 角色 */
+    role?: string;
+    /** 内容 */
+    content?: string;
+}
+export interface VideoUnderstandingStreamChoice {
+    /** 索引 */
+    index: number;
+    /** 增量 */
+    delta: VideoUnderstandingStreamDelta;
+    /** 完成原因 */
+    finish_reason: string | null;
+}
+export interface VideoUnderstandingStreamChunk {
+    /** 任务 ID */
+    id: string;
+    /** 对象 */
+    object: string;
+    /** 模型 */
+    model: string;
+    /** 选择 */
+    choices: VideoUnderstandingStreamChoice[];
+}
+export declare class VideoUnderstandingClient {
+    private headers;
+    constructor(config?: VideoUnderstandingConfig);
+    /**
+     * Analyze a video (non-streaming)
+     * 视频理解（非流式）
+     */
+    understand(request: VideoUnderstandingRequest): Promise<VideoUnderstandingResponse>;
+    /**
+     * Analyze a video with streaming response
+     * 视频理解（流式）
+     *
+     * @returns AsyncGenerator yielding content chunks
+     */
+    understandStream(request: VideoUnderstandingRequest): AsyncGenerator<VideoUnderstandingStreamChunk, void, unknown>;
+    /**
+     * Convenience: analyze video and return full text content
+     * 便捷方法：分析视频并返回完整文本
+     */
+    analyzeVideo(videoUrl: string, options?: {
+        prompt?: string;
+        fps?: number;
+        model?: string;
+        max_tokens?: number;
+    }): Promise<string>;
+    /**
+     * Convenience: analyze video with streaming, collecting full text
+     * 便捷方法：流式分析视频，收集完整文本
+     *
+     * @param onChunk optional callback for each text chunk
+     */
+    analyzeVideoStream(videoUrl: string, options?: {
+        prompt?: string;
+        fps?: number;
+        model?: string;
+        max_tokens?: number;
+        onChunk?: (text: string) => void;
+    }): Promise<string>;
+}