Vimmerse Images-to-Video

by agents.vimmerse.net·Website ↗API ↗

Vimmerse Images-to-Video is a paid API for AI agents from agents.vimmerse.net, paid per call via MPP, $1.5/call (dynamic — varies by input), status unknown (last checked 2026-10-31).

Generates an animated story video with narration and background music from a text idea and a list of image URLs.

How this service works

Generates a story video from an **idea** and a list of **image URLs**. Send **Content-Type: application/json**. Pipeline: narrations/music → animate each image → compose final video. Poll **GET /v2/story/{story_id}** until `status` is `success`. ### Example: Images-to-Video (Python) ```python import requests BASE_URL = "https://api.vimmerse.net" API_KEY = "YOUR_API_KEY" url = f"{BASE_URL}/v2/story/images-2-video" headers = {"X-Api-Key": API_KEY, "Content-Type": "application/json"} payload = { "idea": "Cinematic product-only smoothie promo: fresh berries, bananas, oranges on a wooden table, blender mixing, smoothie pouring into glass, 16:9, photorealistic.", "image_urls": [ "https://example.com/image1.jpg", "https://example.com/image2.jpg", "https://example.com/image3.jpg", ], "title": "Smoothie Promo", "aspect_ratio": "16:9", "video_tool": "Auto", "is_transition": True, "scene_duration": 5, "audio_option": {"has_bg_music": True, "has_narration": True, "native_audio": False}, "language": "English", } response = requests.post(url, headers=headers, json=payload, timeout=60) response.raise_for_status() result = response.json() print(f"Story ID: {result['id']}, Scenes: {len(payload['image_urls'])}") ``` ## audio_option Audio configuration for story generation (JSON object). Used in idea-2-video, url-2-video, images-2-video, and advanced Step 1 (Create Storyboard). ## Audio parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `narrator` | string | AutoV | Voice for narration. **Available voices**: AutoV, Rachel, Aria, Roger, Sarah, Laura, Charlie, George, Callum, River, Liam, Charlotte, Alice, Matilda, Will, Jessica, Eric, Chris, Brian, Daniel, Lily, Bill | | `has_narration` | boolean | true | Include narration. Ignored when `native_audio` is true | | `has_bg_music` | boolean | true | Include background music | | `native_audio` | boolean | false | Include native sound effects and lip sync. When true, narration is disabled | ## Usage examples (application/json) **Background music only:** ```json { "has_bg_music": true, "has_narration": false, "native_audio": false } ``` **Narration with background music:** ```json { "has_bg_music": true, "has_narration": true, "native_audio": false, "narrator": "Rachel" } ``` **Native audio (sound effects + lip sync):** ```json { "has_bg_music": true, "has_narration": false, "native_audio": true } ``` **No audio:** ```json { "has_bg_music": false, "has_narration": false, "native_audio": false } ``` ## Notes - When `native_audio` is true, `has_narration` is ignored (effectively false). - `narrator` is only used when `has_narration` is true and `native_audio` is false. - Send `audio_option` as a JSON object in the request body (Content-Type: application/json).

Output

Returns a story object containing a story ID, status field, and eventually (after polling GET /v2/story/{story_id}) a video_url pointing to the fully composed video, plus an all_medias array with per-scene animated clip URLs, prompts, and metadata such as resolution and video tool used.