VAP Media API 技能

通过 VAP Media API 生成图像、视频和音乐。使用涂绘（inpaint）、AI 编辑（AI edit）、超分辨率增强（upscale）、背景移除、视频裁剪和视频合并等功能对媒体内容进行编辑与增强。

该技能是面向 ClawHub 等智能体生态系统的 VAP Media API 分发入口。请保持智能体工作流简洁高效：优化提示词（prompt），选择匹配的 VAP Media API 接口端点，轮询任务或操作状态，并返回最终媒体资源 URL。

产品边界

本技能仅用于 VAP Media API 相关任务：

• 图像生成
• 视频生成
• 音乐生成
• 媒体编辑与增强

请勿将编码模型（coding-model）相关请求路由至此技能。编码智能体（coding agents）及 IDE 模型工作流应使用独立的 VAP Coding Plan API，对应模型 ID 为 vap-code。

访问方式

使用 VAP_API_KEY 作为 Bearer Token。该密钥作用域限定于 VAP Media API 访问权限。

若未设置 VAP_API_KEY，请提示用户前往开发者中心（Developer Hub）获取 Media API 密钥： https://vapagent.com/developer/?key=media#keys

查看 Room 与 Media 套餐详情： https://vapagent.com/new-dashboard/?billing=monthly#plans

生成类操作（Generation）

使用 POST /api/v1/generations 接口执行图像、视频和音乐的生成任务。

创建生成任务

curl -s -X POST https://api.vapagent.com/api/v1/generations 
  -H "Authorization: Bearer $VAP_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"kind":"image","prompt":"PROMPT","params":{"aspect_ratio":"1:1"}}'

响应返回任务 ID：

{"generation_id":"UUID","task_id":"UUID","status":"pending","kind":"image"}

轮询生成任务状态

curl -s https://api.vapagent.com/api/v1/generations/GENERATION_ID 
  -H "Authorization: Bearer $VAP_API_KEY"

任务完成后，从响应字段 result_url、image_url、video_url、audio_url 或嵌套在 result 中的主 URL 获取最终媒体资源地址。

生成类型与参数说明

图像（Image）

{
  "kind": "image",
  "prompt": "一张干净的产品照片：紫白色 AI 媒体徽标置于影棚工作台面",
  "params": {
    "aspect_ratio": "1:1"
  }
}

视频（Video）

{
  "kind": "video",
  "prompt": "日出时分，无人机航拍云雾缭绕的群山",
  "params": {
    "duration": 8,
    "aspect_ratio": "9:16",
    "resolution": "1080p"
  }
}

音乐（Music）

{
  "kind": "music",
  "prompt": "轻快的 Lo-Fi 嘻哈节拍，温暖黑胶底噪，轻松氛围",
  "params": {
    "duration": 120,
    "instrumental": true,
    "audio_format": "mp3"
  }
}

操作类任务（Operations）

使用 POST /api/v1/operations 接口执行媒体编辑与增强类操作。

创建操作任务

curl -s -X POST https://api.vapagent.com/api/v1/operations 
  -H "Authorization: Bearer $VAP_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"operation":"background_remove","media_url":"https://example.com/photo.png"}'

轮询操作任务状态

curl -s https://api.vapagent.com/api/v1/operations/OPERATION_ID 
  -H "Authorization: Bearer $VAP_API_KEY"

任务完成后，从响应字段 result_url、image_url、video_url 或嵌套在 result 中的主 URL 获取处理后的媒体资源地址。

可用操作列表

智能体行为指南

当用户请求创建、生成或制作图像、视频或音乐时：

1. 丰富提示词，补充风格、光照、构图、情绪或制作细节等有效信息。
2. 检查并确保已提供 VAP_API_KEY；若缺失，请引导用户至开发者中心（Developer Hub）申请 Media API 密钥。
3. 调用 POST /api/v1/generations，携带顶层字段 kind 和 prompt，以及可选的 params 对象。
4. 根据内容用途设定合适的宽高比：
   • 竖屏/社交平台适配 → 9:16
   • YouTube/网页/宽屏场景 → 16:9
   • 方形信息流素材 → 1:1
5. 持续轮询 GET /api/v1/generations/{id}，直至状态为完成（completed）或失败（failed）。
6. 以简洁明了的方式向用户返回最终媒体资源 URL 及简要状态说明。

当用户请求编辑、增强或修改已有图像或视频时：

1. 识别适用的操作类型：inpaint、ai_edit、upscale、background_remove、video_trim 或 video_merge。
2. 从此前生成结果或用户提供的 URL 中获取原始媒体资源地址。
3. 提交 POST /api/v1/operations 请求。
4. 持续轮询 GET /api/v1/operations/{id}，直至任务完成或失败。
5. 返回处理后的输出资源 URL。

请勿向用户暴露底层服务提供商的内部实现细节；对外统一标识为 VAP Media API 产品。

示例

图像生成

curl -s -X POST https://api.vapagent.com/api/v1/generations 
  -H "Authorization: Bearer $VAP_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"kind":"image","prompt":"一只毛茸茸的橘色虎斑猫趴在阳光洒落的窗台上，柔焦背景，黄金时刻光线，写实风格","params":{"aspect_ratio":"16:9"}}'

curl -s https://api.vapagent.com/api/v1/generations/GENERATION_ID 
  -H "Authorization: Bearer $VAP_API_KEY"

视频生成

curl -s -X POST https://api.vapagent.com/api/v1/generations 
  -H "Authorization: Bearer $VAP_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"kind":"video","prompt":"日出时分，无人机航拍云雾缭绕的群山","params":{"duration":8,"aspect_ratio":"9:16","resolution":"1080p"}}'

音乐生成

curl -s -X POST https://api.vapagent.com/api/v1/generations 
  -H "Authorization: Bearer $VAP_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"kind":"music","prompt":"轻快的 Lo-Fi 嘻哈节拍，温暖黑胶底噪，轻松氛围","params":{"duration":120,"instrumental":true,"audio_format":"wav","loudness_preset":"streaming"}}'

AI 编辑

curl -s -X POST https://api.vapagent.com/api/v1/operations 
  -H "Authorization: Bearer $VAP_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"operation":"ai_edit","media_url":"https://example.com/photo.jpg","prompt":"将背景更换为日落海滩场景"}'

超分辨率增强

curl -s -X POST https://api.vapagent.com/api/v1/operations 
  -H "Authorization: Bearer $VAP_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"operation":"upscale","media_url":"https://example.com/photo.jpg","options":{"scale":4}}'

背景移除

curl -s -X POST https://api.vapagent.com/api/v1/operations 
  -H "Authorization: Bearer $VAP_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"operation":"background_remove","media_url":"https://example.com/photo.jpg"}'

提示词优化建议

• 风格：如“油画”、“3D 渲染”、“水彩”、“摄影”、“扁平插画”
• 光照：“黄金时刻”、“霓虹灯光”、“柔和漫射光”、“戏剧性阴影”
• 构图：“特写”、“鸟瞰视角”、“广角镜头”、“三分法构图”
• 情绪：“宁静”、“活力充沛”、“神秘感”、“高端质感”、“轻松诙谐”
• 宽高比：在必要时注明“宽屏”、“竖屏”或具体比例（如“16:9”）

环境配置

1. 获取 Media API 密钥：https://vapagent.com/developer/?key=media#keys
2. 如需开通访问权限，请查看 Room 与 Media 套餐：https://vapagent.com/new-dashboard/?billing=monthly#plans
3. 设置环境变量：export VAP_API_KEY=vap_xxxxxxxxxxxxxxxxxxxx

相关链接

• 开发者中心（Developer Hub）：https://vapagent.com/developer/
• Media API 密钥申请页：https://vapagent.com/developer/?key=media#keys
• Room 与 Media 套餐页：https://vapagent.com/new-dashboard/?billing=monthly#plans
• VAP AI 官网：https://vapagent.com/
• GitHub 仓库：https://github.com/vapagentmedia/vap-media-skill