> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apisale.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# ElevenLabs Speech to Text — Speech To Text
> ElevenLabs Scribe v2 speech-to-text. Optimized for speech to text via apisale.
## Overview
ElevenLabs Scribe v2 speech-to-text. Optimized for speech to text via apisale.
**Docs** = API contract + Try it (snapshot). **[Explore](https://apisale.ai/explore)** = browser playground. **[Model page](https://apisale.ai/models/elevenlabs/elevenlabs-stt/speech-to-text)** = product examples.
## Endpoint
```http theme={null}
POST https://api.apisale.ai/v1/run/elevenlabs/elevenlabs-stt/speech-to-text
```
| | |
| -------------- | ------------------------------------------ |
| **Model slug** | `elevenlabs/elevenlabs-stt/speech-to-text` |
| **Category** | Speech To Text (`speech-to-text`) |
| **Lab** | Elevenlabs |
| **Mode** | async |
## Pricing
**From \$0.0026/min**
apisale price is **30%** below the vendor's official list price.
| Tier | Unit | Official price | apisale price |
| ----------------------- | ------ | -------------- | ------------- |
| per minute (rounded up) | minute | \$0.0037 | \$0.0026 |
**Official price** = vendor list price. **apisale price** = what you pay through apisale.
## Request
```json theme={null}
{
"input": {
"diarize": true,
"tag_audio_events": true,
"audio_url": "https://assets.apisale.ai/permanent/official/elevenlabs/elevenlabs-music/example-01.mp3"
}
}
```
### Parameters
Fields marked \* are required. Use `Authorization: Key YOUR_API_KEY` for REST.
Default: `true`
—
—
Default: `true`
Optional HTTPS webhook when the run reaches a terminal state.
Block until completion (same Run response shape).
```json expandable theme={null}
{
"params": {
"diarize": {
"type": "bool",
"default": true
},
"audio_url": {
"type": "media",
"required": true
},
"language_code": {
"type": "string"
},
"tag_audio_events": {
"type": "bool",
"default": true
}
}
}
```
## Submit response
Returns a **Run** with `run_id`. Poll with [GET /v1/runs/\{run\_id}](/model-apis/poll-runs) or use **Try it** above.
Unique run ID — save for polling and webhooks.
`queued` (async) or terminal state for sync runs.
Result when `status` is `succeeded` — see **Output schema** below.
### Example (async submit)
```json theme={null}
{
"run_id": "run_550e8400-e29b-41d4-a716-446655440000",
"endpoint": "elevenlabs/elevenlabs-stt/speech-to-text",
"model": "speech-to-text",
"capability": "audio",
"mode": "speech-to-text",
"status": "queued",
"output": null,
"error": null,
"billing": null,
"created_at": "2026-06-27T12:00:00.000Z",
"started_at": null,
"completed_at": null,
"elapsed_ms": null
}
```
Full lifecycle: [Runs lifecycle](/model-apis/runs-lifecycle).
## Output
When `status` is `succeeded`, `output` follows this schema:
```json expandable theme={null}
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"words": {
"type": "array"
},
"language_code": {
"type": "string"
}
},
"description": "Transcription output."
}
```
## Example
```bash theme={null}
curl -X POST "https://api.apisale.ai/v1/run/elevenlabs/elevenlabs-stt/speech-to-text" \
-H "Authorization: Key YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"diarize": true,
"tag_audio_events": true,
"audio_url": "https://assets.apisale.ai/permanent/official/elevenlabs/elevenlabs-music/example-01.mp3"
}
}'
```
## Related
* [Runs lifecycle](/model-apis/runs-lifecycle)
* [Audio API overview](/api/audio)
* [Account API](/get-started/account-and-monitoring)
## OpenAPI
````yaml openapi-catalog.json POST /v1/run/elevenlabs/elevenlabs-stt/speech-to-text
openapi: 3.0.3
info:
title: apisale Model Catalog
version: '2026-09-01T09:47:50.773Z'
description: Per-model OpenAPI operations for Mintlify Try playground.
servers:
- url: https://api.apisale.ai
security: []
paths:
/v1/run/elevenlabs/elevenlabs-stt/speech-to-text:
post:
tags:
- Model catalog
- audio
- Elevenlabs
summary: Create ElevenLabs Speech to Text — Speech To Text
description: >-
ElevenLabs Scribe v2 speech-to-text. Optimized for speech to text via
apisale.
operationId: submit-elevenlabs-elevenlabs-stt-speech-to-text
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- input
properties:
input:
type: object
properties:
diarize:
type: boolean
default: true
audio_url:
type: string
format: uri
language_code:
type: string
tag_audio_events:
type: boolean
default: true
required:
- audio_url
example:
diarize: true
tag_audio_events: true
audio_url: >-
https://assets.apisale.ai/permanent/official/elevenlabs/elevenlabs-music/example-01.mp3
webhook_url:
type: string
format: uri
sync:
type: boolean
default: false
example:
input:
diarize: true
tag_audio_events: true
audio_url: >-
https://assets.apisale.ai/permanent/official/elevenlabs/elevenlabs-music/example-01.mp3
responses:
'201':
description: Run accepted
content:
application/json:
schema:
$ref: '#/components/schemas/RunObject'
security:
- ApiKeyAuth: []
components:
schemas:
RunObject:
type: object
required:
- run_id
- endpoint
- model
- capability
- mode
- status
- created_at
properties:
run_id:
type: string
description: Unique run identifier
endpoint:
type: string
description: Model slug
model:
type: string
capability:
type: string
mode:
type: string
status:
type: string
enum:
- queued
- processing
- succeeded
- failed
- timeout
- cancelled
output:
type: object
nullable: true
error:
type: object
nullable: true
properties:
type:
type: string
description: Machine-readable error code
code:
type: number
description: HTTP status
message:
type: string
billing:
type: object
nullable: true
properties:
amount:
type: string
currency:
type: string
enum:
- usd
created_at:
type: string
format: date-time
started_at:
type: string
format: date-time
nullable: true
completed_at:
type: string
format: date-time
nullable: true
elapsed_ms:
type: number
nullable: true
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: Key sk-... (native REST) or Bearer sk-... (vendor SDKs)
````