# Vimmerse Audio Credit Estimator

> Vimmerse Audio 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-30).

Estimates the credit cost for an audio generation request (text-to-speech, text-to-audio, text-to-music, or upload-audio) without actually creating an asset.

## Facts

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

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-audio-credit-estimator-9f955b46 -d '<json body>'
```

Example prompt: Before I generate anything, can you estimate how many Vimmerse credits it would cost to use ElevenLabsTTS to convert a short paragraph of text into speech — just 1 clip?

## When to prefer this

Use this endpoint before committing to any audio generation on Vimmerse when you need to verify credit cost, stay within a budget, or present pricing to a user before they approve a transaction. It is a free, side-effect-free dry run that returns the exact same credit figure that the corresponding generation endpoint would charge.

## Known failure modes

- Missing required 'option' field returns 422 validation error
- Invalid app_name value returns 422 unprocessable entity
- Quantity exceeds maximum of 4 returns validation error
- Invalid option string for the selected app_name may return 400 or unexpected zero estimate
- Network timeout if the pricing service is temporarily unavailable

## How this service works

Estimates credits **without** creating an asset.

| Field | Required | Notes |
|-------|----------|-------|
| `app_name` | Yes | `text-to-speech`, `text-to-audio`, `text-to-music`, `upload-audio` |
| `option` | Yes | e.g. `AutoA`, `ElevenLabsTTS`, `ChirpTTS`, `MinimaxTTS`, `ElevenLabsSE`, `MMAudio`, `Lyria` |
| `quantity` | No | Default `1` |
| `prompt` | No | Length-based pricing when applicable |
| `duration` | No | Seconds (sound effects) |
| `voice` | No | e.g. `AutoV` (text-to-speech) |

## Output

Returns an integer total_credits representing the exact number of credits that would be charged, plus a breakdown object showing the step-by-step pricing components (model tier, duration, quantity factors, etc.), without creating any asset or consuming any credits.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "EstimateAudioCreditsRequest",
 "required": [
  "option"
 ],
 "properties": {
  "option": {
   "type": "string",
   "title": "Generation Option",
   "description": "Model/tool `option` on the target audio endpoint (e.g. ElevenLabsTTS, ChirpTTS, MinimaxTTS, ElevenLabsSE, MMAudio, Lyria)."
  },
  "prompt": {
   "type": "string",
   "title": "Prompt",
   "default": ""
  },
  "app_name": {
   "type": "string",
   "title": "App Name",
   "default": "text-to-speech",
   "description": "Internal route id on the asset record (same as the target POST /audio/* route). Available values: `text-to-speech` (default), `text-to-audio`, `text-to-music`, `upload-audio` (0 credits)."
  },
  "duration": {
   "anyOf": [
    {
     "type": "integer"
    },
    {
     "type": "null"
    }
   ],
   "title": "Duration (seconds)",
   "description": "Same as `duration` on audio routes such as text-2-sound-effect."
  },
  "quantity": {
   "type": "integer",
   "title": "Quantity",
   "default": 1,
   "maximum": 4,
   "minimum": 1
  },
  "audio_duration": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ],
   "title": "Audio Duration",
   "description": "Explicit seconds override (alias of duration for audio apps)."
  }
 },
 "description": "Body for POST /audio/estimate-credits."
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "EstimateAssetCreditsResponse",
 "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."
  }
 },
 "description": "Credit estimate for asset generation (anonymous; no user balance)."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-audio-credit-estimator-9f955b46/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)