@infimind/video-mcp-cli 1.0.8 → 1.0.10

package/README.md

@@ -100,6 +100,8 @@ Parameter applicability:
 | `sourceImages` | Not supported | allinone / firstlast images | reference / edit reference images |
 | `sourceVideos` | Not supported | allinone reference videos | edit input videos |
 | `sourceAudios` | Not supported | allinone reference audio | Not supported |
+| `sourceVideoDurationSeconds` | Not supported | dryRun estimate for videos | dryRun estimate for edit video |
+| `sourceAudioDurationSeconds` | Not supported | dryRun estimate for audio | Not supported |
 | `taskMode` | Not needed | `allinone` / `firstlast` | `standard` / `reference` / `edit` |
 | `resolution` | Not supported | `720p` / `1080p` | `720p` / `1080p` |
 | `ratio` | Not supported | Not supported | reference or text-to-video standard mode |
@@ -107,7 +109,7 @@ Parameter applicability:
 | `webSearchEnabled` | Not supported | Optional | Not supported |
 | `dryRun` | Optional preflight | Optional preflight | Optional preflight |
 
-Local file paths and public URLs are both supported. Local files are converted to base64 by the MCP server before being sent to the API.
+Local file paths and public URLs are both supported.
 
 Video inputs support MP4/MOV. Audio inputs support MP3/WAV. The server validates media duration, size, count, resolution, and URL safety before estimating credits or creating tasks.
 
@@ -119,16 +121,15 @@ Media limits:
 - S5 firstlast: up to 2 images; the first frame is required.
 - S6 reference: up to 9 images.
 - S6 edit: up to 1 video and 5 images.
-- `inputDurationTier` is not accepted from clients; the server calculates it from the media.
 
 URL safety rules:
 
 - Only `http` and `https` URLs are accepted.
 - `localhost`, `127.0.0.1`, private network addresses, reserved IP ranges, and `file:` URLs are rejected.
 - Redirect targets are revalidated.
-- Remote files that are too large, not media, or cannot be safely probed are rejected.
+- Remote files that are too large, not media, or cannot be read safely are rejected.
 
-Use `dryRun: true` to validate parameters, VIP access, estimated credits, and media rules without creating a task or deducting credits. The result includes `success`, `dryRun`, `route`, `engineName`, `taskMode`, `estimatedCredits`, `remainingCredits`, and `validationWarnings`. Specific credit tables are server-side only; use dry run to get the current estimated consumption.
+Use `dryRun: true` to validate parameters, VIP access, media rules, and estimated credits without creating a task or deducting credits. If a dry run includes video or audio, add `sourceVideoDurationSeconds` / `sourceAudioDurationSeconds` to get an estimated credit result. If these duration fields are omitted, dry run can still pass, but the result may not include `estimatedCredits`.
 
 #### Dry run before creating a task
 
@@ -147,6 +148,8 @@ Use `dryRun: true` to validate parameters, VIP access, estimated credits, and me
 
 #### 极睿Sa专业版 - 标准生成
 
+S2 uses `sourceImage`, `seconds`, and `size`; do not pass `taskMode` or `resolution`.
+
 ```json
 {
   "prompt": "一个高质感的产品展示视频，柔和布光，镜头缓慢推进",
@@ -170,6 +173,8 @@ Use `dryRun: true` to validate parameters, VIP access, estimated credits, and me
   "sourceImages": ["/path/to/reference.jpg"],
   "sourceVideos": ["/path/to/reference.mp4"],
   "sourceAudios": ["/path/to/music.mp3"],
+  "sourceVideoDurationSeconds": [5],
+  "sourceAudioDurationSeconds": [5],
   "seconds": 10,
   "size": "720x1280",
   "resolution": "720p",
@@ -251,12 +256,13 @@ Image-to-video:
   "taskMode": "edit",
   "sourceVideos": ["/path/to/input.mp4"],
   "sourceImages": ["/path/to/reference.jpg"],
+  "sourceVideoDurationSeconds": [5],
   "resolution": "720p",
   "dryRun": true
 }
 ```
 
-After dry run succeeds and `estimatedCredits` looks correct, remove `dryRun` or set it to `false` to create the real task. After creating a task, use `get_video_status` with the returned `taskId` to query progress and video links.
+After dry run succeeds and the estimated credits look correct, remove `dryRun` or set it to `false` to create the real task. After creating a task, use `get_video_status` with the returned `taskId` to query progress and video links.
 
 ## Development
 

package/dist/server.js

@@ -67,8 +67,7 @@ export function createServer(token, apiBaseUrl) {
                 name: "create_video_task",
                 title: "创建视频生成任务",
                 description: "创建视频生成任务。支持本地文件路径或公网 URL 作为参考图片。" +
-                    "支持极睿Sd专业版和极睿Ha专业版的多模态素材输入。" +
-                    "提示词会根据目标语言自动翻译和优化。",
+                    "支持极睿Sd专业版和极睿Ha专业版的多模态素材输入。",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -78,23 +77,33 @@ export function createServer(token, apiBaseUrl) {
                         },
                         sourceImage: {
                             type: "string",
-                            description: "可选的单张参考图片。S2 使用此字段；S6 标准模式可用作单图图生视频。可以是本地文件路径或公网 URL，本地文件会被自动转换为 base64",
+                            description: "可选的单张参考图片。S2 使用此字段；S6 标准模式可用作单图图生视频。可以是本地文件路径或公网 URL",
                         },
                         sourceImages: {
                             type: "array",
-                            description: "S5/S6 多张参考图片。本地文件路径或公网 URL 数组；本地文件会被自动转换为 base64。S5 首尾帧模式下第1张为首帧、第2张为尾帧；S6 reference/edit 模式作为参考图",
+                            description: "S5/S6 多张参考图片。本地文件路径或公网 URL 数组。S5 首尾帧模式下第1张为首帧、第2张为尾帧；S6 reference/edit 模式作为参考图",
                             items: { type: "string" },
                         },
                         sourceVideos: {
                             type: "array",
-                            description: "S5 全能参考或 S6 视频编辑模式的视频素材。本地文件路径或公网 URL 数组；本地文件会被自动转换为 base64",
+                            description: "S5 全能参考或 S6 视频编辑模式的视频素材。本地文件路径或公网 URL 数组",
                             items: { type: "string" },
                         },
                         sourceAudios: {
                             type: "array",
-                            description: "S5 全能参考模式的音频素材。本地文件路径或公网 URL 数组；本地文件会被自动转换为 base64",
+                            description: "S5 全能参考模式的音频素材。本地文件路径或公网 URL 数组",
                             items: { type: "string" },
                         },
+                        sourceVideoDurationSeconds: {
+                            type: "array",
+                            description: "可选。dryRun 使用的视频素材时长秒数数组，顺序与 sourceVideos 一致；用于获得预估积分",
+                            items: { type: "number" },
+                        },
+                        sourceAudioDurationSeconds: {
+                            type: "array",
+                            description: "可选。dryRun 使用的音频素材时长秒数数组，顺序与 sourceAudios 一致；用于获得预估积分",
+                            items: { type: "number" },
+                        },
                         size: {
                             type: "string",
                             description: "视频方向/比例。S2 支持横竖屏；S5/S6 还支持正方形、4:3、3:4（默认：1280x720）",
@@ -163,6 +172,7 @@ export function createServer(token, apiBaseUrl) {
                         videoCount: { type: "number" },
                         dryRun: { type: "boolean" },
                         estimatedCredits: { type: "number" },
+                        estimateSource: { type: "string" },
                         remainingCredits: { type: "number" },
                         statusHint: { type: "string" },
                         validationWarnings: {
@@ -245,13 +255,13 @@ export function createServer(token, apiBaseUrl) {
                 name: "create_video_analysis_task",
                 title: "创建视频拆解任务",
                 description: "创建视频拆解任务，将视频拆解为脚本、风格、卖点话术、爆款公式，并生成用于视频创作的提示词。" +
-                    "支持本地文件路径或公网 URL 作为视频文件。本地文件会被自动转换为 base64。",
+                    "支持本地文件路径或公网 URL。",
                 inputSchema: {
                     type: "object",
                     properties: {
                         videoFile: {
                             type: "string",
-                            description: "要分析的视频文件 - 可以是本地文件路径（如 /path/to/video.mp4）或公网 URL。本地文件会被自动转换为 base64",
+                            description: "要分析的视频文件，可以是本地文件路径或公网 URL",
                         },
                     },
                     required: ["videoFile"],
@@ -361,8 +371,8 @@ async function handleGetUserInfo(apiBaseUrl, token) {
         `# 用户信息`,
         ``,
         `- **用户名**: ${response.username}`,
-        `- **姓名**: ${response.name || "N/A"}`,
-        `- **邮箱**: ${response.email || "N/A"}`,
+        `- **姓名**: ${response.name || "未提供"}`,
+        `- **邮箱**: ${response.email || "未提供"}`,
         `- **角色**: ${response.role === "admin" ? "管理员" : "用户"}`,
         `- **积分**: ${response.credits}`,
         `- **VIP 状态**: ${response.isVip ? "是" : "否"}`,
@@ -495,9 +505,6 @@ function validateCreateVideoArgs(args) {
     const taskMode = normalizeTaskMode(route, args.taskMode);
     const resolution = typeof args.resolution === "string" ? args.resolution : "720p";
     const dryRun = args.dryRun === true;
-    if (args.inputDurationTier !== undefined) {
-        throw new McpToolError("inputDurationTier 不再支持由 MCP 传入；输入视频时长档位由服务端根据素材自动计算。", "UNSUPPORTED_FIELD", route);
-    }
     if ((route === "S5" || route === "S6") && resolution !== "720p" && resolution !== "1080p") {
         throw new McpToolError(`${getMcpEngineName(route)} 仅支持 720p 或 1080p。`, "INVALID_RESOLUTION", route);
     }
@@ -591,26 +598,36 @@ function validateCreateVideoArgs(args) {
  */
 async function handleCreateVideoTask(apiBaseUrl, token, args) {
     const normalized = validateCreateVideoArgs(args);
-    const response = await callRestApi(apiBaseUrl, "/mcp/video/create", {
+    const isProfessionalRoute = normalized.route === "S5" || normalized.route === "S6";
+    const requestBody = {
         token,
         prompt: args.prompt,
-        sourceImage: args.sourceImage ? (await processFileInput(args.sourceImage, "image")).data : undefined,
-        sourceImages: await processFileInputs(args.sourceImages, "image"),
-        sourceVideos: await processFileInputs(args.sourceVideos, "video"),
-        sourceAudios: await processFileInputs(args.sourceAudios, "audio"),
+        sourceImage: args.sourceImage
+            ? (await processFileInput(args.sourceImage, "image")).data
+            : undefined,
         size: args.size || "1280x720",
         seconds: args.seconds || 10,
         language: args.language || "zh-CN",
         count: args.count || 1,
         route: normalized.route,
-        taskMode: normalized.taskMode,
-        isFirstLastMode: normalized.taskMode === "firstlast",
-        resolution: normalized.resolution,
-        ratio: args.ratio || undefined,
-        generateAudio: args.generateAudio,
-        webSearchEnabled: args.webSearchEnabled,
         dryRun: normalized.dryRun,
-    }, "POST");
+    };
+    if (isProfessionalRoute) {
+        requestBody.sourceImages = await processFileInputs(args.sourceImages, "image");
+        requestBody.sourceVideos = await processFileInputs(args.sourceVideos, "video");
+        requestBody.sourceAudios = await processFileInputs(args.sourceAudios, "audio");
+        requestBody.taskMode = normalized.taskMode;
+        requestBody.isFirstLastMode = normalized.taskMode === "firstlast";
+        requestBody.resolution = normalized.resolution;
+        requestBody.ratio = args.ratio || undefined;
+        requestBody.generateAudio = args.generateAudio;
+        requestBody.webSearchEnabled = args.webSearchEnabled;
+        if (normalized.dryRun) {
+            requestBody.sourceVideoDurationSeconds = args.sourceVideoDurationSeconds;
+            requestBody.sourceAudioDurationSeconds = args.sourceAudioDurationSeconds;
+        }
+    }
+    const response = await callRestApi(apiBaseUrl, "/mcp/video/create", requestBody, "POST");
     const route = response.route || normalized.route;
     const engineName = response.engineName || getMcpEngineName(route);
     const taskMode = response.taskMode || normalized.taskMode;
@@ -624,9 +641,11 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
         `- **模式**: ${taskMode}`,
         `- **消息**: ${response.message}`,
         `- **生成视频数量**: ${response.videoCount}`,
-        `- **预估积分**: ${estimatedCredits ?? "N/A"}（视频完成后按成功扣费）`,
         `- **当前积分**: ${response.remainingCredits}`,
     ];
+    if (typeof estimatedCredits === "number") {
+        result.splice(6, 0, `- **预估积分**: ${estimatedCredits}（视频完成后按成功扣费）`);
+    }
     if (!dryRun && response.taskId !== undefined) {
         result.splice(4, 0, `- **任务 ID**: ${response.taskId}`);
     }
@@ -650,6 +669,7 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
             videoCount: response.videoCount,
             dryRun,
             estimatedCredits,
+            estimateSource: response.estimateSource,
             remainingCredits: response.remainingCredits,
             statusHint,
             validationWarnings: response.validationWarnings || [],

package/dist/videoRules.d.ts

@@ -1,6 +1,6 @@
 export type McpRoute = "S2" | "S5" | "S6";
 export type McpTaskMode = "allinone" | "firstlast" | "standard" | "reference" | "edit";
-export declare const MCP_SERVER_VERSION = "1.0.5";
+export declare const MCP_SERVER_VERSION = "1.0.10";
 export declare const MCP_VIDEO_STATUS_HINT = "\u4EFB\u52A1\u5DF2\u521B\u5EFA\u540E\uFF0C\u4F7F\u7528 get_video_status \u5E76\u4F20\u5165 taskId \u67E5\u8BE2\u751F\u6210\u8FDB\u5EA6\u548C\u89C6\u9891\u94FE\u63A5\u3002";
 export declare const MCP_VIDEO_DRY_RUN_HINT = "dryRun \u4EC5\u5B8C\u6210\u53C2\u6570\u3001\u6743\u9650\u3001\u79EF\u5206\u548C\u7D20\u6750\u89C4\u5219\u9884\u68C0\uFF0C\u4E0D\u4F1A\u521B\u5EFA\u4EFB\u52A1\u6216\u6263\u8D39\u3002";
 export declare const MCP_VIDEO_ENGINES: Record<McpRoute, {

package/dist/videoRules.js

@@ -1,4 +1,4 @@
-export const MCP_SERVER_VERSION = "1.0.5";
+export const MCP_SERVER_VERSION = "1.0.10";
 export const MCP_VIDEO_STATUS_HINT = "任务已创建后，使用 get_video_status 并传入 taskId 查询生成进度和视频链接。";
 export const MCP_VIDEO_DRY_RUN_HINT = "dryRun 仅完成参数、权限、积分和素材规则预检，不会创建任务或扣费。";
 export const MCP_VIDEO_ENGINES = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infimind/video-mcp-cli",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "MCP Server for Sora AI Video Generator - Access video generation features through Claude Desktop",
   "type": "module",
   "main": "dist/index.js",