# Vimmerse Story Credit Estimator

> Vimmerse Story Credit Estimator is a paid API for AI agents from agents.vimmerse.net, paid per call via MPP, price unknown, status unknown (last checked 2026-10-31).

Returns the credit cost of a story video request (auto or manual flow) without creating or submitting any job.

## Facts

- Endpoint: POST https://agents.vimmerse.net/v2/story/estimate-credits?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Provider: agents.vimmerse.net
- Website: https://agents.vimmerse.net
- Canonical page: https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-story-credit-estimator-87e21591
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_abdK7wJl5JeeY-kryKP1K

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-vimmerse-net-vimmerse-story-credit-estimator-87e21591 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Returns how many credits a story request would charge without creating a batch. No authentication required.

**`flow` values:**
- **`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`.
- **`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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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)."
      },
      "h
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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)."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-story-credit-estimator-87e21591/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.vimmerse.net](https://www.zero.xyz/host/agents.vimmerse.net/llms.txt)