{"uid":"cap_H8ET776HciNcXQTfqAeNb","slug":"agents-vimmerse-net-vimmerse-idea-to-video-934a0a00","name":"Vimmerse Idea-to-Video","description":"Creates a complete video from a text idea in one call. Send **Content-Type: application/json**.\n\nThe pipeline runs automatically: storyboard → elements → scenes → narrations/music → video animation → composition. Poll **GET /v2/story/{story_id}** until `status` is `success`, then use `video_url`.\n\n### Example: Idea-to-Video (Python)\n\n```python\nimport requests\n\nBASE_URL = \"https://api.vimmerse.net\"\nAPI_KEY = \"YOUR_API_KEY\"\n\nurl = f\"{BASE_URL}/v2/story/idea-2-video\"\nheaders = {\"X-Api-Key\": API_KEY, \"Content-Type\": \"application/json\"}\n\npayload = {\n    \"idea\": \"Create a promotional video where cute animals play musical instruments in a sunny meadow\",\n    \"title\": \"Musical Animals Story\",\n    \"aspect_ratio\": \"9:16\",\n    \"scene_count\": 4,\n    \"image_tool\": \"Seedream\",\n    \"video_tool\": \"Auto\",\n    \"scene_duration\": 5,\n    \"audio_option\": {\n        \"has_bg_music\": True,\n        \"has_narration\": True,\n        \"native_audio\": False,\n        \"narrator\": \"AutoV\",\n    },\n    \"language\": \"English\",\n    \"webhook_url\": \"https://your-domain.com/webhook/callback\",\n}\n\nresponse = requests.post(url, headers=headers, json=payload, timeout=60)\nresponse.raise_for_status()\nresult = response.json()\nstory_id = result[\"id\"]\nprint(f\"Story ID: {story_id}, Status: {result['status']}\")\n```\n\n## elements\n\nOptional JSON object of **pre-defined story elements** you already have in mind for this automatic flow. The API uses these to guide the internal storyboard generation (e.g. character names, environments, and props). Only **characters**, **environments**, and **objects** are accepted; **scenes** must not be included (scenes are generated from the idea and timing).\n\n`elements` is a **JSON object**, not a string and not a list of `{type, url, position}` (that shape is `media_items` on the media API).\n\nEach key is a list of objects. To pass an existing picture, set `image_url` to a public https URL. Leave `image_url` as `\"\"` when the picture should be generated later.\n\n| Key | Type | Description |\n|-----|------|-------------|\n| `characters` | array of objects | Optional. Each item has `name`, `description`, and `image_url`. |\n| `environments` | array of objects | Optional. Each item has `name`, `description`, and `image_url`. |\n| `objects` | array of objects | Optional. Each item has `name`, `description`, and `image_url`. |\n\n**Example (partial):**\n\n```json\n{\n  \"idea\": \"Create a promotional video where cute animals play musical instruments in a sunny meadow\",\n  \"scene_count\": 4,\n  \"elements\": {\n    \"characters\": [\n      {\n        \"name\": \"Whiskers the Squirrel\",\n        \"description\": \"Style:Pixar-style 3D, a small, nimble squirrel with rusty-red fur and a bushy tail.\",\n        \"image_url\": \"https://example.com/whiskers.png\"\n      },\n      {\n        \"name\": \"Pip the Rabbit\",\n        \"description\": \"Style:Pixar-style 3D, a plump, creamy white rabbit with long floppy ears.\",\n        \"image_url\": \"\"\n      }\n    ],\n    \"environments\": [\n      {\n        \"name\": \"Sunny Meadow\",\n        \"description\": \"Style:Pixar-style 3D, a vibrant meadow in golden afternoon light with wildflowers.\",\n        \"image_url\": \"\"\n      }\n    ],\n    \"objects\": [\n      {\n        \"name\": \"Acorn Flute\",\n        \"description\": \"Style:Pixar-style 3D, a small polished acorn hollowed as a flute with three finger holes.\",\n        \"image_url\": \"\"\n      },\n      {\n        \"name\": \"Carrot Drum\",\n        \"description\": \"Style:Pixar-style 3D, a miniature hollow carrot with a leaf membrane as drumhead.\",\n        \"image_url\": \"\"\n      }\n    ]\n  }\n}\n```\n\n## audio_option\n\n\nAudio configuration for story generation (JSON object). Used in idea-2-video, url-2-video, images-2-video, and advanced Step 1 (Create Storyboard).\n\n## Audio parameters\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `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 |\n| `has_narration` | boolean | true | Include narration. Ignored when `native_audio` is true |\n| `has_bg_music` | boolean | true | Include background music |\n| `native_audio` | boolean | false | Include native sound effects and lip sync. When true, narration is disabled |\n\n## Usage examples (application/json)\n\n**Background music only:**\n```json\n{\n  \"has_bg_music\": true,\n  \"has_narration\": false,\n  \"native_audio\": false\n}\n```\n\n**Narration with background music:**\n```json\n{\n  \"has_bg_music\": true,\n  \"has_narration\": true,\n  \"native_audio\": false,\n  \"narrator\": \"Rachel\"\n}\n```\n\n**Native audio (sound effects + lip sync):**\n```json\n{\n  \"has_bg_music\": true,\n  \"has_narration\": false,\n  \"native_audio\": true\n}\n```\n\n**No audio:**\n```json\n{\n  \"has_bg_music\": false,\n  \"has_narration\": false,\n  \"native_audio\": false\n}\n```\n\n## Notes\n\n- When `native_audio` is true, `has_narration` is ignored (effectively false).\n- `narrator` is only used when `has_narration` is true and `native_audio` is false.\n- Send `audio_option` as a JSON object in the request body (Content-Type: application/json).","url":"https://agents.vimmerse.net/v2/story/idea-2-video?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"Idea2VideoRequest","required":["idea"],"properties":{"idea":{"type":"string","title":"Idea","examples":["Create a realistic winter commercial for SkinRevive Moisturiser set in snowy mountains. Three girls are on a winter camping trip. Show two girls outside the camp, dressed in warm jackets, taking fun photos together in the snowy mountains. Soft snowfall, visible cold breath, playful interaction. Meanwhile, one girl is sitting inside the tent, wrapped in a blanket, looking hesitant and afraid to step outside because of the cold and her dry, irritated hands. She peeks out while the others call her to join, but she hesitates. Then one girl comes inside the tent, sits with her, smiles, and shows SkinRevive Moisturiser. She gently applies it on her friend’s dry hands. Show close-up macro shots: smooth creamy texture, instant hydration, natural skin transformation. The inside girl now feels confident. She steps outside slowly, smiles, and joins her friends. Show them laughing, posing, and taking photos of each other against the beautiful snowy mountain background. Natural warm emotions, winter glow, soft daylight. End with a clean hero shot of SkinRevive Moisturiser placed on a wooden camping table with snowflakes falling softly around it. Cinematic, high-detail, warm winter storytelling mood."],"description":"Detailed text description of your story concept."},"style":{"enum":["AutoS","Cinematic Narrative","Neo-Nostalgia / Film Grain","Photorealistic","Authentic Minimal","Claymation","3D Pixar","Cartoon Comic","2D Anime","Oil Painting","Cyberpunk Futueristic Aesthetic"],"type":"string","title":"Story Style","default":"AutoS","examples":["AutoS","Cinematic Narrative","3D Pixar","Photorealistic"],"description":"Visual storytelling style. 'AutoS' lets AI choose automatically. Other options enforce a specific style direction."},"title":{"type":"string","title":"Story Title","default":"","examples":["My Story Video"]},"elements":{"anyOf":[{"type":"object","title":"StoryElementsInput","examples":[{"objects":[{"name":"Logo","image_url":"https://example.com/logo.png","description":"Brand logo, flat, on a transparent background."}],"characters":[{"name":"Whiskers","image_url":"https://example.com/whiskers.png","description":"A small rusty-red squirrel with a bushy tail, Pixar-style 3D."}],"environments":[{"name":"Sunny Meadow","image_url":"","description":"A golden meadow with wildflowers and a clear blue sky."}]}],"properties":{"objects":{"anyOf":[{"type":"array","items":{"type":"object","title":"StoryElementInput","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","examples":["Whiskers"],"description":"Short distinct name. Scene text refers to this name, so keep the spelling identical everywhere."},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image URL","examples":["https://example.com/whiskers.png"],"description":"Public https URL of an existing picture of this character, place, or object. This is how you pass a product photo or logo. Omit it, or send an empty string, when the picture should be generated later."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","examples":["A small rusty-red squirrel with a bushy tail, Pixar-style 3D."],"description":"Visual description: style, appearance, materials, and colors. Do not put the image URL here."}},"description":"One character, environment, or object. Put an existing picture in image_url.","additionalProperties":true}},{"type":"null"}],"title":"Objects","description":"Props, products, and logos. Each item has name, description, and image_url."},"characters":{"anyOf":[{"type":"array","items":{"type":"object","title":"StoryElementInput","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","examples":["Whiskers"],"description":"Short distinct name. Scene text refers to this name, so keep the spelling identical everywhere."},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image URL","examples":["https://example.com/whiskers.png"],"description":"Public https URL of an existing picture of this character, place, or object. This is how you pass a product photo or logo. Omit it, or send an empty string, when the picture should be generated later."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","examples":["A small rusty-red squirrel with a bushy tail, Pixar-style 3D."],"description":"Visual description: style, appearance, materials, and colors. Do not put the image URL here."}},"description":"One character, environment, or object. Put an existing picture in image_url.","additionalProperties":true}},{"type":"null"}],"title":"Characters","description":"People or creatures. Each item has name, description, and image_url."},"environments":{"anyOf":[{"type":"array","items":{"type":"object","title":"StoryElementInput","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","examples":["Whiskers"],"description":"Short distinct name. Scene text refers to this name, so keep the spelling identical everywhere."},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image URL","examples":["https://example.com/whiskers.png"],"description":"Public https URL of an existing picture of this character, place, or object. This is how you pass a product photo or logo. Omit it, or send an empty string, when the picture should be generated later."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","examples":["A small rusty-red squirrel with a bushy tail, Pixar-style 3D."],"description":"Visual description: style, appearance, materials, and colors. Do not put the image URL here."}},"description":"One character, environment, or object. Put an existing picture in image_url.","additionalProperties":true}},{"type":"null"}],"title":"Environments","description":"Locations and backgrounds. Each item has name, description, and image_url."}},"description":"Pre-defined story elements. Extra keys are kept so older payloads are not dropped.","additionalProperties":true},{"type":"null"}],"title":"Story Elements","examples":[{"objects":[{"name":"Logo","image_url":"https://example.com/logo.png","description":"Brand logo, flat, on a transparent background."}],"characters":[{"name":"Whiskers","image_url":"https://example.com/whiskers.png","description":"A small rusty-red squirrel with a bushy tail, Pixar-style 3D."}],"environments":[{"name":"Sunny Meadow","image_url":"","description":"A golden meadow with wildflowers and a clear blue sky."}]}],"description":"JSON object of characters, environments, and objects you already have. Do not include scenes. Each list item is {name, description, image_url}. image_url is a public https URL of an existing picture. Leave image_url empty to generate the picture later. Example: {\"objects\":[{\"name\":\"Logo\",\"description\":\"Brand logo, flat.\",\"image_url\":\"https://example.com/logo.png\"}]}"},"language":{"enum":["Arabic","Chinese","English","French","German","Hindi","Japanese","Korean","Spanish","Turkish"],"type":"string","title":"Language","default":"English","examples":["English","Spanish","French","German","Japanese"]},"image_tool":{"enum":["AutoI","Seedream","FluxTurbo","NanoBanana","QwenImage"],"type":"string","title":"Image Generation Model","default":"AutoI","examples":["AutoI","Seedream","FluxTurbo","NanoBanana","QwenImage"]},"video_tool":{"enum":["Auto","KlingAI","Seedance","Pixverse","VeoFast","Vidu","AutoT1","VeoLite","PVideo"],"type":"string","title":"Video Animation Method","default":"Auto","examples":["Auto","KlingAI","Seedance","Pixverse","VeoFast","Vidu","AutoT1","VeoLite","PVideo"]},"scene_count":{"type":"integer","title":"Number of Scenes","default":3,"minimum":1,"examples":[3,5,7]},"webhook_url":{"type":"string","title":"Webhook URL","default":""},"aspect_ratio":{"enum":["16:9","4:3","1:1","3:4","9:16"],"type":"string","title":"Aspect Ratio","default":"16:9","examples":["16:9","4:3","1:1","3:4","9:16"]},"audio_option":{"anyOf":[{"type":"object","title":"StoryAudioOption","examples":[{"narrator":"AutoV","has_bg_music":true,"native_audio":false,"has_narration":true}],"properties":{"narrator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Narrator","examples":["AutoV"],"description":"Voice used when has_narration is true. Voices: AutoV, Rachel, Aria, Roger, Sarah, Laura, Charlie, George, Callum, River, Liam, Charlotte, Alice, Matilda, Will, Jessica, Eric, Chris, Brian, Daniel, Lily, Bill."},"has_bg_music":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Background Music","examples":[true],"description":"When true, generate background music. Omit to keep the default (true)."},"native_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Native Audio","examples":[false],"description":"When true, the video model adds sound and lip sync and narration is not used. Omit to keep the default (false)."},"has_narration":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Narration","examples":[true],"description":"When true, generate spoken narration. Ignored when native_audio is true. Omit to keep the default (true)."}},"description":"Audio for story endpoints. JSON object, not a string. This is not the media audio_option shape.","additionalProperties":true},{"type":"string"},{"type":"null"}],"title":"Audio Configuration","examples":[{"narrator":"AutoV","has_bg_music":true,"native_audio":false,"has_narration":true},{"native_audio":true}],"description":"JSON object for story audio. Not a string, and not the media audio_option shape. Keys: has_bg_music (boolean), has_narration (boolean), native_audio (boolean), narrator (voice name). When native_audio is true, narration is not used. Example: {\"has_bg_music\":true,\"has_narration\":true,\"native_audio\":false,\"narrator\":\"AutoV\"}"},"is_transition":{"type":"boolean","title":"Enable Transitions","default":false,"examples":[false,true]},"scene_duration":{"type":"integer","title":"Scene Duration","default":5,"maximum":30,"minimum":1,"description":"Duration per scene in seconds. The supported values vary based on video tool selected."}},"description":"Request body for POST /story/idea-2-video. Send with Content-Type: application/json."},"responseSchema":{"type":"object","title":"CustomerStoryResponse","properties":{"id":{"type":"string","title":"ID","default":""},"idea":{"type":"string","title":"Idea","default":"","description":"Idea of the story"},"title":{"type":"string","title":"Title","default":""},"status":{"type":"string","title":"Status","default":""},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video URL"},"all_medias":{"type":"array","items":{"type":"object","title":"CustomerMediaResponse","properties":{"id":{"type":"string","title":"Id","default":""},"title":{"type":"string","title":"Title","default":""},"prompt":{"type":"string","title":"Prompt","default":""},"result":{"type":"array","items":{},"title":"Generated Video URLs","default":[]},"version":{"type":"string","title":"Version","default":"3"},"quantity":{"type":"integer","title":"Quantity","default":1,"maximum":4,"minimum":1,"description":"Number of generated outputs."},"created_at":{"type":"string","title":"Created At","default":""},"resolution":{"type":"array","items":{},"title":"Resolution","default":[]},"updated_at":{"type":"string","title":"Updated At","default":""},"video_tool":{"enum":["Auto","AutoT3","AutoT1","HappyHorse","Grok","KlingAI","KlingT3","KlingPro","GoogleOmni","VeoLite","VeoFast","Veo","RunwayML","MinimaxHailuo","MinimaxTurbo","Seedance","SeedanceFast","SeedanceT6","Pixverse","PixverseT3","Hunyuan","Vidu","PVideo","StaticMotion","Wan","TryOnVideo"],"type":"string","title":"Video Tool","default":"Auto","description":"Motion/generation tool option (same as create media)."},"customer_id":{"type":"string","title":"Customer ID","default":""},"description":{"type":"string","title":"Description","default":""},"media_items":{"type":"array","items":{},"title":"Media Items","examples":[[{"url":"https://example.com/start.png","type":"image","position":"First"},{"url":"https://example.com/end.png","type":"image","position":"Last"}]],"description":"Array of image or video inputs. Send a JSON array of objects, not a string. Each object is {\"type\":\"image\"|\"video\",\"url\":\"https://...\",\"position\":\"First\"|\"Last\"}. \"First\" is the start frame. \"Last\" is the end frame. One picture: [{\"type\":\"image\",\"url\":\"https://example.com/start.png\",\"position\":\"First\"}]. Start and end: add a second object with position Last. url must be a public https URL. Do not upload a file here and do not put audio in this array. Audio belongs in audio_option."},"webhook_url":{"type":"string","title":"Webhook URL is called when status of the media has been updated.","default":""},"audio_option":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Audio Option","examples":[{"narrator":"Sarah","narration":"Introducing the next generation of smart performance.","bg_music_prompt":"Modern cinematic background with soft electronic pulses"}],"description":"JSON object for speech and music. Not a string. Keys: narrator (voice name), narration (script), narration_url (public mp3/wav; wins over narrator and narration), bg_music_prompt (music description), bg_music_url (public mp3/wav; wins over bg_music_prompt), native_audio (boolean). Example: {\"narrator\":\"Sarah\",\"narration\":\"Introducing the next generation of smart performance.\"}"},"used_credits":{"type":"integer","title":"Used Credits","default":0},"payment_status":{"type":"string","title":"Payment Status","default":""},"primary_user_id":{"type":"string","title":"Primary User ID","default":"","description":"Utilize the `primary_user_id` parameter to determine the owner of the Media. If the `primary_user_id` value is not included in the request object, it will default to your customer_id."},"processing_status":{"type":"string","title":"Processing Status","default":"new"}},"description":"Customer-facing media response model for non-product customers.\nThis intentionally excludes internal/advanced fields from MediaV3."},"title":"All Medias","description":"Generated media records for this story. Each record's media_items array uses {type, url, position}."},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"storyboard":{"anyOf":[{"type":"object","title":"StoryboardResponse","properties":{"music":{"anyOf":[{"type":"object","title":"StoryboardMusicResponse","properties":{"lyrics":{"type":"string","title":"Lyrics","default":""},"music_url":{"type":"string","title":"Music URL","default":"","description":"Public https URL of a music file."},"description":{"type":"string","title":"Description","default":"","description":"Music prompt: genre, tempo, instruments, mood."}},"description":"Storyboard music (description, lyrics, music_url).","additionalProperties":true},{"type":"null"}]},"scenes":{"type":"array","items":{"type":"object","title":"StoryboardSceneResponse","properties":{"name":{"type":"string","title":"Name","default":""},"narrator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Narrator","description":"Spoken line for this scene."},"image_url":{"type":"string","title":"Image URL","default":"","description":"Public https URL of the scene still. Empty until the scene image exists."},"narration_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Narration URL","description":"Public https URL of a narration file for this scene."},"image_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Description"},"video_description":{"type":"string","title":"Video Description","default":"","description":"Motion prompt for this scene."}},"description":"Storyboard scene with video/image descriptions and narrator text.","additionalProperties":true},"title":"Scenes","description":"List of scenes"},"objects":{"type":"array","items":{"type":"object","title":"StoryElementItemResponse","properties":{"name":{"type":"string","title":"Name","default":"","description":"Short distinct name used in scene text."},"image_url":{"type":"string","title":"Image URL","default":"","description":"Public https URL of an existing picture. Empty when the picture is generated later."},"description":{"type":"string","title":"Description","default":"","description":"Visual description. The picture URL goes in image_url."}},"description":"Single character, environment, or object in story elements.","additionalProperties":true},"title":"Objects","description":"List of objects"},"characters":{"type":"array","items":{"type":"object","title":"StoryElementItemResponse","properties":{"name":{"type":"string","title":"Name","default":"","description":"Short distinct name used in scene text."},"image_url":{"type":"string","title":"Image URL","default":"","description":"Public https URL of an existing picture. Empty when the picture is generated later."},"description":{"type":"string","title":"Description","default":"","description":"Visual description. The picture URL goes in image_url."}},"description":"Single character, environment, or object in story elements.","additionalProperties":true},"title":"Characters","description":"List of characters"},"environments":{"type":"array","items":{"type":"object","title":"StoryElementItemResponse","properties":{"name":{"type":"string","title":"Name","default":"","description":"Short distinct name used in scene text."},"image_url":{"type":"string","title":"Image URL","default":"","description":"Public https URL of an existing picture. Empty when the picture is generated later."},"description":{"type":"string","title":"Description","default":"","description":"Visual description. The picture URL goes in image_url."}},"description":"Single character, environment, or object in story elements.","additionalProperties":true},"title":"Environments","description":"List of environments"}},"description":"Full storyboard (scenes, characters, music, environments, objects).","additionalProperties":true},{"type":"null"}],"title":"Storyboard","description":"Storyboard"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook URL","description":"Webhook URL is called after batch or story is finished"},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aspect Ratio"},"used_credits":{"type":"integer","title":"Used Credits","default":0},"is_transition":{"type":"boolean","title":"Enable Transitions","default":false},"progress_percentage":{"type":"integer","title":"Progress Percentage","default":0}},"description":"Customer Story Response"},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"4.5","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"dynamic","summary":"$4.5/call (dynamic — varies by input)","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"4.5","per":"call","confidence":"exact"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"4.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ON2LYI9N3DPzozy9_sghM","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"4.5","costPer":"request","priority":0,"asset":"usd","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.vimmerse.net","brandSlug":"agents-vimmerse-net-x402","brandBaseUrl":"https://agents.vimmerse.net","brandDocsUrl":null,"whatItDoes":"Converts a plain-text idea into a fully produced multi-scene video with narration and background music in a single API call","exampleAgentPrompt":"Can you create a 4-scene vertical (9:16) promotional video from this idea: 'Three friends discover a hidden waterfall in a jungle and celebrate with a picnic'? Use Cinematic Narrative style, 5 seconds per scene, with background music and English narration.","exampleUseCases":[{"title":"Social media promotional video","prompt":"Make me a 4-scene vertical video for Instagram from this idea: 'A cozy coffee shop on a rainy day where baristas craft latte art for happy customers' — use Cinematic Narrative style, 9:16 aspect ratio, 5 seconds per scene, with background music and English narration."},{"title":"Product launch marketing video","prompt":"Generate a 5-scene widescreen (16:9) promotional video in Photorealistic style from this idea: 'Launch of a new electric sports car racing through mountain roads at sunset, showcasing speed and design' — include narration in English, background music, and 6 seconds per scene."},{"title":"Children's animated story","prompt":"Create a 6-scene kids' story video using 3D Pixar style from this idea: 'A small dragon who is afraid of fire learns to be brave with help from woodland animal friends' — 9:16 format, 5 seconds per scene, English narration, and cheerful background music."}],"resultDescription":"Returns a story object with an ID and initial status. The agent must poll GET /v2/story/{story_id} until status is 'success', then read video_url for the final composed video. The response also includes all_medias with per-scene video URLs, prompts, resolution, and tool used.","failureModes":["Insufficient credits — 402 payment required before generation begins","Invalid or missing 'idea' field — 422 validation error","Unsupported style or tool enum value — 422 validation error","Pipeline timeout on long or complex ideas — status may stay 'processing' indefinitely","Video tool unavailable — falls back to Auto or returns error","Webhook delivery failure if webhook_url is unreachable"],"whenToPreferThis":"Choose this endpoint when you want a fully automated, hands-off pipeline that takes a single text idea all the way to a finished composed video with audio, narration, and multiple scenes — without needing to manually manage storyboarding, scene generation, or audio assembly. Prefer it over Create Media when you need a multi-scene narrative video rather than a single clip, and over manual workflows when speed and automation matter more than fine-grained per-scene control.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:42:16.159Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-vimmerse-idea-to-video-934a0a00"}