默认情况下，AI MediaKit 会为异步任务输出的媒体文件生成一个临时下载链接。该链接 24 小时后失效。您需要在此期间下载文件，并上传到自己的存储服务中，操作较为繁琐。为简化这一流程，AI MediaKit 提供处理产物转存的功能。您只需在提交任务时，通过 `media_output_destination` 参数指定您的火山引擎视频点播（VOD）空间或对象存储（TOS）桶作为输出目标。任务完成后，处理产物就会被自动存储至您的存储服务中。届时，您将获得一个 `vod://` 或 `tos://` 格式的资源地址，无需再关心临时链接时效，也省去了手动下载和转存的步骤。本文将引导您了解如何使用这一功能，包括支持的存储目标、准备工作、使用示例和常见问题。

说明

若您希望让 AI MediaKit 从您的 VOD/TOS 读取素材进行处理，请参见多源媒体输入与本地上传。

## 支持的存储目标与地址格式 |目标存储 |如何设置 `media_output_destination` 参数 |存储后的资源地址格式 | |---|---|---| |火山引擎视频点播（VOD） |`vod://<您的空间名>` |`vod://<空间名>/<媒资ID>` | |火山引擎对象存储（TOS） |`tos://<您的桶名>` |`tos://<桶名>/<对象Key>` |

说明

仅限异步任务：产物存储至 VOD/TOS 功能仅适用于异步执行的工具。对于同步返回结果的工具（如图像处理工具），此功能不适用。

并非所有产物都支持存储至 VOD 或 TOS：

某些工具的产物并非媒体文件（例如，高光分析工具输出的是 JSON 格式的分析结果），因此不支持存储至 VOD 或 TOS。

某些工具的返回结果中的某些辅助性产物（如封面图、抽帧小图等）可能仍然以临时链接形式提供，例如高光智剪（短剧）生成的视频封面图。

具体某个工具或字段是否支持，请以其对应的 API 文档为准。

## 准备工作（跨服务授权）首次使用此功能前，您需要先授权 AI MediaKit 将文件写入您的 VOD 空间或 TOS 桶。请前往 AI MediaKit 控制台[基础配置 > 授权管理](https://console.volcengine.com/imp/ai-mediakit/settings?tab=authorization&projectName=default)页面，根据您的需要，为 AI MediaKit 服务授予相应的权限。这是一个一次性的配置。 ## 使用示例以下展示了在不同场景下，如何通过 `media_output_destination` 参数将处理产物自动存储至您的 VOD 或 TOS。 ### 示例 1：将拼接后的视频存储至 VOD 以下请求展示了如何调用[提交视频拼接任务 API](https://www.volcengine.com/docs/6448/2288706)，并将处理产物自动存储至名为 `space-test2` 的 VOD 空间。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/concat-video' \ -H 'Authorization: Bearer {Your_MediaKit_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_urls": [ "https://example.com/intro.mp4", "https://example.com/main_content.mp4" ], "media_output_destination": "vod://space-test2" }' ``` 任务完成后，您通过[查询任务信息 API](https://www.volcengine.com/docs/6448/2278532) 或[事件回调](https://www.volcengine.com/docs/6448/2288701)获得的 `result.video_url` 的值将是形如 `vod://space-test2/v0cd7ag7007bd77iil7og65hfa66gqsg` 这样的地址。 ### 示例 2：将画质增强后的视频存储至 TOS 指定目录以下请求展示了如何调用[提交画质增强（标准版和专业版）任务 API](https://www.volcengine.com/docs/6448/2279230) 对一个存储在 TOS 中的视频进行画质增强，并将结果存储至同一 TOS 桶下的 `enhanced` 目录中。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/enhance-video' \ -H 'Authorization: Bearer {Your_MediaKit_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "tos://my-bucket/raw/gameplay.mp4", "tool_version": "professional", "resolution": "1080p", "media_output_destination": "tos://my-bucket" }' ``` 处理后的文件将被存储至 `my-bucket` 桶。 ### 示例 3：读取 VOD 视频处理后，再存回 VOD 此示例展示了一个完整的工作流：从一个 VOD 空间读取源视频，进行画质增强处理，然后将结果存储至另一个 VOD 空间。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/enhance-video' \ -H 'Authorization: Bearer {Your_MediaKit_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "vod://space-input/v0cd7ag7007bd77iil7og65hfa66gqsg", "resolution": "1080p", "media_output_destination": "vod://space-output" }' ``` 任务完成后，您通过[查询任务信息 API](https://www.volcengine.com/docs/6448/2278532) 或[事件回调](https://www.volcengine.com/docs/6448/2288701)获得的 `result.video_url` 的值将是形如 `vod://space-test2/v0cd7ag7007bd77iil7og65hfa66gqsg` 这样的地址。 ## 使用限制在指定输出目标前，请确保您的 VOD 空间或 TOS 桶满足以下条件，否则任务可能因无法写入而失败。 * 存储至 VOD 的限制：空间的存储地址必须是点播存储，不支持您自己[添加的对象存储 Bucket](https://www.volcengine.com/docs/4/65676?lang=zh#%E6%B7%BB%E5%8A%A0%E5%AF%B9%E8%B1%A1%E5%AD%98%E5%82%A8-bucket)。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/ee22b1ee935a49d0939e27d535fca417) * 存储至 TOS 的限制：TOS 存储桶地域的必须位于“华北2（北京）”地域 (`cn-beijing`)，暂不支持其他地域。 ## 常见问题 ### 如何获取我的 VOD 空间名或 TOS 桶名？在使用此功能前，您需要先获取目标 VOD 空间或 TOS 桶的准确名称。 * **获取 VOD 空间名 (space name)** ： 1. 前往[视频点播控制台](https://console.volcengine.com/vod/region:vod+cn-north-1/overview/)。 2. 在**空间管理**页面的列表中，找到您想用于存储的 VOD 空间。下图红框处即是您需要填入 `vod://` 地址中的名称。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/acc0ef94d1044213adb4ef365b67bc6c) * **获取 TOS 桶名 (bucket name)** ： 1. 前往[对象存储控制台](https://console.volcengine.com/tos/bucket)。 2. 在**桶列表**页面中，找到您想用于存储的 TOS 桶。下图红框处的桶名称即是您需要填入 `tos://` 地址中的名称。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/3ecfe0fa60184a59906b9003c2da5561) ### 产物存储成功后，如何查看和使用文件？任务成功后，您会得到一个 `vod://` 或 `tos://` 格式的资源地址。这个地址是 AI MediaKit 等火山引擎服务之间识别媒体文件的“内部ID”，并不是一个可直接播放或下载的公开 URL。您可以通过以下方式查看已存储的产物文件，并获取公开访问链接： * **如果文件存储在 VOD**： 1. 前往火山引擎[视频点播控制台](https://console.volcengine.com/vod/region:vod+cn-north-1/overview/)。 2. 在**空间管理**页面，进入对应的 VOD 空间。 3. 您可以在列表中找到新存入的视频文件，也可以使用返回地址中的资源 ID (Vid) 进行精确搜索。 4. 找到文件后，您可以进行获取播放地址、发布视频、配置 CDN 加速等后续操作。 * **如果文件存储在 TOS**： 1. 前往[对象存储控制台](https://console.volcengine.com/tos/bucket)。 2. 单击目标桶名称，进入**文件列表**页面。 3. 您可以在文件列表中找到新存入的媒体文件。 4. 找到文件后，您可以获取文件 URL、配置权限或进行其他操作。 ### 将处理产物存储至 VOD 或 TOS 是否会产生额外费用？处理产物存储至 VOD 或 TOS 功能本身免费，TOS/VOD 写回过程也不会产生流量费用。AI MediaKit 仅对您使用的各项媒体处理能力（如画质增强、视频剪辑等）进行计费。当文件成功存储至您的 VOD 或 TOS 后，产生的存储费用及其他后续使用费用将由对应的云服务（视频点播或对象存储）根据其标准单独计费。

智能处理