{"uid":"cap_abdK7wJl5JeeY-kryKP1K","slug":"agents-vimmerse-net-vimmerse-story-credit-estimator-87e21591","name":"Vimmerse Story Credit Estimator","description":"Returns how many credits a story request would charge without creating a batch. No authentication required.\n\n**`flow` values:**\n- **`auto`** — Same pricing as **POST /v2/story/idea-2-video** (and url/images-2-video): `video_tool`, `scene_count`, `scene_duration`, and optional `audio_option.native_audio`.\n- **`manual`** — Step-by-step story workflow (storyboard → elements → scenes → videos). Credits are **dynamic** based on storyboard content and `scene_count`; this endpoint does not return a fixed total for manual flows.","url":"https://agents.vimmerse.net/v2/story/estimate-credits?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"EstimateStoryCreditsRequest","properties":{"flow":{"enum":["auto","manual"],"type":"string","title":"Flow","default":"auto","description":"`auto` — idea/url/images-2-video (per-second scene pricing). `manual` — step-by-step workflow; credits are dynamic based on storyboard and scene_count."},"loop":{"type":"integer","title":"Motion Loop Count","default":1,"maximum":6,"minimum":1,"description":"Ignored for `manual` flow."},"duration":{"type":"integer","title":"Clip Duration","default":5,"maximum":30,"minimum":1,"description":"Ignored for `manual` flow."},"video_tool":{"enum":["Auto","KlingAI","Seedance","Pixverse","VeoFast","Vidu","AutoT1","VeoLite","PVideo"],"type":"string","title":"Video Tool","default":"Auto"},"scene_count":{"type":"integer","title":"Number of Scenes","default":3,"minimum":1},"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":"null"}],"title":"Audio Option","examples":[{"narrator":"AutoV","has_bg_music":true,"native_audio":false,"has_narration":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\"} For auto flow, native_audio doubles video credits when true."},"scene_duration":{"type":"integer","title":"Scene Duration","default":5,"maximum":30,"minimum":1,"description":"Seconds per scene (auto flow)."}},"description":"Body for estimating v2 story credits without creating a batch."},"responseSchema":{"type":"object","title":"EstimateStoryCreditsResponse","required":["total_credits","breakdown"],"properties":{"breakdown":{"type":"object","title":"Breakdown","description":"Step-by-step pricing components.","additionalProperties":true},"total_credits":{"type":"integer","title":"Total Credits","description":"Total credits that would be charged for the given flow and parameters."}},"description":"Credit estimate aligned with v2 story billing (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_viZoCk5b8SYMcpfnge6dM","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 story video request (auto or manual flow) without creating or submitting any job.","exampleAgentPrompt":"Before I kick off the story job, tell me how many Vimmerse credits it'll cost to make an auto-flow story with 4 scenes, 8 seconds each, using KlingAI with narration and background music.","exampleUseCases":[{"title":"Budget check before story submission","prompt":"How many credits will it cost to run an auto-flow story on Vimmerse with 6 scenes at 5 seconds each using Seedance and native audio? I want to know before I commit."},{"title":"Comparing video tools by cost","prompt":"Can you estimate the credits for the same 3-scene, 10-second auto story using KlingAI vs VeoFast so I can pick the cheaper option?"},{"title":"Planning a large batch story","prompt":"I'm planning a 10-scene auto-flow story with PVideo, 7 seconds per scene, with narration using the Rachel voice and background music — what's the total credit cost?"}],"resultDescription":"Returns a JSON object with `total_credits` (integer, the exact number of credits that would be billed) and `breakdown` (object with step-by-step pricing components). For manual flows, credits are dynamic and the total may not be fixed.","failureModes":["Invalid `flow` value — must be 'auto' or 'manual'","`scene_count` below 1 returns a validation error","`duration` or `loop` outside allowed range (1–30 and 1–6 respectively) causes 422","Unsupported `video_tool` enum value returns error","Manual flow may return an approximate or non-fixed total_credits due to dynamic pricing"],"whenToPreferThis":"Use this endpoint whenever you need to know the credit cost of a Vimmerse story request before committing to creating the job. It requires no authentication, making it ideal for pre-flight budget checks, tool comparisons, or user-facing cost previews. Prefer it over submitting a real job just to see the price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:41:56.558Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-vimmerse-story-credit-estimator-87e21591"}