@tacoreai/web-sdk 1.21.0 → 1.22.0

package/README.md

@@ -202,30 +202,46 @@ const base64 = result.data.uri || result.data.images?.[0]?.uri;
 
 ---
 
-## [新增] Sora 视频生成
+## [新增] 视频生成（Seedance 2.0）
 
-通过 AppsClient 调用 Sora 视频生成服务。计费将自动关联到应用所属的组织。
+通过 AppsClient 调用统一视频任务接口。当前云模式默认视频模型为 `agent:tacore-3.3`，后端会映射到火山引擎 `doubao-seedance-2-0-260128`。计费将自动关联到应用所属的组织。
 
 ### 定价
-- **sora-2**: 300 积分/次
-- **sora-2-pro**: 1500 积分/次
+- `agent:tacore-3.3`
+  - 输入价格：4
+  - 输出价格：10
 
 ### `createVideoJob(options)`
 - **功能**: 创建一个异步的视频生成任务。
 - **参数**:
   - `options` (object):
-    - `prompt` (string, 必填): 视频描述提示词。
-    - `model` (string, 必填): 模型名称, 'sora-2' 或 'sora-2-pro'。
-    - `size` (string, 可选): 视频尺寸, 默认为 '1920x1080'。
-    - `seconds` (number, 可选): 视频时长, 默认为 6。
+    - `prompt` (string, 推荐): 视频描述提示词。
+    - `content` (array, 推荐): 多模态输入数组，支持：
+      - `{ type: 'text', text: '...' }`
+      - `{ type: 'image_url', image_url: { url: 'https://...' }, role: 'reference_image' }`
+      - `{ type: 'video_url', video_url: { url: 'https://...' }, role: 'reference_video' }`
+      - `{ type: 'audio_url', audio_url: { url: 'https://...' }, role: 'reference_audio' }`
+    - `model` (string, 可选): 默认 `agent:tacore-3.3`。
+    - `generate_audio` (boolean, 可选): 是否生成音频。
+    - `ratio` (string, 可选): 画幅比例，例如 `16:9`。
+    - `duration` (number, 可选): 视频时长（秒）。
+    - `watermark` (boolean, 可选): 是否保留 provider 水印。
+    - `resolution` (string, 可选): 分辨率。
+    - `seed` (number, 可选): 随机种子。
+    - `return_last_frame` (boolean, 可选): 是否返回尾帧。
+    - `providerOptions` (object, 可选): 透传给 provider 的扩展字段。
 - **返回值**: `Promise<object>` - 包含任务初始状态的文档。
 
+### 参考素材上传
+- 图片、视频、音频参考素材必须先调用 `uploadToR2`，然后把返回的公网 `url` 填到 `content` 中。
+- 不要直接把本地 `File`/`Blob`/base64 传给 `createVideoJob`。
+
 ### `remixVideoJob(jobId, options)`
-- **功能**: 基于一个已完成的视频，创建一个新的 Remix 任务。
+- **功能**: 基于一个已完成的视频，创建一个新的 Remix 任务。后端会自动把原视频作为 `reference_video` 注入。
 - **参数**:
   - `jobId` (string, 必填): 原始视频任务的 `wyID`。
   - `options` (object):
-    - `prompt` (string, 必填): 用于修改视频的提示词。
+    - 兼容 `createVideoJob(options)` 的全部字段，至少需要 `prompt` 或 `content`。
 - **返回值**: `Promise<object>` - 包含新的 Remix 任务初始状态的文档。
 
 ### `getVideoJob(jobId)`
@@ -248,10 +264,29 @@ const client = new AppsClient('YOUR_APP_ID');
 
 async function generateAndPollVideo() {
   try {
+    const image = await client.uploadToR2(fileInput.files[0]);
+    const audio = await client.uploadToR2(audioInput.files[0]);
+
     // 1. 提交任务
     const jobResult = await client.createVideoJob({
-      prompt: 'A stylish woman walks down a Tokyo street filled with warm glowing neon and animated city signage.',
-      model: 'sora-2'
+      model: 'agent:tacore-3.3',
+      content: [
+        { type: 'text', text: '第一视角果茶广告短片' },
+        {
+          type: 'image_url',
+          image_url: { url: image.url },
+          role: 'reference_image',
+        },
+        {
+          type: 'audio_url',
+          audio_url: { url: audio.url },
+          role: 'reference_audio',
+        },
+      ],
+      generate_audio: true,
+      ratio: '16:9',
+      duration: 11,
+      watermark: false,
     });
     const jobId = jobResult.data.wyID;
     console.log('视频任务已创建, ID:', jobId);
@@ -401,4 +436,4 @@ Body:
   • 图像编辑：editImage({ messages }) 或 editImage({ prompt, inputs, ... })
   • 单个爬虫：scrapeUrl({ url, projectId? })
   • 批量爬虫：scrapeMultipleUrls({ urls, projectId?, maxConcurrent? })
-- 错误处理：注意处理 401 未登录、402 余额不足、404 组织不存在、500/503 外部服务异常等。
+- 错误处理：注意处理 401 未登录、402 余额不足、404 组织不存在、500/503 外部服务异常等。

package/database/core/apps/AppsClient.Tools.js

@@ -33,4 +33,23 @@ export const appsClientToolsMethods = {
     const result = await this._post("/apps/sensitive/detect", { content });
     return result.data;
   },
-};
+
+  // ==================== 外部工具 ====================
+
+  /**
+   * 执行 Google 搜索
+   * @param {object} options
+   * @param {string} options.query - 搜索关键词
+   * @param {number} [options.num=10] - 返回结果数量 (1-10)
+   * @returns {Promise<{success: boolean, data: Array<{title: string, link: string, snippet: string}>}>}
+   */
+  async googleSearch(options = {}) {
+    if (!options.query) {
+      throw new Error("query is required for googleSearch.");
+    }
+    return this._post("/apps/tools/google-search", {
+      appId: this.appId,
+      ...options,
+    });
+  },
+};

package/database/core/apps/AppsClient.VoiceVideo.js

@@ -46,19 +46,21 @@ export const appsClientVoiceVideoMethods = {
     return response; // 直接返回 Response 对象
   },
 
-  // ==================== 新增：Sora 视频生成 ====================
+  // ==================== 新增：视频生成 ====================
 
   /**
-   * 创建一个 Sora 视频生成任务
-   * @param {object} options - { prompt, model, size, seconds }
+   * 创建一个视频生成任务（默认走豆包 Seedance 2.0）
+   * @param {object} options - { prompt?, content?, model?, generate_audio?, ratio?, duration?, watermark?, resolution?, seed?, return_last_frame?, providerOptions? }
    * @returns {Promise<object>} 视频任务文档
    */
   async createVideoJob(options = {}) {
-    if (!options.prompt || !options.model) {
-      throw new Error("prompt and model are required for video generation.");
+    const hasPrompt = typeof options.prompt === "string" && options.prompt.trim();
+    const hasContent = Array.isArray(options.content) && options.content.length > 0;
+    if (!hasPrompt && !hasContent) {
+      throw new Error("prompt or content is required for video generation.");
     }
-    // The middleware uses appId from the body to find the organization
-    return this._post("/apps/sora/videos", {
+
+    return this._post("/apps/videos/tasks", {
       appId: this.appId,
       ...options,
     });
@@ -67,19 +69,23 @@ export const appsClientVoiceVideoMethods = {
   /**
    * 基于现有视频创建一个 Remix 任务
    * @param {string} jobId - 原始视频任务的 wyID
-   * @param {object} options - { prompt }
+   * @param {object} options - 兼容 createVideoJob 的请求体，后端会自动注入 reference_video
    * @returns {Promise<object>} 新的 Remix 任务初始状态的文档
    */
   async remixVideoJob(jobId, options = {}) {
     if (!jobId) {
       throw new Error("jobId of the original video is required for remixing.");
     }
-    if (!options.prompt) {
-      throw new Error("A new prompt is required for remixing.");
+
+    const hasPrompt = typeof options.prompt === "string" && options.prompt.trim();
+    const hasContent = Array.isArray(options.content) && options.content.length > 0;
+    if (!hasPrompt && !hasContent) {
+      throw new Error("prompt or content is required for remixing.");
     }
-    return this._post(`/apps/sora/videos/${jobId}/remix`, {
+
+    return this._post(`/apps/videos/tasks/${jobId}/remix`, {
       appId: this.appId,
-      prompt: options.prompt,
+      ...options,
     });
   },
 
@@ -92,7 +98,7 @@ export const appsClientVoiceVideoMethods = {
     if (!jobId) {
       throw new Error("jobId is required.");
     }
-    return this._get(`/apps/sora/videos/${jobId}`, { appId: this.appId });
+    return this._get(`/apps/videos/tasks/${jobId}`, { appId: this.appId });
   },
 
   /**
@@ -101,6 +107,6 @@ export const appsClientVoiceVideoMethods = {
    * @returns {Promise<object>} 任务列表和分页信息
    */
   async listVideoJobs(options = {}) {
-    return this._get("/apps/sora/videos", { appId: this.appId, ...options });
+    return this._get("/apps/videos/tasks", { appId: this.appId, ...options });
   },
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tacoreai/web-sdk",
   "description": "This file is for app server package, not the real npm package",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "type": "module",
   "publishConfig": {
     "access": "public",