{"uid":"cap_Yp9Z1NobNEYNGqzy9giIh","slug":"agents-vimmerse-net-vimmerse-estimate-credits-aad488d3","name":"Vimmerse Estimate Credits","description":"Returns how many credits a **POST /v2/media** request would charge for the given `video_tool`, `duration`, `quantity`, and optional `audio_option`, without creating a job. No authentication required; response is pricing-only (no per-user balance). Uses the same billing rules as create/update regeneration. Prompt text, `pipeline_mode`, `aspect_ratio`, and `loop` do **not** change credits today (duration is the requested clip length in seconds, not derived from prompt).","url":"https://agents.vimmerse.net/v2/media/estimate-credits?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"EstimateMediaCreditsRequest","properties":{"duration":{"type":"integer","title":"Scene Duration","default":5,"maximum":15,"minimum":1,"description":"Target clip duration in seconds (same as create media)."},"quantity":{"type":"integer","title":"Quantity","default":1,"maximum":4,"minimum":1,"description":"Number of generated outputs."},"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)."},"audio_option":{"anyOf":[{"type":"object","title":"MediaAudioOption","examples":[{"narrator":"Sarah","narration":"Introducing the next generation of smart performance.","bg_music_prompt":"Modern cinematic background with soft electronic pulses"}],"properties":{"narrator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Narrator","examples":["Sarah"],"description":"Voice for narration text. Voices: AutoV, Rachel, Aria, Roger, Sarah, Laura, Charlie, George, Callum, River, Liam, Charlotte, Alice, Matilda, Will, Jessica, Eric, Chris, Brian, Daniel, Lily, Bill. Ignored when narration_url is set."},"narration":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Narration","examples":["Introducing the next generation of smart performance."],"description":"Spoken script. The narrator voice reads this text. Ignored when narration_url is set."},"bg_music_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Background Music URL","examples":["https://example.com/background.mp3"],"description":"Public https URL of a music file (mp3 or wav). When set, bg_music_prompt is ignored."},"native_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Native Audio","examples":[false],"description":"When true, the video model adds its own sound and lip sync on tools that support it."},"narration_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Narration URL","examples":["https://example.com/voiceover.mp3"],"description":"Public https URL of a pre-recorded voice track (mp3 or wav). When set, narrator and narration are ignored."},"bg_music_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Background Music Prompt","examples":["Modern cinematic background with soft electronic pulses"],"description":"Text prompt for generated background music. Ignored when bg_music_url is set."}},"description":"Audio for POST /v2/media. JSON object, not a string.","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.\"}"}},"description":"Body for estimating v2 media generation credits (same pricing fields as create, without starting a job)."},"responseSchema":{"type":"object","title":"EstimateMediaCreditsResponse","required":["total_credits","breakdown"],"properties":{"breakdown":{"type":"object","title":"Breakdown","description":"Step-by-step components: model base, duration tier, quantity, native_audio doubling, TTS/Lyria add-ons.","additionalProperties":true},"total_credits":{"type":"integer","title":"Total Credits","description":"Total credits that would be charged for one create request with these parameters."}},"description":"Credit estimate aligned with POST /v2/media billing logic (anonymous; no user balance)."},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_kzTRgJ9ivQBWAJT8hLaZ1","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.vimmerse.net","brandSlug":"agents-vimmerse-net-x402","brandBaseUrl":"https://agents.vimmerse.net","brandDocsUrl":null,"whatItDoes":"Returns the credit cost of a POST /v2/media video generation request for given tool, duration, quantity, and audio options — without creating a job or requiring authentication.","exampleAgentPrompt":"Before I actually generate anything, can you tell me how many Vimmerse credits it would cost to create 2 KlingAI clips, each 10 seconds long, with Sarah narrating the line 'Introducing the next generation of smart performance' and a cinematic background music prompt?","exampleUseCases":[{"title":"Pre-flight cost check for video campaign","prompt":"Before we kick off the video campaign, tell me how many credits it would cost to generate 4 clips using KlingPro at 15 seconds each with background music — I don't want to actually submit the job yet, just get the price."},{"title":"Compare tool costs before choosing","prompt":"Can you estimate how many Vimmerse credits a 10-second video would cost if I use Veo versus RunwayML versus KlingAI, with quantity 1 and no audio, so I can decide which tool fits my budget?"},{"title":"Audio add-on cost impact check","prompt":"How many more credits would it cost to add a Sarah narrator voiceover and background music prompt to a 5-second Auto video on Vimmerse, compared to generating it without any audio?"}],"resultDescription":"A JSON object with `total_credits` (integer total that would be charged) and `breakdown` (object detailing each billing component: model base cost, duration tier, quantity multiplier, native audio doubling, TTS and Lyria music add-ons). No job is created and no user balance is affected.","failureModes":["Invalid video_tool enum value returns validation error","duration outside 1-15 range or quantity outside 1-4 range returns 422 validation error","Malformed audio_option object causes schema validation failure","Service unavailable or timeout if the pricing engine is unreachable"],"whenToPreferThis":"Use this endpoint when you want to know the credit cost of a video generation request before committing to it — ideal for budget checks, cost comparisons between video tools, or confirming that a user's credit balance will cover a planned job. Prefer this over directly calling POST /v2/media when the user wants to preview pricing, compare options, or requires approval before spending credits.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:37:39.842Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-vimmerse-estimate-credits-aad488d3"}