您可以通过 AI MediaKit 调用已在[火山方舟](https://www.volcengine.com/product/ark)开通的视频生成大模型（如 Doubao\-Seedance 系列），用一段文本提示词生成视频，无需再单独对接火山方舟接口。本篇开发指南将引导您快速体验如何通过 AI MediaKit 调用视频生成大模型，用一段文本提示词生成视频。 ## 快速入门本节以用一句文本提示词生成一段 5 秒短视频为例，演示通过 AI MediaKit 调用视频生成大模型的完整流程。 ### 准备工作 * **开通模型**：在[火山方舟](https://www.volcengine.com/product/ark)控制台开通所需的视频生成模型（如 Doubao\-Seedance 系列），并记录可用的模型 ID 或推理接入点 ID。 * **进行跨服务授权**：前往 AI MediaKit 控制台[授权管理页面](https://console.volcengine.com/imp/ai-mediakit/settings?tab=authorization&projectName=default)，为 AI MediaKit 授予访问您**火山方舟**资源的权限。 * **获取访问凭证**：访问 AI MediaKit 控制台的 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **MediaKit API Key**。 ### 操作流程通过 AI MediaKit 调用视频生成大模型是一个异步任务，其标准流程如下： 1. 调用 `POST /api/v1/tools/call-maas-proxy` 提交任务，`api` 设为 `ark.video_generation`，即可获得一个任务 ID。 2. 轮询 `GET /api/v1/tasks/{task_id}` 接口，直到任务状态 `status` 变为 `completed`；或使用[事件回调](https://docs.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，从响应 `result.maas_result` 中读取火山方舟视频生成接口返回的原始结果（如生成视频地址）。 #### 第 1 步：提交视频生成任务调用[MaaS 模型代理 API](https://docs.volcengine.com/docs/6448/2700933)。可直接复制以下 cURL 命令，用一句提示词提交一个视频生成任务。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/call-maas-proxy' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "api": "ark.video_generation", "maas_params": { "model": "doubao-seedance-2-5-260628", "content": [ { "type": "text", "text": "一只橘猫在洒满阳光的草地上奔跑，电影质感，景深虚化" } ], "resolution": "720p", "ratio": "16:9", "duration": 5 } }' ```

说明

将 {Your_API_Key} 替换为您的有效 MediaKit API Key。

maas_params 内为火山方舟视频生成接口所需的业务参数，请以火山方舟 \- 视频生成 API 为准；其中 model 请替换为您已开通的模型 ID 或推理接入点。如需图生视频，可在 content 中追加 image_url 类型元素。

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-call-maas-proxy-123456789", "request_id": "20240523100000ABCDEFG12345" } ``` #### 第 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.maas_result` 为火山方舟视频生成接口返回的原始结果，其结构以[火山方舟 - 视频生成 API](https://docs.volcengine.com/docs/82379/1520757?lang=zh) 为准。 ```JSON { "success": true, "task_id": "amk-tool-call-maas-proxy-123456789", "status": "completed", "result": { "api": "ark.video_generation", "duration": 5.0, "maas_result": { "id": "cgt-20240523100000-abcde", "model": "doubao-seedance-2-5-260628", "status": "succeeded", "content": { "video_url": "https://example.com/generated-video.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Expires=86400&X-Tos-Signature=***" }, "resolution": "720p", "ratio": "16:9", "frames_per_second": 24, "output_format": "mp4", "duration": 5, "usage": { "completion_tokens": 108900, "total_tokens": 108900 } } } } ``` ## 参考信息 ### 计费说明视频生成大模型的用量由**火山方舟**按其定价计费，请在火山方舟中查看用量与账单；AI MediaKit 不对该调用额外收费。具体价格请参考[火山方舟价格说明](https://docs.volcengine.com/docs/ark/model-pricing?lang=zh)。 ## 相关 API 文档 * [MaaS 模型代理 API](https://docs.volcengine.com/docs/6448/2700933) * [查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) * [事件回调](https://docs.volcengine.com/docs/6448/2288701)