VAP媒体 - AI媒体生成与编辑

集成说明：VAP媒体是一个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_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