ai-world-sdk 1.5.5 → 1.5.7

package/dist/cli/commands/image.js

@@ -180,7 +180,6 @@ function registerImageCommands(program) {
             });
         }
         catch (err) {
-            console.log('----image generate error', err, new Error().stack);
             (0, utils_1.handleError)(err, commandName);
         }
     });

package/dist/cli/commands/plugin.js

@@ -185,10 +185,16 @@ function registerPluginCommands(program) {
     });
     plugin
         .command('create')
-        .argument('<zip-file>')
-        .requiredOption('--plugin-id <id>')
-        .option('--name <name>')
-        .option('--description <text>')
+        .argument('[zip-file]', '静态文件 zip 包路径（可选）')
+        .requiredOption('--plugin-id <id>', '插件 ID')
+        .option('--name <name>', '插件名称')
+        .option('--description <text>', '插件描述')
+        .option('--author <author>', '插件作者')
+        .option('--version <ver>', '插件版本')
+        .option('--server-zip <path>', 'JS 后端 zip 包路径')
+        .option('--backend-entry <entry>', 'JS 后端入口文件（默认 index.js）')
+        .option('--backend-websocket', '启用 WebSocket 代理')
+        .option('--disable-sdk-update-notice', '禁用 SDK 更新提示')
         .action(async (zipFile, options, cmd) => {
         const commandName = 'plugin create';
         try {
@@ -200,12 +206,58 @@ function registerPluginCommands(program) {
             });
             (0, utils_1.initSDK)(auth);
             const client = new plugin_management_1.PluginManagementClient();
-            const staticZip = (0, utils_1.readFileAsFile)(zipFile);
             const res = await client.create({
                 pluginId: options.pluginId,
                 name: options.name,
                 description: options.description,
-                staticZip,
+                author: options.author,
+                version: options.version,
+                staticZip: zipFile ? (0, utils_1.readFileAsFile)(zipFile) : undefined,
+                serverZip: options.serverZip ? (0, utils_1.readFileAsFile)(options.serverZip) : undefined,
+                backendEntry: options.backendEntry,
+                backendWebsocket: options.backendWebsocket === true ? true : undefined,
+                disableSdkUpdateNotice: options.disableSdkUpdateNotice === true ? true : undefined,
+            });
+            (0, output_1.output)(res, (0, utils_1.getFormat)(program));
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    plugin
+        .command('update')
+        .argument('[zip-file]', '静态文件 zip 包路径（可选）')
+        .requiredOption('--plugin-id <id>', '要更新的插件 ID')
+        .option('--name <name>', '插件名称')
+        .option('--description <text>', '插件描述')
+        .option('--author <author>', '插件作者')
+        .option('--version <ver>', '插件版本')
+        .option('--server-zip <path>', 'JS 后端 zip 包路径')
+        .option('--backend-entry <entry>', 'JS 后端入口文件（默认 index.js）')
+        .option('--backend-websocket', '启用 WebSocket 代理')
+        .option('--disable-sdk-update-notice', '禁用 SDK 更新提示')
+        .action(async (zipFile, options, cmd) => {
+        const commandName = 'plugin update';
+        try {
+            const o = collectOpts(cmd);
+            const auth = (0, config_1.resolveAuth)({
+                baseUrl: o.baseUrl,
+                token: o.token,
+                pluginId: o.pluginId,
+            });
+            (0, utils_1.initSDK)(auth);
+            const client = new plugin_management_1.PluginManagementClient();
+            const res = await client.update({
+                pluginId: options.pluginId,
+                name: options.name,
+                description: options.description,
+                author: options.author,
+                version: options.version,
+                staticZip: zipFile ? (0, utils_1.readFileAsFile)(zipFile) : undefined,
+                serverZip: options.serverZip ? (0, utils_1.readFileAsFile)(options.serverZip) : undefined,
+                backendEntry: options.backendEntry,
+                backendWebsocket: options.backendWebsocket === true ? true : undefined,
+                disableSdkUpdateNotice: options.disableSdkUpdateNotice === true ? true : undefined,
             });
             (0, output_1.output)(res, (0, utils_1.getFormat)(program));
         }

package/dist/config.d.ts

@@ -9,7 +9,7 @@
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.5";
+export declare const SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.7";
 /**
  * 版本兼容性错误
  */
@@ -35,8 +35,8 @@ declare class SDKConfig {
     private _authCheckPromise;
     private _currentUser;
     private _cliMode;
-    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.5";
-    readonly sdkVersion = "1.5.5";
+    readonly sdkSignature = "AI_WORLD_SDK_V:1.5.7";
+    readonly sdkVersion = "1.5.7";
     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.5.5";
+const SDK_VERSION = "1.5.7";
 /**
  * SDK 特征码 - 用于在构建后的 JS 文件中识别 SDK 版本
  * 格式: AI_WORLD_SDK_V:版本号
@@ -15,7 +15,7 @@ const SDK_VERSION = "1.5.5";
  *
  * 注意: {VERSION} 占位符会在构建时被替换为实际版本号
  */
-exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.5";
+exports.SDK_SIGNATURE = "AI_WORLD_SDK_V:1.5.7";
 /**
  * 版本兼容性错误
  */

package/dist/plugin-management.d.ts

@@ -49,6 +49,18 @@ export interface CreatePluginData {
     backendWebsocket?: boolean;
     disableSdkUpdateNotice?: boolean;
 }
+export interface UpdatePluginData {
+    pluginId: string;
+    name?: string;
+    description?: string;
+    author?: string;
+    version?: string;
+    staticZip?: File | Blob;
+    serverZip?: File | Blob;
+    backendEntry?: string;
+    backendWebsocket?: boolean;
+    disableSdkUpdateNotice?: boolean;
+}
 export interface PluginStatus {
     plugin_id: string;
     enabled: boolean;
@@ -110,6 +122,7 @@ export declare class PluginManagementClient {
     get(pluginId: string): Promise<PluginInfo>;
     getStatus(pluginId: string): Promise<PluginStatus>;
     create(data: CreatePluginData): Promise<PluginInfo>;
+    update(data: UpdatePluginData): Promise<PluginInfo>;
     delete(pluginId: string): Promise<{
         message: string;
     }>;

package/dist/plugin-management.js

@@ -136,6 +136,41 @@ class PluginManagementClient {
             await this.handleErrorResponse(response);
         return (await response.json());
     }
+    async update(data) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/plugins/update`;
+        const formData = new FormData();
+        formData.append("plugin_id", data.pluginId);
+        if (data.name)
+            formData.append("name", data.name);
+        if (data.description)
+            formData.append("description", data.description);
+        if (data.author)
+            formData.append("author", data.author);
+        if (data.version)
+            formData.append("version", data.version);
+        if (data.staticZip)
+            formData.append("static_zip", data.staticZip);
+        if (data.serverZip)
+            formData.append("server_zip", data.serverZip);
+        if (data.backendEntry)
+            formData.append("backend_entry", data.backendEntry);
+        if (data.backendWebsocket !== undefined)
+            formData.append("backend_websocket", String(data.backendWebsocket));
+        if (data.disableSdkUpdateNotice !== undefined)
+            formData.append("disable_sdk_update_notice", String(data.disableSdkUpdateNotice));
+        const uploadHeaders = { ...this.headers };
+        delete uploadHeaders["Content-Type"];
+        (0, log_1.logRequest)("POST", url, uploadHeaders);
+        const response = await fetch(url, {
+            method: "POST",
+            headers: uploadHeaders,
+            body: formData,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
     async delete(pluginId) {
         config_1.sdkConfig.ensureVersionCompatible();
         const url = `${this.baseUrl}/api/plugins/${pluginId}`;

package/dist/video_generation.d.ts

@@ -16,20 +16,55 @@ export interface VideoGenerationContentImage {
     image_url: {
         url: string;
     };
-    role: string;
+    role?: string;
+}
+export interface VideoGenerationContentVideo {
+    type: "video_url";
+    video_url: {
+        url: string;
+    };
+}
+export interface VideoGenerationContentAudio {
+    type: "audio_url";
+    audio_url: {
+        url: string;
+    };
 }
-export type VideoGenerationContent = VideoGenerationContentText | VideoGenerationContentImage;
+export type VideoGenerationContent = VideoGenerationContentText | VideoGenerationContentImage | VideoGenerationContentVideo | VideoGenerationContentAudio;
 export interface VideoGenerationRequest {
+    /** 文本提示词（文本生成视频，与 content 二选一） */
     prompt?: string;
+    /** 图像 URL（图像生成视频，与 content 二选一） */
     image_url?: string;
+    /** 模型名称。Seedance 1.x: doubao-seedance-1-0-pro-fast-251015; Seedance 2.0: doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128 */
     model?: string;
+    /**
+     * 内容列表（高级用法，直接传递给 SDK）。
+     * 支持的类型: text, image_url, video_url, audio_url。
+     * 提供时忽略 prompt 和 image_url 字段。
+     *
+     * 示例 — 文本生成视频:
+     *   [{ type: "text", text: "A sunset over the ocean" }]
+     *
+     * 示例 — 图像生成视频（I2V）:
+     *   [{ type: "text", text: "The woman smiles" }, { type: "image_url", image_url: { url: "https://..." } }]
+     *
+     * 示例 — 首尾帧控制:
+     *   [{ type: "text", text: "flower blooms" }, { type: "image_url", image_url: { url: "first.jpg" } }, { type: "image_url", image_url: { url: "last.jpg" } }]
+     *
+     * 示例 — 多模态参考（Seedance 2.0）:
+     *   [{ type: "text", text: "..." }, { type: "image_url", image_url: { url: "..." } }, { type: "video_url", video_url: { url: "..." } }, { type: "audio_url", audio_url: { url: "..." } }]
+     */
     content?: VideoGenerationContent[];
     callback_url?: string;
     return_last_frame?: boolean;
     service_tier?: string;
     execution_expires_after?: number;
+    /** 视频时长（秒），Seedance 1.x: 1-10，Seedance 2.0: 5-15 */
     duration?: number;
-    aspect_ratio?: "16:9" | "9:16" | "1:1";
+    /** 宽高比: "16:9" | "9:16" | "1:1" | "adaptive"（I2V 时自适应原图比例） */
+    aspect_ratio?: string;
+    /** 分辨率: "720p" | "1080p" | "2k" */
     resolution?: string;
     user?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-world-sdk",
-  "version": "1.5.5",
+  "version": "1.5.7",
   "description": "TypeScript SDK for AI World Platform - Chat Models, Image Generation, and Video Generation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/ai-world-sdk/SKILL.md

@@ -133,6 +133,7 @@ sdkConfig.setPluginId('my-plugin');
 - `createProvider(provider, endpointType, pluginId)` 创建 Vercel AI SDK Provider
 - Provider 对照表：`api2img`(推荐) / `gemini` / `aihubmix` / `shubiaobiao` / `aiping` / `openrouter` / `kunpo`
 - **OpenRouter**：使用专用代理端点 `/api/llm/openrouter`，模型 ID 格式为 `provider/model`（如 `openai/gpt-4o-mini`、`anthropic/claude-sonnet-4-20250514`、`google/gemini-2.5-flash-preview`）
+- **OpenRouter Reasoning**：通过 `providerOptions.openrouter.reasoning` 启用模型思考，支持 `effort`（`xhigh`/`high`/`medium`/`low`/`minimal`）和 `max_tokens` 参数，适用于 Claude / DeepSeek-R1 / o1 / o3 / Gemini 等支持思考的模型
 - **KUNPO API**：统一 LLM 网关（https://llm.ziy.cc），兼容 OpenAI 接口，使用专用代理端点 `/api/llm/kunpo`，一个 Key 访问 150+ 模型
 - 常用模型列表和 AI SDK 函数速查
 
@@ -159,6 +160,22 @@ const stream = streamText({
 for await (const chunk of stream.textStream) {
   process.stdout.write(chunk);
 }
+
+// 启用思考/推理（OpenRouter / KUNPO 均支持）
+const thinkResult = await generateText({
+  model: provider.languageModel('anthropic/claude-sonnet-4-20250514'),
+  prompt: '证明根号2是无理数',
+  providerOptions: {
+    openrouter: {
+      reasoning: {
+        effort: 'high',         // 思考深度: xhigh / high / medium / low / minimal
+        // max_tokens: 10000,   // 可选：限制思考 token 数量
+      },
+    },
+  },
+});
+console.log('思考过程:', thinkResult.reasoning);
+console.log('最终回答:', thinkResult.text);
 ```
 
 #### KUNPO API 快速示例
@@ -247,7 +264,10 @@ for await (const chunk of stream.textStream) {
 
 ### 平台通用 API → `docs/platform-api.md`
 
-- `PluginManagementClient` — 插件 CRUD、启用/禁用/重载/重启、模板管理
+- `PluginManagementClient` — 插件 CRUD（`create` / `update` 分离）、启用/禁用/重载/重启、模板管理
+  - `create(data)` — 创建新插件（POST `/api/plugins/create`），插件不存在时使用
+  - `update(data)` — 更新已有插件（POST `/api/plugins/update`），插件必须已存在，未传入的字段保留原值
+  - 两者均支持: pluginId / name / description / author / version / staticZip / serverZip / backendEntry / backendWebsocket / disableSdkUpdateNotice
 - `StatsClient` — AI 接口调用统计/趋势、插件访问统计（管理员）
 - `DashboardClient` — 当前用户统计（无需管理员权限）
 - `SharedResourceClient` — 平台级文件共享（与 `ResourceClient` 的插件级 ACL 不同）
@@ -285,6 +305,12 @@ ai-world text stream --prompt "请介绍人工智能"
 # 查看插件列表
 ai-world plugin list --format table
 
+# 创建插件
+ai-world plugin create ./dist.zip --plugin-id my-plugin --name "My Plugin" --version 1.0.0
+
+# 更新插件（插件必须已存在，未传入的字段保留原值）
+ai-world plugin update ./dist.zip --plugin-id my-plugin --version 1.1.0
+
 # 版本检查
 ai-world version
 ```

package/skills/ai-world-sdk/docs/image-generation.md

@@ -58,12 +58,35 @@ await client.generate({
 
 ## Gemini 图像生成
 
+`provider` 在构造函数中传入，而非 `generate()` 方法。
+
 ```typescript
 import { GeminiImageGenerationClient } from 'ai-world-sdk';
 
-const client = new GeminiImageGenerationClient({});
+// provider 在构造函数中指定
+const client = new GeminiImageGenerationClient({ provider: 'gemini' });
 const result = await client.generate({
   prompt: '一只可爱的小猫',
-  provider: 'gemini',
 });
+// result.images — 生成的图像列表
 ```
+
+### Gemini 图像对话（chat）
+
+```typescript
+const chatResult = await client.chat({
+  prompt: '把这只猫变成卡通风格',
+  image: 'data:image/png;base64,...',
+  model: 'gemini-3-pro-image-preview',
+});
+```
+
+### 参数说明
+
+| 参数 | 位置 | 说明 |
+|------|------|------|
+| `provider` | 构造函数 | 图像生成 Provider（如 `'gemini'`） |
+| `prompt` | `generate()` | 文本提示词 |
+| `model` | `generate()` | 模型名称（默认: `gemini-2.0-flash-exp-image-generation`，chat 默认: `gemini-3-pro-image-preview`） |
+| `image` | `generate()` / `chat()` | 输入图像（base64 或 URL） |
+| `aspect_ratio` | `generate()` | 宽高比 |

package/skills/ai-world-sdk/docs/provider-and-models.md

@@ -15,7 +15,7 @@
 | `aiping` | `anthropic` | 平音 Claude |
 | `gemini` | `gemini` | Google 原生，仅限 Gemini 系列模型 |
 | `openrouter` | `openai` | OpenRouter 聚合服务，SDK 内部自动使用 `createOpenRouter` 和专用代理端点 `/api/llm/openrouter`。模型 ID 格式为 `provider/model`（如 `openai/gpt-4o-mini`、`anthropic/claude-sonnet-4-20250514`） |
-| `kunpo` | `openai` | KUNPO API 统一 LLM 网关（https://llm.ziy.cc），兼容 OpenAI 接口，一个 Key 访问 150+ 模型。SDK 内部使用 `createOpenAI` 并路由到专用代理 `/api/llm/kunpo` |
+| `kunpo` | `openai` | KUNPO API 统一 LLM 网关（https://llm.ziy.cc），兼容 OpenAI 接口，一个 Key 访问 150+ 模型。SDK 内部使用 `createOpenRouter` 并路由到专用代理 `/api/llm/kunpo` |
 
 ## EndpointType 与模型对应关系
 
@@ -26,7 +26,7 @@
 | `openai` | OpenAI 兼容 | 模型兼容 OpenAI 格式，可包括 GPT、以及经聚合的 Gemini/Claude 等（视 provider 能力） |
 | `openai` | OpenRouter 兼容 | 当 provider 为 `openrouter` 时，`endpointType` 传 `openai`，SDK 内部自动切换到 `createOpenRouter` 和专用代理端点 |
 
-规则：**anthropic 不是 provider**，仅 **api2img**、**shubiaobiao**、**aiping** 支持 EndpointType 为 `anthropic`（调用 Claude）；`gemini` provider 用 `gemini` endpoint；`openrouter` provider 的 `endpointType` 传 `openai`，SDK 内部会自动使用 `@openrouter/ai-sdk-provider` 的 `createOpenRouter` 并路由到专用代理 `/api/llm/openrouter`；`kunpo` provider 的 `endpointType` 传 `openai`，SDK 内部使用 `createOpenAI` 并路由到专用代理 `/api/llm/kunpo`；其余按上表组合。
+规则：**anthropic 不是 provider**，仅 **api2img**、**shubiaobiao**、**aiping** 支持 EndpointType 为 `anthropic`（调用 Claude）；`gemini` provider 用 `gemini` endpoint；`openrouter` provider 的 `endpointType` 传 `openai`，SDK 内部会自动使用 `@openrouter/ai-sdk-provider` 的 `createOpenRouter` 并路由到专用代理 `/api/llm/openrouter`；`kunpo` provider 的 `endpointType` 传 `openai`，SDK 内部使用 `createOpenRouter` 并路由到专用代理 `/api/llm/kunpo`；其余按上表组合。
 
 > `doubao` 不通过 `createProvider` 使用，豆包有专用客户端（见 image-generation.md / video-generation.md）。
 
@@ -62,7 +62,7 @@ or.languageModel('openai/gpt-4o-mini');
 or.languageModel('anthropic/claude-sonnet-4-20250514');
 or.languageModel('google/gemini-2.5-flash-preview');
 
-// KUNPO API（endpointType 传 'openai'，SDK 内部使用 createOpenAI + 专用代理 /api/llm/kunpo）
+// KUNPO API（endpointType 传 'openai'，SDK 内部使用 createOpenRouter + 专用代理 /api/llm/kunpo）
 // 兼容 OpenAI Chat Completions 格式，支持 150+ 模型
 const kp = createProvider('kunpo', 'openai', 'my-plugin');
 kp.languageModel('google/gemini-3.1-pro-preview');

package/skills/ai-world-sdk/docs/video-generation.md

@@ -2,22 +2,32 @@
 
 ## 豆包视频生成（Seedance）
 
+参考文档: https://www.volcengine.com/docs/82379/1366799 (1.x) / https://www.volcengine.com/docs/82379/2291680 (2.0)
+具体模型列表: https://www.volcengine.com/docs/82379/1330310
+
+### 支持的模型
+
+| 模型 | 说明 |
+|------|------|
+| `doubao-seedance-2-0-260128` | Seedance 2.0 标准版 |
+| `doubao-seedance-2-0-fast-260128` | Seedance 2.0 快速版 |
+
+### 基本用法 — 文本生成视频
+
 ```typescript
 import { VideoGenerationClient } from 'ai-world-sdk';
 
 const client = new VideoGenerationClient({});
 
-// 创建任务
 const task = await client.create({
   prompt: '日落时分的海滩',
-  duration: 5,           // 1-10 秒
-  aspect_ratio: '16:9',  // '16:9' | '9:16' | '1:1'
+  duration: 5,
+  aspect_ratio: '16:9',
   resolution: '720p',
 });
 
-// 轮询直到完成
 const result = await client.poll(task.id, {
-  interval: 3000,
+  interval: 5000,
   timeout: 300000,
 });
 
@@ -26,6 +36,119 @@ if (result.status === 'succeeded') {
 }
 ```
 
+### 使用 content 参数（高级用法）
+
+`content` 参数是一个数组，支持以下类型：
+
+| type | 说明 | 限制 |
+|------|------|------|
+| `text` | 文本提示词 | 必须包含至少一个 |
+| `image_url` | 图像参考/首帧/尾帧 | 最多 9 张，每张 < 30MB |
+| `video_url` | 视频参考（Seedance 2.0） | 最多 3 个，2-15秒，< 50MB |
+| `audio_url` | 音频参考（Seedance 2.0） | 最多 3 个，MP3，< 15MB |
+
+当提供 `content` 时，`prompt` 和 `image_url` 字段将被忽略。
+
+#### 文本生成视频（T2V）
+
+```typescript
+const task = await client.create({
+  model: 'doubao-seedance-2-0-260128',
+  content: [
+    { type: 'text', text: 'A golden retriever running through a sunlit wheat field, cinematic' }
+  ],
+  resolution: '1080p',
+  aspect_ratio: '16:9',
+  duration: 5,
+});
+```
+
+#### 图像生成视频（I2V）
+
+```typescript
+const task = await client.create({
+  model: 'doubao-seedance-2-0-260128',
+  content: [
+    { type: 'text', text: 'The woman slowly turns her head and smiles' },
+    { type: 'image_url', image_url: { url: 'https://example.com/portrait.jpg' } }
+  ],
+  aspect_ratio: 'adaptive',
+  duration: 5,
+});
+```
+
+#### 首尾帧控制
+
+提供两张图片，模型自动识别为首尾帧模式，生成中间过渡动画：
+
+```typescript
+const task = await client.create({
+  model: 'doubao-seedance-2-0-260128',
+  content: [
+    { type: 'text', text: 'The flower blooms from bud to full open, macro lens' },
+    { type: 'image_url', image_url: { url: 'https://example.com/flower-bud.jpg' } },
+    { type: 'image_url', image_url: { url: 'https://example.com/flower-open.jpg' } }
+  ],
+  aspect_ratio: 'adaptive',
+  duration: 8,
+});
+```
+
+#### 多模态参考（Seedance 2.0）
+
+Seedance 2.0 支持同时传入图像、视频、音频参考：
+
+```typescript
+const task = await client.create({
+  model: 'doubao-seedance-2-0-260128',
+  content: [
+    { type: 'text', text: 'Match the visual style and add background audio' },
+    { type: 'image_url', image_url: { url: 'https://example.com/style-ref.jpg' } },
+    { type: 'video_url', video_url: { url: 'https://example.com/motion-ref.mp4' } },
+    { type: 'audio_url', audio_url: { url: 'https://example.com/bgm.mp3' } }
+  ],
+  duration: 10,
+  aspect_ratio: '16:9',
+});
+```
+
+### 参数说明
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `prompt` | `string` | 文本提示词（简化用法，与 content 二选一） |
+| `image_url` | `string` | 图像 URL（简化用法，与 content 二选一） |
+| `model` | `string` | 模型名称（默认: doubao-seedance-1-0-pro-fast-251015） |
+| `content` | `VideoGenerationContent[]` | 内容列表（高级用法，支持 text/image_url/video_url/audio_url） |
+| `duration` | `number` | 视频时长（秒），1.x: 1-10，2.0: 5-15 |
+| `aspect_ratio` | `string` | 宽高比: "16:9" / "9:16" / "1:1" / "adaptive" |
+| `resolution` | `string` | 分辨率: "720p" / "1080p" / "2k" |
+| `callback_url` | `string` | 回调 URL（任务完成时通知） |
+| `return_last_frame` | `boolean` | 是否返回最后一帧图像（用于链式生成） |
+
+### 轮询与链式生成
+
+使用 `return_last_frame: true` 获取最后一帧，将其作为下一段视频的首帧，实现长视频链式生成：
+
+```typescript
+const task1 = await client.create({
+  prompt: 'Scene 1: sunrise over mountains',
+  return_last_frame: true,
+  duration: 5,
+});
+const result1 = await client.poll(task1.id);
+
+if (result1.status === 'succeeded' && result1.content?.last_frame_url) {
+  const task2 = await client.create({
+    content: [
+      { type: 'text', text: 'Scene 2: camera zooms into the valley' },
+      { type: 'image_url', image_url: { url: result1.content.last_frame_url } }
+    ],
+    duration: 5,
+  });
+}
+```
+
 ## 豆包视频理解
 
 使用 `VideoUnderstandingClient` 分析视频内容。基于 Chat Completions API，支持传入视频 URL 进行理解分析。
@@ -48,7 +171,6 @@ import { VideoUnderstandingClient } from 'ai-world-sdk';
 
 const client = new VideoUnderstandingClient({});
 
-// 一行代码分析视频
 const description = await client.analyzeVideo(
   'https://example.com/video.mp4',
   { prompt: '请详细描述这个视频的内容' }
@@ -63,11 +185,11 @@ const response = await client.understand({
   video_url: 'https://example.com/video.mp4',
   prompt: '这个视频讲了什么？',
   model: 'doubao-seed-2-0-pro-260215',
-  fps: 1,         // 可选，视频采样帧率，默认为1秒，即每秒从视频中抽取一帧图像
+  fps: 1,
 });
 
 console.log(response.choices[0].message.content);
-console.log(response.usage); // { prompt_tokens, completion_tokens, total_tokens }
+console.log(response.usage);
 ```
 
 ### 流式请求
@@ -115,7 +237,7 @@ const response = await client.understand({
 });
 ```
 
-### 参数说明
+### 视频理解参数说明
 
 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|