{"slug":"agents-vimmerse-co-v2-media-b1eeca","title":"Queues a video generation job from a text prompt, optional reference media and a","host":"agents.vimmerse.co","method":"POST","resource":"https://agents.vimmerse.co/v2/media","category":"image","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 ","price_listed":1.2,"price_asked":1.2,"state":"answering","state_label":"Answering","checks_7d":3,"answered_7d":3,"latency_ms_median":636,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453","zeroclick:card"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"aspect_ratio":"16:9","duration":5,"prompt":"Slow cinematic orbit around a skincare jar on a marble counter, soft morning light","quantity":1,"title":"Skincare launch clip","video_tool":"Auto"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"description":"Create media request.","example":{"aspect_ratio":"16:9","duration":5,"prompt":"Slow cinematic orbit around a skincare jar on a marble counter, soft morning light","quantity":1,"title":"Skincare launch clip","video_tool":"Auto"},"properties":{"aspect_ratio":{"description":"Output aspect ratio.","type":"string"},"audio_option":{"additionalProperties":true,"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).","properties":{"bg_music_prompt":{"description":"Description of generated background music.","type":"string"},"bg_music_url":{"description":"External background music URL.","format":"uri","type":"string"},"narration":{"description":"Text to speak with the narrator.","type":"string"},"narration_url":{"description":"Pre-recorded narration URL; wins over narration.","format":"uri","type":"string"},"narrator":{"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.","type":"string"},"native_audio":{"description":"Native audio from the video model.","type":"boolean"}},"type":"object"},"description":{"default":"","description":"Media description.","type":"string"},"duration":{"default":5,"description":"Clip length in seconds.","type":"integer"},"loop":{"default":1,"description":"Loop count applied in post-processing.","type":"integer"},"media_items":{"description":"Optional input media items (objects carrying a public image, video or audio URL) for image-to-video or reference-based generation.","items":{"additionalProperties":true,"type":"object"},"type":"array"},"pipeline_mode":{"default":"Advanced","description":"Advanced preprocesses inputs and post-processes the video; Quick uses inputs as they are.","enum":["Advanced","Quick"],"type":"string"},"prompt":{"default":"","description":"Text prompt for the video.","type":"string"},"quantity":{"default":1,"description":"Number of clips.","type":"integer"},"title":{"default":"","description":"Media title.","type":"string"},"video_tool":{"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.","enum":["Auto","AutoT3","AutoT1","HappyHorse","Grok","KlingAI","KlingT3","GoogleOmni","VeoLite","VeoFast","Veo","RunwayML","MinimaxHailuo","MinimaxTurbo","Seedance","SeedanceFast","SeedanceT6","Pixverse","PixverseT3","Hunyuan","Vidu","PVideo","StaticMotion","Wan","TryOnVideo"],"type":"string"},"webhook_url":{"description":"Optional callback URL that receives status updates.","format":"uri","type":"string"}},"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-31","reachable":true,"status":402,"valid_402":true,"asked_usdc":1.2,"price_match":true,"latency_ms":888,"error":null},{"day":"2026-10-29","reachable":true,"status":402,"valid_402":true,"asked_usdc":1.2,"price_match":true,"latency_ms":499,"error":null},{"day":"2026-10-27","reachable":true,"status":402,"valid_402":true,"asked_usdc":1.2,"price_match":true,"latency_ms":636,"error":null}],"description_full":"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.","last_updated":"2026-10-27T06:27:11.35Z","schemes":["exact"]}