You need to enable JavaScript to run this app.
文档中心
AI MediaKit

AI MediaKit

复制全文
下载 pdf
大模型处理工具
通过 AI MediaKit 调用视频生成大模型
复制全文
下载 pdf
通过 AI MediaKit 调用视频生成大模型
您可以通过 AI MediaKit 调用已在火山方舟开通的视频生成大模型(如 Doubao-Seedance 系列),用一段文本提示词生成视频,无需再单独对接火山方舟接口。​
本篇开发指南将引导您快速体验如何通过 AI MediaKit 调用视频生成大模型,用一段文本提示词生成视频。​
快速入门​
本节以用一句文本提示词生成一段 5 秒短视频为例,演示通过 AI MediaKit 调用视频生成大模型的完整流程。​
准备工作​
  • 开通模型:在火山方舟控制台开通所需的视频生成模型(如 Doubao-Seedance 系列),并记录可用的模型 ID 或推理接入点 ID。​
  • 进行跨服务授权:前往 AI MediaKit 控制台授权管理页面,为 AI MediaKit 授予访问您火山方舟资源的权限。​
  • 获取访问凭证:访问 AI MediaKit 控制台的 API Key 管理页面,创建并获取 MediaKit API Key。​
操作流程​
通过 AI MediaKit 调用视频生成大模型是一个异步任务,其标准流程如下:​
  1. 调用 POST /api/v1/tools/call-maas-proxy 提交任务,api 设为 ark.video_generation,即可获得一个任务 ID。​
  1. 轮询 GET /api/v1/tasks/{task_id} 接口,直到任务状态 status 变为 completed;或使用事件回调自动接收任务状态变化。​
  1. 任务完成后,从响应 result.maas_result 中读取火山方舟视频生成接口返回的原始结果(如生成视频地址)。​
第 1 步:提交视频生成任务​
调用MaaS 模型代理 API。可直接复制以下 cURL 命令,用一句提示词提交一个视频生成任务。​
​
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 用于后续查询。​
​
{​
"success": true,​
"task_id": "amk-tool-call-maas-proxy-123456789",​
"request_id": "20240523100000ABCDEFG12345"​
}​
​
第 2 步:获取生成结果​
视频生成需要一定的处理时间。您需要轮询查询任务信息 API,直到任务状态 status 变为 completed。​
​
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 为准。​
​
{​
"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 不对该调用额外收费。具体价格请参考火山方舟价格说明。​
相关 API 文档​
​
最近更新时间:2026.10.10 17:24:10
这个页面对您有帮助吗?
有用
有用
无用
无用