# Vimmerse Estimate Credits

> Vimmerse Estimate Credits 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 POST /v2/media video generation request for given tool, duration, quantity, and audio options — without creating a job or requiring authentication.

## Facts

- Endpoint: POST https://agents.vimmerse.net/v2/media/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-estimate-credits-aad488d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Yp9Z1NobNEYNGqzy9giIh

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-estimate-credits-aad488d3 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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).

## Output

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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-estimate-credits-aad488d3/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)