@mindscraft/branch-video-agent-cli 0.3.6 → 0.4.1

package/README.md

@@ -31,7 +31,9 @@ branch-video-agent --version
 - `AIHUB_AGENT_TOKEN`
 - `BRANCH_VIDEO_AGENT_BASE_URL`
 
-AI Gateway 调用同样只传 `AIHUB_AGENT_TOKEN`；CLI 不读取、不传递 `AiGatewayKey` 或 AIHub `projectKey`，上游鉴权由服务端处理。
+AI Gateway 调用同样只传 `AIHUB_AGENT_TOKEN`；CLI 不读取、不传递 `AiGatewayKey` 或 AIHub `projectKey`，上游鉴权由服务端处理。
+
+AI Gateway 生产媒体验收使用 `ai-gateway media-understand --raw`。P0 模型固定为 `doubao-seed-2-0-mini-260215`，输入为带 SHA-256 的公共 HTTPS 图片/视频 URL、一个 candidate、可选 reference、prompt 与 criteria；输出为 `media_acceptance_review.v1`。该能力只判断可见画面，不声称分析视频音轨。`kimi-k3` 和 `MiniMax-M3` 在真实 payload Canary 通过前不可调用。
 
 最小调用示例：
 
@@ -69,7 +71,7 @@ AIHub 导入公共库示例：
   "name": "判断题-增强版",
   "defaultThemeId": "cat",
   "urlsByTheme": {
-    "cat": "https://aic-view.sdp.101.com/view/judge-base-v2"
+    "cat": "https://aic-view.sdp.cn.ndhy.com/view/judge-base-v2"
   },
   "configTemplate": {
     "waitForPageReady": true
@@ -142,17 +144,30 @@ Banana Pro 图片编辑继续使用 `ai-gateway image-edit`，请求体为 JSON
 
 AI Gateway 视频生成并等待示例：
 
+Seedance 2.5 必须使用完整模型名 `doubao-seedance-2-5-260628`。使用 `--wait --raw` 时，CLI 会始终轮询创建响应中的 task ID，并原样保留最终 `video_url` 与 `last_frame_url`。
+
 ```powershell
 @'
 {
-  "model": "doubao-seedance-2-0-260128",
-  "input": {
-    "prompt": "镜头推进到实验台，卡通猫老师点亮一个小灯泡"
-  }
+  "model": "doubao-seedance-2-5-260628",
+  "content": [
+    {
+      "type": "text",
+      "text": "镜头推进到实验台，卡通猫老师点亮一个小灯泡"
+    }
+  ],
+  "omni_reference_task_type": "auto",
+  "duration": 4,
+  "resolution": "720p",
+  "output_format": "mp4",
+  "return_last_frame": true,
+  "generate_audio": false
 }
 '@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- ai-gateway video-create -- --wait --raw
 ```
 
+Seedance 2.5 支持 480p、720p、1080p 和 4–30 秒生成；在播放器兼容性完成验证前，推荐 480p/720p + MP4。完整的多图片/视频/音频参考数量限制，以及 `reference`、`edit`、`extend` 的差异，见仓库 Skill 的 `references/ai-gateway-parameters.md`。
+
 AI Gateway Seed Audio 音频生成并等待示例：
 
 ```powershell

package/dist/commands/aiGateway.js

@@ -8,6 +8,21 @@ function ensureObject(value, fieldName) {
     }
     return value;
 }
+function validateMediaUnderstandingPayload(payload) {
+    for (const field of ['production_task_id', 'model', 'profile', 'prompt']) {
+        getRequiredString(payload, field);
+    }
+    if (!Array.isArray(payload.media) || payload.media.length === 0) {
+        throw new CliCommandError('media must be a non-empty JSON array', 'VALIDATION_ERROR');
+    }
+    if (!Array.isArray(payload.criteria) || payload.criteria.length === 0) {
+        throw new CliCommandError('criteria must be a non-empty JSON array', 'VALIDATION_ERROR');
+    }
+    const candidates = payload.media.filter((item) => isJsonRecord(item) && item.role === 'candidate');
+    if (candidates.length !== 1) {
+        throw new CliCommandError('media must contain exactly one candidate', 'VALIDATION_ERROR');
+    }
+}
 function normalizeOperation(value) {
     return value.trim().replace(/^\/+/, '');
 }
@@ -174,6 +189,14 @@ export const aiGatewayCommands = {
         });
         return { data: result.data, requestId: result.requestId };
     },
+    'media-understand': async ({ client, payload }) => {
+        validateMediaUnderstandingPayload(payload);
+        const result = await client.request('/api/agent/ai-gateway/media/understand', {
+            method: 'POST',
+            body: payload,
+        });
+        return { data: result.data, requestId: result.requestId };
+    },
     'image-generate': async ({ client, payload }) => {
         const result = await client.request('/api/agent/ai-gateway/images/generations', {
             method: 'POST',

package/dist/lib/flags.js

@@ -100,7 +100,7 @@ export function getCliHelpText() {
         '  agent-production create | status | cancel | finalize | autopilot-binding | events | metrics | multica-comment-payload | node claim|inputs|complete|submit|block|fail|retry|expire | blocker resolve | artifact submit|list | asset-job poll|retry|revise|attach-artifact|fail | gate evaluate|results',
         '  aihub-production schema | start | status | retry',
         '  character  search | create | get',
-        '  ai-gateway capabilities | request | image-generate | image-edit | video-create | video-get | seed-audio-create | seed-audio-get | music-submit | music-get | tts-create | tts-get',
+        '  ai-gateway capabilities | request | media-understand | image-generate | image-edit | video-create | video-get | seed-audio-create | seed-audio-get | music-submit | music-get | tts-create | tts-get',
         '',
         'Config precedence:',
         '  AIHUB_AGENT_TOKEN / BRANCH_VIDEO_AGENT_BASE_URL > stdin JSON or --token-file > command flags',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindscraft/branch-video-agent-cli",
-  "version": "0.3.6",
+  "version": "0.4.1",
   "description": "Published CLI for branch-video and AIHub agent APIs.",
   "type": "module",
   "bin": {