{"uid":"cap_DMSBU0NFpHZ0f_nBHOAAn","slug":"vimmerse-video-generation-a0983284","name":"Vimmerse Video Generation","description":"Queues a video generation job from a text prompt, optional reference media and an optional audio track, and returns the media object at once. Poll GET /v2/media/{media_id} until processing_status is success and read the URLs in result. Credits depend on the tool tier, the duration, the quantity and the audio options, and the estimate route returns the exact number.","url":"https://agents.vimmerse.co/v2/media?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"loop":{"type":"integer","default":1,"description":"Loop count applied in post-processing."},"title":{"type":"string","default":"","description":"Media title."},"prompt":{"type":"string","default":"","description":"Text prompt for the video."},"duration":{"type":"integer","default":5,"description":"Clip length in seconds."},"quantity":{"type":"integer","default":1,"description":"Number of clips."},"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","default":"Auto","description":"Video tool. Auto picks one; AutoT1 and AutoT3 pick within a tier. The choice sets the credits per call; POST /v2/media/estimate-credits returns the exact number for this body."},"description":{"type":"string","default":"","description":"Media description."},"media_items":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Optional input media items (objects carrying a public image, video or audio URL) for image-to-video or reference-based generation."},"webhook_url":{"type":"string","format":"uri","description":"Optional callback URL that receives status updates."},"aspect_ratio":{"type":"string","description":"Output aspect ratio."},"audio_option":{"type":"object","properties":{"narrator":{"type":"string","description":"Voice for narration: AutoV, Rachel, Aria, Roger, Sarah, Laura, Charlie, George, Callum, River, Liam, Charlotte, Alice, Matilda, Will, Jessica, Eric, Chris, Brian, Daniel, Lily or Bill."},"narration":{"type":"string","description":"Text to speak with the narrator."},"bg_music_url":{"type":"string","format":"uri","description":"External background music URL."},"native_audio":{"type":"boolean","description":"Native audio from the video model."},"narration_url":{"type":"string","format":"uri","description":"Pre-recorded narration URL; wins over narration."},"bg_music_prompt":{"type":"string","description":"Description of generated background music."}},"description":"Audio track: narrator (voice name, AutoV picks one), narration (text to speak), narration_url (pre-recorded MP3 or WAV), bg_music_prompt (generated music), bg_music_url (external track), native_audio (sound from the video model, doubles the credits).","additionalProperties":true},"pipeline_mode":{"enum":["Advanced","Quick"],"type":"string","default":"Advanced","description":"Advanced preprocesses inputs and post-processes the video; Quick uses inputs as they are."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1.2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"60.0000","medianCents":"60.0000","p90Cents":"60.0000","minCents":"60.0000","maxCents":"60.0000","p95Cents":"60.0000","sampleCount":1,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hCzzk37ATSKlDUtGIdozx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Queues an AI video generation job from a text prompt (with optional reference media and audio), returning immediately with a media object to poll for completion.","exampleAgentPrompt":"Generate me a 10-second looping video of a sunset over a mountain lake using the Veo model, in 16:9 aspect ratio, with soft background music — I want 1 clip.","exampleUseCases":[{"title":"Social media short-form video creation","prompt":"Create a 5-second vertical video clip of a neon-lit city street at night with rain reflections using KlingPro, with 1 clip and native audio — I want to use it for an Instagram reel."},{"title":"Product demo video with narration","prompt":"Generate a 15-second video showcasing a sleek smartwatch on a marble surface using the Seedance model, 1 clip, 16:9 aspect ratio, with narration voiced by Rachel saying 'Introducing the future of timekeeping.'"},{"title":"Looping animated background from reference image","prompt":"Take this reference image of a cozy fireplace and turn it into a 6-second seamlessly looping ambient video using Auto, 1 clip, set it to loop 3 times in post-processing."}],"resultDescription":"Returns a media object immediately upon queuing, including a media_id and initial processing_status. The agent must poll GET /v2/media/{media_id} until processing_status is 'success', at which point the response contains result URLs pointing to the generated video clip(s). Credits consumed depend on the chosen video_tool tier, duration, quantity, and audio options.","failureModes":["Insufficient credits — job queued but fails if account balance is too low","Invalid video_tool enum value returns a validation error","Reference media URLs that are inaccessible or non-public cause generation failure","Prompt content that violates content policies results in rejection","Polling timeout if generation takes longer than expected for complex prompts","Invalid aspect_ratio string may cause unexpected output dimensions or an error"],"whenToPreferThis":"Use this endpoint when you need to generate one or more AI video clips from a text prompt, optionally grounded in reference images or videos, with support for narration and background music. It is particularly valuable when you need fine-grained control over the AI model (e.g. choosing Veo, RunwayML, KlingPro, or Seedance), duration, aspect ratio, loop count, and audio. Prefer it over image generation siblings when the output must be a video. Use the /v2/media/estimate-credits route first if you need to budget accurately before submitting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-11-03T05:15:22.526Z","lastSuccessfullyRanAt":"2026-11-03T05:15:22.526Z","lastHealthCheckAt":"2026-11-04T11:49:03.079Z","isFirstParty":false,"canonicalSlug":"vimmerse-video-generation-a0983284"}