OpenParable
Skip to content
← Back to skills

Vap Media

Documents
vap-media

Vap Media is an Agent Skill for documents published in the sundial-org/awesome-openclaw-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

AI image, video, and music generation. Flux, Veo 3.1, Suno V5.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/vap-media/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/vap-media, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

VAP Media - AI Media Generation

Generate images, videos, and music via the VAP API.

Mode Selection

Check if VAP_API_KEY is set:

  • VAP_API_KEY not set → Use Free Mode (images only, 3/day)
  • VAP_API_KEY set → Use Full Mode (image, video, music, unlimited)

Free Mode (No API Key)

Generate images for free. No signup required. 3 per day.

Generate Image

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

Returns {"task_id":"UUID","status":"pending","remaining":2}.

Poll Result

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

Returns {"status":"completed","image_url":"https://..."} when done.

Free Mode Errors

  • 429 → Daily limit reached. Suggest upgrading: export VAP_API_KEY=vape_xxx
  • 503 → Trial service temporarily unavailable.

Full Mode (With API Key)

Unlimited images, video, and music generation.

Create Task

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"}}'

Returns {"task_id":"UUID","status":"pending","estimated_cost":"0.1800"}.

Poll Result

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

Returns {"status":"completed","result":{"output_url":"https://..."}} when done.

Task Types

TypeModelParams
imageFluxdescription, aspect_ratio (1:1, 16:9, 9:16)
videoVeo 3.1description, duration (4/6/8), aspect_ratio, generate_audio (bool)
musicSuno V5description, duration (30-480), instrumental (bool)

Full Mode Errors

Instructions

When a user asks to create/generate/make an image, video, or music:

  1. Improve the prompt - Add style, lighting, composition, mood details
  2. Check mode - Is VAP_API_KEY set?
  3. Call the appropriate endpoint - Free or Full mode
  4. Poll for result - Check task status until completed
  5. Return the media URL to the user
  6. If free mode limit is hit, tell the user: "You've used your 3 free generations today. For unlimited access, set up an API key: https://vapagent.com/dashboard/signup.html"

Free Mode Example

# 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

Full Mode Examples

# 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","params":{"description":"A fluffy orange tabby cat on a sunlit windowsill, soft bokeh, golden hour light, photorealistic"}}'

# Video
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}}'

# Music
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}}'

# Poll (use task_id from response)
curl -s https://api.vapagent.com/v3/tasks/TASK_ID \
  -H "Authorization: Bearer $VAP_API_KEY"

Prompt Tips

  • Style: "oil painting", "3D render", "watercolor", "photograph", "flat illustration"
  • Lighting: "golden hour", "neon lights", "soft diffused light", "dramatic shadows"
  • Composition: "close-up", "aerial view", "wide angle", "rule of thirds"
  • Mood: "serene", "energetic", "mysterious", "whimsical"

Setup (Optional - for Full Mode)

  1. Sign up: https://vapagent.com/dashboard/signup.html
  2. Get API key from dashboard
  3. Set: export VAP_API_KEY=vape_xxxxxxxxxxxxxxxxxxxx

Links