---
title: "Scriptivox Developer Platform"
description: "The Scriptivox developer platform: the REST API, the MCP server, the CLI, and how to authenticate to them."
canonical: "https://platform.scriptivox.com/"
---

# Scriptivox Developer Platform

> Scriptivox turns recorded audio and video into text over a REST API. Send a file by public URL or presigned upload, and get back a structured transcript with per-utterance and per-word timestamps, optional speaker diarization, and SRT, WebVTT or plain-text exports. 119 languages, files up to 5 GB and 10 hours long, billed at $0.20 per hour of audio with no subscription and no minimum commitment.

Reach for it when you have **recorded** media to turn into text: meeting and interview recordings, podcasts, lecture capture, call archives, video libraries that need captions, or a pipeline that needs word-level timestamps to make clips searchable. It is not a live-streaming or real-time dictation API — every job takes a complete file.

## How an integration works

Create an API key on this platform, then call `POST /v1/transcribe`. It returns immediately with `status: "created"`. The file is downloaded and validated in the background, so input problems surface later on the GET endpoint with `status: "failed"` — not on the submit call. Poll `GET /v1/transcribe/{id}` or register a webhook.

Authenticate with `Authorization: sk_live_…` or `X-Api-Key`. Every error is JSON with a stable machine-readable code: `{"error": {"code": "…", "message": "…"}}`. Cost is reserved once the duration is known, and failed or cancelled jobs are free.

```bash
curl -X POST https://api.scriptivox.com/v1/transcribe   -H "Authorization: sk_live_YOUR_KEY"   -H "Content-Type: application/json"   -d '{"url": "https://example.com/meeting.mp3", "diarize": true}'
```

## Endpoints

Base URL: `https://api.scriptivox.com/v1`

| Method | Path | What it does |
| --- | --- | --- |
| POST | `/v1/upload` | Get a presigned URL for a file you host yourself. |
| POST | `/v1/transcribe` | Start a job from a public URL or an upload. |
| GET | `/v1/transcribe/{id}` | Poll status, then read the transcript — or export SRT, WebVTT or plain text. |
| DELETE | `/v1/transcribe/{id}` | Soft-delete a finished transcription. |
| POST | `/v1/transcribe/{id}/cancel` | Stop an in-flight job and release its reserved balance. |
| GET | `/v1/transcriptions` | List your jobs with filters and cursor pagination. |
| GET | `/v1/balance` | Check remaining balance and estimated audio hours. |

Every operation is described, with typed parameters and response schemas, by [openapi.json](https://platform.scriptivox.com/openapi.json) (YAML at https://platform.scriptivox.com/openapi.yaml).

## Documentation

- [Quickstart](https://platform.scriptivox.com/docs/quickstart): First transcription running in under five minutes, in Python, JavaScript or curl.
- [API reference](https://platform.scriptivox.com/docs/api-reference): Every endpoint, parameter, error code and rate limit.
- [Authentication](https://platform.scriptivox.com/docs/authentication): API keys, the two accepted headers, rotation, and what a 401 means.
- [Webhooks](https://platform.scriptivox.com/docs/webhooks): HMAC-signed completion callbacks instead of polling.
- [MCP server](https://platform.scriptivox.com/docs/mcp): Transcription as native tool calls from Claude, ChatGPT and other MCP clients.
- [CLI](https://platform.scriptivox.com/docs/cli): npx @scriptivox-api/cli — transcribe from a shell or a script.
- [Pricing](https://platform.scriptivox.com/docs/pricing): Pay as you go at $0.20 per hour of audio. No subscription.
- [Versioning](https://platform.scriptivox.com/docs/versioning): What can change without notice, and how deprecations are announced.
- [Use cases](https://platform.scriptivox.com/docs/use-cases): Folder watchers, batch pipelines and other worked examples.
- [OpenAPI spec](https://platform.scriptivox.com/openapi.json): Machine-readable description of the whole API surface.

## For AI agents

- Every documentation page has a markdown twin — append `.md` to its path, or request it with `Accept: text/markdown`. This landing page has one too, at [/index.md](https://platform.scriptivox.com/index.md).
- [/llms.txt](https://platform.scriptivox.com/llms.txt) describes what this service is for and when to reach for it.
- [/openapi.json](https://platform.scriptivox.com/openapi.json) and [/openapi.yaml](https://platform.scriptivox.com/openapi.yaml) describe every operation with typed parameters and response schemas.
- An MCP server is published as `@scriptivox/mcp-server` on npm — see [/.well-known/mcp](https://platform.scriptivox.com/.well-known/mcp).
- For shells and scripts there is a CLI: `npx @scriptivox-api/cli`. Same API, different transport — structured output on stdout, progress on stderr, and exit codes that separate a usage error from an API error.

## About

- [About](https://platform.scriptivox.com/about)
- [Contact](https://platform.scriptivox.com/contact)
- [Privacy](https://platform.scriptivox.com/privacy)
- [Terms](https://platform.scriptivox.com/terms)
- [Status](https://status.scriptivox.com)
- [scriptivox.com](https://www.scriptivox.com)

Support: support@scriptivox.com