io.github.elestirelbilinc-sketch/vap-e

Official16 tools

by vapagentmedia · Python

AI image, video & music generation. Flux, Veo 3.1, Suno V5. Free tier included.

Generate AI images, videos, and music using Flux, Veo 3.1, and Suno V5.

Topics

aiai-agentsimage-generationmcpmodel-context-protocolmusic-generationvideo-generationcodexcoding-agentscursordeveloper-toolsmedia-apiopenai-compatibleopencodevapai-roomcoding-apivapagent

Captured live from the server via tools/list.

generate_image

Generate an AI image from text prompt using VAP (Flux2 Pro). Returns a task ID for async tracking. Cost: $0.18

Parameters (3)

promptstringrequired
Detailed description of the image to generate. Note: If aspect ratio is mentioned in the prompt (e.g., '16:9', 'widescreen', 'portrait'), also pass it in the aspect_ratio parameter for guaranteed correct dimensions.
aspect_ratiostring
Output image aspect ratio. If the user mentions a specific ratio like '16:9' or 'widescreen' in their prompt, extract and pass it here explicitly for best results.
qualitystring
Generation quality (high costs 1.5x)

get_task

Get the status and result of a generation task. Returns image URL when completed.

Parameters (1)

task_idstringrequired
Task UUID returned from generate_image

list_tasks

List recent generation tasks with optional status filter.

Parameters (2)

statusstring
Filter by task status
limitinteger
Maximum number of tasks to return

check_balance

Check VAP account balance. Returns available, reserved, and usable balances.

No parameters.

estimate_cost

Estimate the cost of an image generation before executing. Cost: $0.18

Parameters (2)

qualitystring
Generation quality level
num_outputsinteger
Number of images to generate

generate_video

Generate an AI video from text prompt using VAP (P-Video). Returns a task ID for async tracking. Cost: $1.96. IMPORTANT: Send ONLY the video description. Do NOT include any instructions, guidelines, or meta-text. Just the pure visual description.

Parameters (6)

promptstringrequired
ONLY the visual description of the video. Do NOT include instructions or guidelines. Example: 'Cinematic aerial shot of a coastal cliff at golden hour, warm sunlight, gentle waves, camera slowly drifting forward'
durationinteger
Video duration in seconds (4, 6, or 8)
aspect_ratiostring
Video aspect ratio. 16:9 for landscape/widescreen, 9:16 for portrait/vertical (TikTok, Reels). Extract from user's prompt if mentioned.
generate_audioboolean
Generate audio with the video (costs more)
resolutionstring
Video resolution. 1080p recommended for enterprise (+33% cost)
negative_promptstring
What to avoid in the video generation

estimate_video_cost

Estimate the cost of a video generation. Cost: $1.96 (P-Video)

Parameters (3)

durationinteger
Video duration in seconds
generate_audioboolean
Whether audio will be generated
resolutionstring
Video resolution. 1080p adds +33% cost

generate_music

Generate AI music from text description using VAP. Returns a task ID for async tracking. Cost: $0.68. IMPORTANT: Send ONLY the music description. Do NOT include any instructions or meta-text. Describe: genre, mood, instruments, tempo, vocal style (or specify instrumental). Example prompt: "Upbeat indie folk song with acoustic guitar, warm vocals, and light percussion. Feel-good summer vibes.

Parameters (5)

promptstringrequired
Music description (200-500 chars recommended). Include genre, mood, instruments, tempo.
instrumentalboolean
Generate without vocals (instrumental only)
durationinteger
Target duration in seconds (30-480, default 120 = 2 min)
loudness_presetstring
Loudness normalization. streaming=-14 LUFS (YouTube/Spotify), apple=-16 LUFS, broadcast=-23 LUFS (TV/EBU R128)
audio_formatstring
Output format. WAV for enterprise/lossless (+$0.10)

estimate_music_cost

Estimate the cost of music generation. Cost: $0.68

Parameters (2)

durationinteger
Music duration in seconds
audio_formatstring
Output format. WAV adds +$0.10

inpaint

Remove or replace objects in an image using AI inpainting. Cost: $0.15. Requires Tier 1+.

Parameters (3)

media_urlstringrequired
URL of the image to edit
promptstringrequired
What to remove, replace, or change in the image
mask_urlstring
Optional mask image URL (white = edit area, black = keep)

ai_edit

Edit images using AI with natural language prompts. Supports single and multi-image editing. Cost: $0.15. Requires Tier 1+.

Parameters (5)

media_urlstringrequired
URL of the primary image to edit
promptstringrequired
Natural language instruction for editing
additional_imagesarray
Up to 2 additional reference image URLs
aspect_ratiostring
Output aspect ratio (default: match input image)
seedinteger
Random seed for reproducible results

background_remove

Remove the background from an image, leaving only the subject with transparency. Cost: $0.10. Requires Tier 1+.

Parameters (1)

media_urlstringrequired
URL of the image to process

upscale

Upscale/enhance an image to higher resolution using AI. Cost: $0.15. Requires Tier 1+.

Parameters (2)

media_urlstringrequired
URL of the image to upscale
scaleinteger
Upscale factor (2x or 4x)

video_trim

Trim a video to a specific time range. Cost: $0.05. Requires Tier 1+.

Parameters (3)

media_urlstringrequired
URL of the video to trim
start_timenumberrequired
Start time in seconds
end_timenumberrequired
End time in seconds

video_merge

Merge multiple video clips into one continuous video. Cost: $0.05. Requires Tier 1+.

Parameters (1)

media_urlsarrayrequired
URLs of videos to merge (in playback order)

get_operation

Get the status and result of an operation. Returns output URL when completed.

Parameters (1)

operation_idstringrequired
Operation UUID returned from an operation tool

README.md4 KBView on GitHub

VAP AI

Agent-native AI platform for AI Room, Media API, and Coding Plan API.

Website | Developer Hub | AI Room | Dashboard | Status

Products

AI Room

Conversational creative workspace where custom-trained AI agents use session context to create images, video, voice, and music.

Product URL: https://vapagent.com/new
Plans: Lite, Pro, and Max monthly Room plans

Media API

Unified generation API for image, video, and music workflows. Current public model surfaces include Pimo AI-Video, Aura Image Turbo, and Pira V5.5.

Developer Hub: https://vapagent.com/developer/
API base URL: https://api.vapagent.com/api/v1
Create generation: POST /api/v1/generations
Authentication: product-scoped VAP Media API key
MCP endpoint: https://api.vapagent.com/mcp

Coding Plan API

OpenAI-compatible API for coding agents, IDEs, editors, and automation workflows. Powered by Nemesis Deep Coder with model ID vap-code.

Developer Hub: https://vapagent.com/developer/
Model page: https://vapagent.com/models/nemesis-deep-coder.html
Harness guide: https://vapagent.com/integrations/coding-harnesses.html
API base URL: https://api.vapagent.com/v1
Model ID: vap-code
Responses endpoint: POST /v1/responses
Chat Completions endpoint: POST /v1/chat/completions
Authentication: product-scoped VAP Coding Plan API key

Start From The Product Surface

Use these entry points for new integrations:

Need	Link
Use AI Room	https://vapagent.com/new
Generate a Media API key	https://vapagent.com/developer/?key=media#keys
Generate a Coding Plan API key	https://vapagent.com/developer/?key=code#keys
View Coding Plan API plans	https://vapagent.com/new-dashboard/?billing=code#plans
Read Developer Hub	https://vapagent.com/developer/
See Nemesis Deep Coder	https://vapagent.com/models/nemesis-deep-coder.html

Media API Via MCP

This repository remains the public GitHub and MCP discovery surface for VAP Media API integrations. MCP is still supported for Claude Desktop, Claude Code, Cursor-compatible MCP clients, and other agent workflows that call VAP media tools.

Claude Desktop example:

json

{
  "mcpServers": {
    "vap": {
      "url": "https://api.vapagent.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MEDIA_API_KEY"
      }
    }
  }
}

For clients that do not support headers directly, use the local proxy in mcp/vap_mcp_proxy.py and set VAP_API_KEY.

API Examples

Media API

bash

curl -X POST https://api.vapagent.com/api/v1/generations \
  -H "Authorization: Bearer YOUR_MEDIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"image","prompt":"a neon city at night"}'

Coding Plan API

bash

curl -X POST https://api.vapagent.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_CODING_PLAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vap-code","messages":[{"role":"user","content":"Review this patch."}]}'

Compatibility

Older /v3/execute, /v3/tasks, and MCP tool contracts remain available for existing integrations and registry clients. New builds should start from the current product contracts in Developer Hub:

Media API: https://api.vapagent.com/api/v1
Coding Plan API: https://api.vapagent.com/v1

Discovery Files

server.json: MCP Registry server metadata
mcp.json: MCP package metadata
glama.json: Glama MCP listing metadata
mcp/tools.json: MCP tool schema metadata
mcp/vap_mcp_proxy.py: local stdio/http proxy for MCP clients

License

MIT License. See LICENSE.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "vap-e": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.vapagent.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

generate_image

get_task

list_tasks

check_balance

estimate_cost

generate_video

estimate_video_cost

generate_music

estimate_music_cost

inpaint

ai_edit

background_remove

upscale

video_trim

video_merge

get_operation

VAP AI

Products

AI Room

Media API

Coding Plan API

Start From The Product Surface

Media API Via MCP

API Examples

Media API

Coding Plan API

Compatibility

Discovery Files

Links

License

Install