Files

3.6 KiB

name, description, homepage, metadata
name description homepage metadata
vap-media AI image, video, and music generation. Flux, Veo 3.1, Suno V5. https://vapagent.com
bot
emoji requires primaryEnv
🎬
bins env
curl
VAP_API_KEY
VAP_API_KEY

VAP Media Generation

Generate AI images, videos, and music directly via the VAP API. No local dependencies beyond curl.

Available Models

Type Model Use Case
Image Flux Social posts, product mockups
Video Veo 3.1 Clips, promos, content
Music Suno V5 Background tracks, jingles

Quick Usage

Generate an Image

curl -s -X POST https://api.vapagent.com/v3/tasks \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "image_generation",
    "params": {
      "description": "A serene mountain landscape at golden hour",
      "aspect_ratio": "16:9"
    }
  }' | jq -r '.task_id'

Check Status & Get Result

curl -s https://api.vapagent.com/v3/tasks/{task_id} \
  -H "Authorization: Bearer $VAP_API_KEY" | jq '.status, .result.url'

Generate Video (Tier 2+ required)

curl -s -X POST https://api.vapagent.com/v3/tasks \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "video_generation",
    "params": {
      "prompt": "Cinematic aerial shot of coastal cliffs",
      "duration": 8,
      "aspect_ratio": "16:9"
    }
  }'

Generate Music (Tier 2+ required)

curl -s -X POST https://api.vapagent.com/v3/tasks \
  -H "Authorization: Bearer $VAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "music_generation",
    "params": {
      "prompt": "Upbeat indie folk with acoustic guitar",
      "duration": 120,
      "instrumental": false
    }
  }'

Setup

  1. Get API Key: https://vapagent.com/dashboard/signup.html
  2. Add to environment:
    export VAP_API_KEY=vape_xxxxxxxxxxxxxxxxxxxx
    
  3. Or configure in bot.json:
    {
      "skills": {
        "entries": {
          "vap-media": {
            "apiKey": "vape_xxxxxxxxxxxxxxxxxxxx"
          }
        }
      }
    }
    

Tier System

Tier Requirement Capabilities
Tier 1 $1+ deposit Image only
Tier 2 $100+ deposit, 50+ tasks Image + Video + Music

Cost Control

VAP uses reserve-burn-refund billing:

  • Reserve: Cost is held before execution
  • Burn: Only charged on success
  • Refund: Failed tasks are automatically refunded

No surprise charges. You know exact cost before execution.

Response Format

{
  "task_id": "tsk_abc123",
  "status": "completed",
  "result": {
    "url": "https://pub-xxx.r2.dev/output.png",
    "metadata": {}
  }
}

Example Workflows

Daily Social Post

"Generate an inspirational quote image with abstract background" → Post to social media

Product Mockup

"Product photo of a minimalist coffee mug on marble surface" → Use for e-commerce

Content Background Music

"Calm lo-fi beats for focus and productivity" → Add to video content

Support