VAP Media - AI Media Generation & Editing

Integration Note: VAP Media is an API aggregator that provides unified access to multiple AI providers:

Images: Generated via Black Forest Labs Flux.2 Pro

Videos: Generated via Google Veo 3.1

Music: Generated via Suno V5

All generation requests go through VAP's API (
api.vapagent.com
), which routes to the appropriate backend provider.

Generate images, videos, and music. Edit with inpaint, ai_edit, upscale, background removal, video trim/merge.

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 (all features, 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=vap_xxx
```
```
503
```
→ Trial service temporarily unavailable.

Full Mode (With API Key)

Unlimited images, video, music, and editing operations.

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

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 & Parameters

Image (

image

image_generation

)

Param Type Default Description

description

string

required

Image description

aspect_ratio

enum

1:1

1:1

16:9

9:16

4:3

3:4

3:2

2:3

21:9

9:21

quality

enum

standard

standard

high

Tip: Aspect ratio is auto-detected from prompt text. "a wide landscape photo" → 16:9 automatically.

Video (

video

video_generation

) — Tier 2+

Param	Type	Default	Description
`description`	string	required	Video description
`duration`	int	`8`	`4` , `6` , or `8` seconds
`aspect_ratio`	enum	`16:9`	`16:9` (landscape) or `9:16` (portrait)
`generate_audio`	bool	`true`	Include audio track
`resolution`	enum	`720p`	`720p` or `1080p`
`negative_prompt`	string	`""`	What to avoid

Music (

music

music_generation

) — Tier 2+

Param	Type	Default	Description
`description`	string	required	Music description (genre, mood, instruments)
`duration`	int	`120`	30-480 seconds
`instrumental`	bool	`false`	No vocals
`audio_format`	enum	`mp3`	`mp3` or `wav` (lossless)
`loudness_preset`	enum	`streaming`	`streaming` (-14 LUFS), `apple` (-16 LUFS), `broadcast` (-23 LUFS)
`style`	string	none	Genre/style (max 1000 chars)
`title`	string	none	Song title
`custom_mode`	bool	`false`	Enable custom lyrics + style mode

Full Mode Errors

```
401
```
→ Invalid API key.
```
402
```
→ Insufficient balance. Top up at https://vapagent.com/dashboard/signup.html
```
403
```
→ Tier too low for this task type.

Operations (Edit & Enhance)

Post-production editing operations. Tier 1+ required.

Create Operation

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

Poll Operation

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

Available Operations

Operation	Required Params	Description
`inpaint`	`media_url` , `prompt`	AI editing (optional: `mask_url` )
`ai_edit`	`media_url` , `prompt`	AI-powered image editing with text instructions (optional: `additional_images` )
`background_remove`	`media_url`	Remove background
`upscale`	`media_url`	Enhance resolution ( `scale` : 2 or 4)
`video_trim`	`media_url` , `start_time` , `end_time`	Trim video
`video_merge`	`media_urls` (array, min 2)	Merge video clips

Instructions

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

Improve the prompt — Add style, lighting, composition, mood details
Check mode — Is
```
VAP_API_KEY
```
set?
Choose endpoint:
- Single asset →
```
/v3/tasks
```
  (or
```
/v3/trial/generate
```
  for free)
- Edit/enhance →
```
/v3/operations
```
- Campaign (video+music+thumbnail) →
```
/v3/execute
```
  with preset
Set aspect ratio — Match the content need (portrait for social, widescreen for YouTube)
Poll for result — Check task/operation status until completed
Return the media URL to the user
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"

When a user asks to edit/enhance/modify an existing image or video:

Identify the operation — inpaint, ai_edit, upscale, background remove, trim, merge
Get the media URL — From a previous generation or user-provided URL
Submit operation →
```
/v3/operations
```
Poll for result — Return the output URL

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 (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&quot;,&quot;prompt&quot;:&quot;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&quot;,&quot;options&quot;:{&quot;scale&quot;:4}}&#x27;
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&quot;}&#x27;
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"

Production Presets (Multi-Asset)

For content campaigns, use

/v3/execute

to generate multiple assets from one prompt:

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

Returns all assets when complete:

{"status":"completed","outputs":{"video":"https://...","music":"https://...","thumbnail":"https://..."}}

Preset	Includes
`streaming_campaign`	video + music + thumbnail + metadata
`full_production`	video + music + thumbnail + metadata + SEO
`video.basic`	video only
`music.basic`	music only
`image.basic`	image only

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"
Aspect ratio in prompt: Mentioning "widescreen", "portrait", or "16:9" in your prompt auto-sets the aspect ratio.

Setup (Optional — for Full Mode)

Sign up: https://vapagent.com/dashboard/signup.html
Get API key from dashboard

Set:

export VAP_API_KEY=vap_xxxxxxxxxxxxxxxxxxxx

AI media generation API - Flux2pro, Veo3.1, Suno Ai

AI Skill Market Insights

Be Part of the 0+ Developer Community

VAP Media - AI Media Generation & Editing

Mode Selection

Free Mode (No API Key)

Generate Image

Poll Result

Free Mode Errors

Full Mode (With API Key)

Create Task

Poll Result

Task Types & Parameters

Image (image or image_generation)

Video (video or video_generation) — Tier 2+

Music (music or music_generation) — Tier 2+

Full Mode Errors

Operations (Edit & Enhance)

Create Operation

Poll Operation

Available Operations

Instructions

Free Mode Example

Poll

Full Mode Examples

Video (portrait, for social media)

Music (instrumental WAV)

Inpaint (edit an image)

Upscale (4x)

Background Remove

Poll (use task_id or operation_id from response)

Production Presets (Multi-Asset)

Prompt Tips

Setup (Optional — for Full Mode)

Links

Quick Start

Manual Installation

TEAR & SHARE

Tags

Channels

Learn

Compare

Company

Image (
`image`
or
`image_generation`
)

Video (
`video`
or
`video_generation`
) — Tier 2+

Music (
`music`
or
`music_generation`
) — Tier 2+