name: vap-media
description: 通过 VAP API 实现 AI 图像、视频和音乐的生成与编辑。支持 Flux、Veo 3.1、Suno V5。
metadata: {"openclaw":{"emoji":"🎬","requires":{"bins":["curl"]}},"source":"https://github.com/vapagentmedia/vap-showcase","homepage":"https://vapagent.com"}

VAP Media - AI 媒体生成与编辑

集成说明： VAP Media 是一个 API 聚合器，提供对多个 AI 供应商的统一访问：
- 图像： 通过 Black Forest Labs Flux.2 Pro 生成
- 视频： 通过 Google Veo 3.1 生成
- 音乐： 通过 Suno V5 生成

所有生成请求都通过 VAP 的 API (api.vapagent.com) 处理，并由其路由到相应的后端供应商。

生成图像、视频和音乐。支持修复、AI 编辑、超分、背景移除、视频剪辑/合并等编辑功能。

模式选择

检查 VAP_API_KEY 是否已设置：

• 未设置 VAP_API_KEY → 使用免费模式（仅限图像，每天 3 次）
• 已设置 VAP_API_KEY → 使用完整模式（所有功能，无限制）

免费模式（无需 API 密钥）

免费生成图像，无需注册。每天 3 次。

生成图像

curl -s -X POST https://api.vapagent.com/v3/trial/generate \
  -H "Content-Type: application/json" \
  -d '{"prompt":"提示词"}'

返回 {"task_id":"UUID","status":"pending","remaining":2}。

轮询结果

curl -s https://api.vapagent.com/v3/trial/status/任务ID

完成后返回 {"status":"completed","image_url":"https://..."}。

免费模式错误

• 429 → 达到每日限制。建议升级：export VAP_API_KEY=vap_xxx
• 503 → 试用服务暂时不可用。

完整模式（使用 API 密钥）

无限制的图像、视频、音乐生成和编辑操作。

创建任务

curl -s -X POST https://api.vapagent.com/v3/tasks \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"类型","params":{"description":"提示词"}}'

返回 {"task_id":"UUID","status":"pending"}。

轮询结果

curl -s https://api.vapagent.com/v3/tasks/任务ID \
  -H "Authorization: Bearer $VAP_API_KEY"

完成后返回 {"status":"completed","result":{"output_url":"https://..."}}。

任务类型与参数

图像 (image 或 image_generation)

提示： 系统会根据提示词文本自动检测宽高比。例如，“a wide landscape photo” 会自动设置为 16:9。

视频 (video 或 video_generation) — 需 Tier 2+ 套餐

音乐 (music 或 music_generation) — 需 Tier 2+ 套餐

完整模式错误

• 401 → API 密钥无效。
• 402 → 余额不足。请前往 https://vapagent.com/dashboard/signup.html 充值。
• 403 → 当前套餐等级过低，无法执行此任务类型。

操作（编辑与增强）

后期编辑操作。需要 Tier 1+ 套餐。

创建操作

curl -s -X POST https://api.vapagent.com/v3/operations \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation":"操作类型","media_url":"媒体URL","prompt":"指令"}'

轮询操作

curl -s https://api.vapagent.com/v3/operations/操作ID \
  -H "Authorization: Bearer $VAP_API_KEY"

可用操作

使用指南

当用户要求创建/生成图像、视频或音乐时：

1. 优化提示词 — 添加风格、光照、构图、情绪等细节。
2. 检查模式 — VAP_API_KEY 是否已设置？
3. 选择端点：
   • 单个资产 → /v3/tasks（免费模式用 /v3/trial/generate）
   • 编辑/增强 → /v3/operations
   • 营销活动（视频+音乐+缩略图）→ 使用预设调用 /v3/execute
4. 设置宽高比 — 匹配内容需求（社交媒体用竖屏，YouTube 用宽屏）。
5. 轮询结果 — 检查任务/操作状态直至完成。
6. 将媒体 URL 返回给用户。
7. 如果免费模式次数用完，告知用户：“您今日的 3 次免费生成已用完。如需无限制访问，请设置 API 密钥：https://vapagent.com/dashboard/signup.html”。

当用户要求编辑/增强/修改现有图像或视频时：

1. 确定操作类型 — 修复、AI 编辑、超分、背景移除、剪辑、合并。
2. 获取媒体 URL — 来自之前的生成结果或用户提供的 URL。
3. 提交操作 → /v3/operations
4. 轮询结果 — 返回输出 URL。

免费模式示例

# 创建（无需认证）
curl -s -X POST https://api.vapagent.com/v3/trial/generate \
  -H "Content-Type: application/json" \
  -d '{"prompt":"一只毛茸茸的橘色虎斑猫在洒满阳光的窗台上，柔和的焦外虚化，黄金时刻的光线，照片级真实感"}'

# 轮询
curl -s https://api.vapagent.com/v3/trial/status/任务ID

完整模式示例

# 图像（宽屏）
curl -s -X POST https://api.vapagent.com/v3/tasks \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","params":{"description":"一只毛茸茸的橘色虎斑猫在洒满阳光的窗台上，柔和的焦外虚化，黄金时刻的光线，照片级真实感","aspect_ratio":"16:9"}}'

# 视频（竖屏，用于社交媒体）
curl -s -X POST https://api.vapagent.com/v3/tasks \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","params":{"description":"日出时分无人机航拍雾霭笼罩的山脉","duration":8,"aspect_ratio":"9:16","resolution":"1080p"}}'

# 音乐（纯音乐 WAV）
curl -s -X POST https://api.vapagent.com/v3/tasks \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"music","params":{"description":"欢快的低保真嘻哈节拍，温暖的乙烯基噼啪声，放松的氛围","duration":120,"instrumental":true,"audio_format":"wav","loudness_preset":"streaming"}}'

# 修复（编辑图像）
curl -s -X POST https://api.vapagent.com/v3/operations \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation":"inpaint","media_url":"https://example.com/photo.jpg","prompt":"移除背景中的人物"}'

# 超分（4倍）
curl -s -X POST https://api.vapagent.com/v3/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/v3/operations \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation":"background_remove","media_url":"https://example.com/photo.jpg"}'

# 轮询（使用响应中的 task_id 或 operation_id）
curl -s https://api.vapagent.com/v3/tasks/任务ID \
  -H "Authorization: Bearer $VAP_API_KEY"

生产预设（多资产）

对于内容营销活动，使用 /v3/execute 从一个提示词生成多个资产：

curl -s -X POST https://api.vapagent.com/v3/execute \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"preset":"streaming_campaign","prompt":"提示词"}'

完成后返回所有资产：

{"status":"completed","outputs":{"video":"https://...","music":"https://...","thumbnail":"https://..."}}

提示词技巧

• 风格： “油画”、“3D 渲染”、“水彩画”、“照片”、“扁平插画”
• 光照： “黄金时刻”、“霓虹灯光”、“柔和漫射光”、“戏剧性阴影”
• 构图： “特写”、“鸟瞰图”、“广角”、“三分法”
• 情绪： “宁静的”、“充满活力的”、“神秘的”、“异想天开的”
• 在提示词中指定宽高比： 在提示词中提到“宽屏”、“竖屏”或“16:9”会自动设置宽高比。

设置（可选 — 用于完整模式）

1. 注册：https://vapagent.com/dashboard/signup.html
2. 从仪表板获取 API 密钥
3. 设置：export VAP_API_KEY=vap_xxxxxxxxxxxxxxxxxxxx

链接

• 免费试用
• API 文档
• GitHub