AI MediaKit 的 AIGC 视频生成质量评估工具，面向 AIGC 视频生产场景，对视频（可选结合参考图）按需检查参考信息一致性、世界合理性、内容持续性、视觉保真度等质量问题，自动定位异常时间区间、输出问题说明与典型问题帧，帮助您快速完成采用、复核或重新生成决策。它既可独立用于生成结果检查，也可接入创作 Agent，形成「视频生成 — 质量检查 — 人工复核或重新生成」的生产闭环。本篇开发指南将引导您： * 了解 AIGC 视频质量评估的检测模块与问题类型。 * 快速体验如何对一段 AIGC 视频进行全模块质量评估。 * 掌握按场景组合检查模块，以及结合参考图检查参考信息一致性的用法。 ## 检测模块与问题类型 AIGC 视频质量评估工具通过 `modules` 参数提供 4 个检测模块，覆盖 AIGC 视频生产中最常见的质量问题。您可以按业务场景自由组合，每个模块检出的问题会在结果中标注所属 `module` 与具体问题类型 `type`。 |检测模块（`module`） |说明 |典型问题类型 | |---|---|---| |`reference_consistency`

参考信息一致性 |对比视频中的元素与您提供的参考图是否一致。 |人物身份一致性、人物服饰一致性、商品外观一致性、场景一致性 | |`world_plausibility`

世界合理性 |检查画面是否符合物理与运动规律。 |重力规律、碰撞规律、流体行为、支撑平衡、惯性运动连续性、光影反射一致性、尺度透视一致性、人体交互与穿戴异常、实体异常、其他物理异常 | |`content_continuity`

内容持续性 |识别视频中的主角与主商品，判断其在完整时序内是否保持一致。 |人物身份持续性、商品外观持续性 | |`visual_fidelity`

视觉保真度 |检查生成画面的结构合理性与自然度（AI 感）。 |自然度、人体结构、物体结构、文字结构（支持中、英文字体结构检测） | ## 应用场景 * **AI 短剧与漫剧质检**：检查角色面貌、服装、道具与场景的一致性，以及动作连贯性、物理合理性等问题，避免角色变脸、物体突变、剧情穿帮。 * **电商广告素材视频质检**：结合参考图，检查商品外观、颜色、Logo、包装文字、品牌元素等是否保持一致，识别商品变形、画面时序和物理表现等问题。 * **创作 Agent 生成闭环**：视频生成后自动触发质量检查，合格视频进入编辑环节，疑似问题视频转人工复核，严重问题视频自动重新生成。 ## 快速入门：对 AIGC 视频进行质量评估本节演示如何提交一个 AIGC 视频质量评估任务，在不指定检查模块的情况下，对视频执行全部适用模块的评估。 ### 准备工作 * **获取访问凭证**：在开始之前，请访问 AI MediaKit 控制台的 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **MediaKit API Key**。 * **开通火山方舟大模型服务**：AIGC 视频生成质量评估工具依赖火山方舟（Ark）视觉大模型完成评估。请前往[火山方舟控制台](https://console.volcengine.com/ark)，确认本工具所需的大模型（如 Doubao 系列）已开通且可用。模型能力会影响检测效果，推荐使用 `doubao-seed` 系列中最新的 pro 模型，例如 `doubao-seed-2-1-pro-260628`。 * **完成跨服务授权**：首次使用 AIGC 视频质量评估工具前，请前往 AI MediaKit 控制台的[授权管理页面](https://console.volcengine.com/imp/ai-mediakit/settings?tab=authorization)，授权 AI MediaKit 访问您的 **ARK 火山方舟**资源，否则任务将因权限不足而失败。 * **准备视频文件**：准备一个待评估的视频文件，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 ### 操作流程 AIGC 视频质量评估是一个异步任务，其标准流程如下： 1. 成功调用 `POST /api/v1/tools/evaluate-aigc-video-quality` 提交任务后，您将获得一个任务 ID。 2. 您可以轮询 `GET /api/v1/tasks/{task_id}` 接口，直到任务状态 `status` 变为 `completed`；或者使用[事件回调](https://docs.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，解析响应中的 `result` 字段，即可在 `issues` 中获取检出的问题明细。未检查到问题时 `issues` 为空数组。 #### 第 1 步：提交质量评估任务您需要调用[提交 AIGC 视频质量评估任务 API](https://docs.volcengine.com/docs/6448/2722887)。可直接复制以下 cURL 命令，提交一个执行全部适用模块的评估任务。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/evaluate-aigc-video-quality' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/your_aigc_video.mp4", "prefer_models": ["doubao-seed-2-1-pro-260628"] }' ``` > **说明** * > 将 `{Your_API_Key}` 替换为您的有效 API Key。 * > `video_url`：替换为您自己的视频地址。 * > `prefer_models`：指定评估使用的火山方舟模型 ID (Model ID)。模型能力会影响检测效果，推荐使用 `doubao-seed` 系列中最新的 pro 模型，例如 `doubao-seed-2-1-pro-260628`。您可以在[火山方舟控制台在线推理页面](https://console.volcengine.com/ark/region:ark+cn-beijing/endpoint)查看您账号下可用的模型 ID。请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-evaluate-aigc-video-quality-123456789", "request_id": "20261012194945ABCDEF0123456789" } ``` #### 第 2 步：获取评估结果质量评估任务需要一定的处理时间。您需要轮询[查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532)，直到任务状态 `status` 变为 `completed`。 ```Bash curl -X GET 'https://mediakit.cn-beijing.volces.com/api/v1/tasks/{task_id}' \ -H 'Authorization: Bearer {Your_API_Key}' ``` > **说明** > 将 URL 末尾的 `{task_id}` 替换为第 1 步返回的任务 ID。当任务成功完成后，您将收到如下响应。`result.issues` 数组中的每个对象代表一个检出的问题，包含所属检测模块 `module`、问题类型 `type`、问题描述 `description`、问题出现的时间区间 `time_range`（单位为秒）以及典型问题帧 `annotated_frames`。 ```JSON { "success": true, "task_id": "amk-tool-evaluate-aigc-video-quality-123456789", "request_id": "20261012194945ABCDEF0123456789", "status": "completed", "result": { "duration": 15.134, "issues": [ { "module": "world_plausibility", "type": "motion_rationality", "description": "视频 5-7 秒，人物手部出现穿模，与滚筒不自然地重叠。", "time_range": [[0, 15]], "annotated_frames": [ "https://example.volcvideo.com/evaluation/xxxxxxxx/frame_01.jpg?preview=1&auth_key=***", "https://example.volcvideo.com/evaluation/xxxxxxxx/frame_02.jpg?preview=1&auth_key=***" ] }, { "module": "content_continuity", "type": "product_consistency", "description": "视频 10-12 秒，地坪漆桶的 Logo 发生闪烁和变化，与视频开头不一致。", "time_range": [[0, 15]], "annotated_frames": [ "https://example.volcvideo.com/evaluation/xxxxxxxx/frame_03.jpg?preview=1&auth_key=***", "https://example.volcvideo.com/evaluation/xxxxxxxx/frame_04.jpg?preview=1&auth_key=***" ] } ] }, "expires_at": 1791892453, "created_at": 1791805785, "finished_at": 1791806054 } ``` ## 进阶使用 ### 按场景组合检查模块快速入门中不传 `modules`，执行的是全部适用模块。您也可以通过 `modules` 参数按业务场景自由组合检查维度。可选模块如下： * `reference_consistency`：参考信息一致性。对比视频中的元素与提供的参考图是否一致。启用该模块时必须提供 `reference_images`（数组长度 1~6，每张图需通过 `category` 标注类型：`character`=人物、`clothing`=服饰、`product`=商品、`scene`=场景、`prop`=道具、`other`=其他）。 * `world_plausibility`：世界合理性。检查画面是否符合物理与运动规律（如重力、碰撞、穿模、惯性等）。 * `content_continuity`：内容持续性。检查人物、商品等实体在时间维度上是否保持一致。 * `visual_fidelity`：视觉保真度。检查人体、物体、文字的结构与自然度。以下示例仅检查世界合理性与视觉保真度： ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/evaluate-aigc-video-quality' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/your_aigc_video.mp4", "modules": ["world_plausibility", "visual_fidelity"], "prefer_models": ["doubao-seed-2-1-pro-260628"] }' ``` 当需要校验视频中的元素与设定的参考素材是否一致时，可在 `modules` 中加入 `reference_consistency`，并通过 `reference_images` 提供对应的参考图。以下示例结合商品参考图，检查参考信息一致性与内容持续性： ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/evaluate-aigc-video-quality' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/your_aigc_video.mp4", "modules": ["reference_consistency", "content_continuity"], "prefer_models": ["doubao-seed-2-1-pro-260628"], "reference_images": [ { "image_url": "https://example.com/product_ref.png", "category": "product" } ] }' ``` ### 指定输出语言您可以通过 `output_language` 参数控制问题描述（`issues[].description`）的输出语言，可选 `zh-CN` 或 `en-US`。不传时默认使用中文（`zh-CN`）。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/evaluate-aigc-video-quality' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/your_aigc_video.mp4", "prefer_models": ["doubao-seed-2-1-pro-260628"], "output_language": "en-US" }' ``` ## 参考信息 ### 费用说明 AIGC 视频质量评估工具的费用由两部分组成： * **AI MediaKit 任务费用**：由 AI MediaKit 收取，按输入视频的总时长计费。**公测阶段暂不收取该部分费用**。 * **火山方舟大模型调用费用**：功能运行依赖的底层大模型由火山方舟提供。您通过跨服务授权使用这些模型所产生的费用，将由火山方舟根据其自身定价直接向您收取。关于详细的计费规则与价格，请参阅[火山方舟计费说明](https://www.volcengine.com/docs/82379/1544106?lang=zh)。 ### 使用限制 |限制项 |说明 | |---|---| |输入视频限制 |* 视频来源：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

* 支持格式：`mp4`、`flv`、`ts`、`avi`、`mov`、`wmv`、`mkv` 等主流视频格式。

* 视频时长：单个视频时长不超过 3 分钟。 | |参考图限制 |仅在启用 `reference_consistency` 模块时需要提供 `reference_images`。最少 1 张，最多 6 张。每张图需标注 `category`（`character`/`clothing`/`product`/`scene`/`prop`/`other`）。 | ## 相关 API 文档 * [提交 AIGC 视频质量评估任务 API](https://docs.volcengine.com/docs/6448/2722887) * [查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) * [事件回调](https://docs.volcengine.com/docs/6448/2288701)