VAP Media - AI媒体生成与编辑

集成说明：VAP Media 是一个API聚合器，提供对多个AI供应商的统一访问：

• 图像：通过 Black Forest Labs Flux.2 Pro 生成
• 视频：通过 Google Veo 3.1 生成
• 音乐：通过 Suno V5 生成

所有生成请求都通过VAP的API（api.vapagent.com）进行，该API会将请求路由到相应的后端供应商。

生成图像、视频和音乐。使用修复、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":"PROMPT"}'

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

轮询结果

curl -s https://api.vapagent.com/v3/trial/status/TASK_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":"TYPE","params":{"description":"PROMPT"}}'

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

轮询结果

curl -s https://api.vapagent.com/v3/tasks/TASK_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) — 第2级及以上

音乐 (音乐或音乐生成) — 第 2+ 级

完整模式错误

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

操作（编辑与增强）

后期编辑操作。需要等级1及以上。

创建操作

curl -s -X POST https://api.vapagent.com/v3/operations \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation":"OPERATION","media_url":"URL","prompt":"INSTRUCTION"}'

轮询操作

curl -s https://api.vapagent.com/v3/operations/OPERATION_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

免费模式示例

# Create (no auth needed)
curl -s -X POST https://api.vapagent.com/v3/trial/generate \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A fluffy orange tabby cat on a sunlit windowsill, soft bokeh, golden hour light, photorealistic"}'

# Poll
curl -s https://api.vapagent.com/v3/trial/status/TASK_ID

完整模式示例

# Image (widescreen)
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":"A fluffy orange tabby cat on a sunlit windowsill, soft bokeh, golden hour light, photorealistic","aspect_ratio":"16:9"}}'

# Video (portrait, for social media)
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":"Drone shot over misty mountains at sunrise","duration":8,"aspect_ratio":"9:16","resolution":"1080p"}}'

# Music (instrumental 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":"Upbeat lo-fi hip hop beat, warm vinyl crackle, chill vibes","duration":120,"instrumental":true,"audio_format":"wav","loudness_preset":"streaming"}}'

# Inpaint (edit an image)
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":"Remove the person in the background"}'

# Upscale (4x)
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}}'

# Background Remove
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"}'

# Poll (use task_id or operation_id from response)
curl -s https://api.vapagent.com/v3/tasks/TASK_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":"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