# Scribe (`scribe-1`): Speech to text

Transcripts with word timestamps, $0.001 a minute.

Scribe turns speech into text with a start and end time for every word, plus sentence segments you can use as subtitles. It handles about 100 languages and can translate speech straight to English.

Send any common audio or video file up to 5 minutes. It also answers OpenAI-style requests at `/v1/audio/transcriptions`.

- **Price:** $0.001 per minute. Billed per second of audio, rounded up, at least one second.
- **Languages:** ~100 languages (best in English, Spanish, French, German, Italian, Portuguese, Japanese)
- **Input:** An audio or video file: an https URL, a data URL, or a file in a multipart upload. MP3, WAV, M4A, OGG, FLAC, WebM, MP4 and more, up to 25 MB and 5 minutes.
- **Batch:** no, one input per call
- **Status:** live
- **Built on:** [openai/whisper-base (timestamped export)](https://huggingface.co/openai/whisper-base), Apache-2.0, 74M
- **Compatible endpoints:** POST /v1/audio/transcriptions (OpenAI)

## Request

```bash
curl https://labs.greatwork.company/v1/run \
  -H "Authorization: Bearer $GWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"scribe-1","input":"https://labs.greatwork.company/examples/voice-note.m4a"}'
```

Upload a local file with multipart: `curl https://labs.greatwork.company/v1/run -H "Authorization: Bearer $GWL_API_KEY" -F model=scribe-1 -F input=@file`

## Options

| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| `input` | audio (URL, data URL or upload) | yes | | An audio or video file: an https URL, a data URL, or a file in a multipart upload. MP3, WAV, M4A, OGG, FLAC, WebM, MP4 and more, up to 25 MB and 5 minutes. |
| `language` | string | no |  | Language of the speech (`en`, `es`, `ja`...). Detected when omitted; setting it is faster and more accurate. |
| `task` | string (transcribe \| translate) | no | `"transcribe"` | `translate` writes English text for speech in any language. |
| `timestamps` | string (word \| none) | no | `"word"` | `none` skips word timing (faster). |

## Output

| Field | Type | Description |
|---|---|---|
| `text` | string | The full transcript. |
| `language` | string | Spoken language (ISO 639-1), detected unless you set it. |
| `language_score` | number | Confidence in the detected language (only when detected). |
| `duration` | number | Audio length in seconds. |
| `words` | object[] | `text`, `start`, `end` (seconds) for each word. |
| `segments` | object[] | Sentence-sized segments with `text`, `start`, `end`, ready for subtitles. |

The response envelope is always `{"id", "object": "run", "model", "created", "output", "usage": {"units", "unit", "cost_usd", "cost_micros"}, "latency_ms"}`.

## Examples (real outputs from our servers)

### Voice note

```json
{
  "model": "scribe-1",
  "input": "https://labs.greatwork.company/examples/voice-note.m4a"
}
```

```json
{
  "text": "Hey, it's Sam, quick update on the launch. The new pricing page is live, but the checkout button still points to the old plan. Can you fix that before 3 o'clock? Thanks.",
  "language": "en",
  "language_score": 0.9914,
  "duration": 10.73,
  "words": [
    {
      "text": "Hey,",
      "start": 0.24,
      "end": 0.54
    },
    {
      "text": "it's",
      "start": 0.68,
      "end": 0.96
    },
    {
      "text": "Sam,",
      "start": 0.96,
      "end": 1.34
    },
    {
      "text": "quick",
      "start": 1.54,
      "end": 1.84
    },
    {
      "text": "update",
      "start": 1.84,
      "end": 2.1
    },
    {
      "text": "on",
      "start": 2.1,
      "end": 2.24
    },
    {
      "text": "the",
      "start": 2.24,
      "end": 2.52
    },
    {
      "text": "launch.",
      "start": 2.52,
      "end": 2.9
    },
    {
      "text": "The",
      "start": 3.04,
      "end": 3.18
    },
    {
      "text": "new",
      "start": 3.18,
      "end": 3.56
    },
    {
      "text": "pricing",
      "start": 3.56,
      "end": 3.98
    },
    {
      "text": "page",
      "start": 3.98,
      "end": 4.14
    },
    {
      "text": "is",
      "start": 4.14,
      "end": 4.34
    },
    {
      "text": "live,",
      "start": 4.34,
      "end": 4.62
    },
    {
      "text": "but",
      "start": 4.74,
      "end": 4.9
    },
    {
      "text": "the",
      "start": 4.9,
      "end": 5.22
    },
    {
      "text": "checkout",
      "start": 5.22,
      "end": 5.66
    },
    {
      "text": "button",
      "start": 5.66,
      "end": 5.9
    },
    {
      "text": "still",
      "start": 5.9,
      "end": 6.24
    },
    {
      "text": "points",
      "start": 6.24,
      "end": 6.5
    },
    {
      "text": "to",
      "start": 6.5,
      "end": 6.66
    },
    {
      "text": "the",
      "start": 6.66,
      "end": 6.88
    },
    {
      "text": "old",
      "start": 6.88,
      "end": 7.24
    },
    {
      "text": "plan.",
      "start": 7.24,
      "end": 7.58
    },
    {
      "text": "Can",
      "start": 7.8,
      "end": 7.96
    },
    {
      "text": "you",
      "start": 7.96,
      "end": 8.24
    },
    {
      "text": "fix",
      "start": 8.24,
      "end": 8.44
    },
    {
      "text": "that",
      "start": 8.44,
      "end": 8.7
    },
    {
      "text": "before",
      "start": 8.7,
      "end": 9.08
    },
    {
      "text": "3",
      "start": 9.08,
      "end": 9.2
    },
    {
      "text": "o",
      "start": 9.2,
      "end": 9.42
    },
    {
      "text": "'clock?",
      "start": 9.42,
      "end": 9.86
    },
    {
      "text": "Thanks.",
      "start": 10.36,
      "end": 10.48
    }
  ],
  "segments": [
    {
      "text": "Hey, it's Sam, quick update on the launch.",
      "start": 0.24,
      "end": 2.9
    },
    {
      "text": "The new pricing page is live, but the checkout button still points to the old plan.",
      "start": 3.04,
      "end": 7.58
    },
    {
      "text": "Can you fix that before 3 o 'clock?",
      "start": 7.8,
      "end": 9.86
    },
    {
      "text": "Thanks.",
      "start": 10.36,
      "end": 10.48
    }
  ]
}
```

6984 ms, $0.000187.

### Spanish (detected)

```json
{
  "model": "scribe-1",
  "input": "https://labs.greatwork.company/examples/spanish.m4a"
}
```

```json
{
  "text": "Hola, te llamo para confirmar la reserva del viernes al 8, somos cuatro personas y una de ellas es vegetariana, gracias.",
  "language": "es",
  "language_score": 0.994,
  "duration": 8.68,
  "words": [
    {
      "text": "Hola,",
      "start": 0.26,
      "end": 0.66
    },
    {
      "text": "te",
      "start": 0.76,
      "end": 0.9
    },
    {
      "text": "llamo",
      "start": 0.9,
      "end": 1.28
    },
    {
      "text": "para",
      "start": 1.28,
      "end": 1.7
    },
    {
      "text": "confirmar",
      "start": 1.7,
      "end": 2.08
    },
    {
      "text": "la",
      "start": 2.08,
      "end": 2.42
    },
    {
      "text": "reserva",
      "start": 2.42,
      "end": 2.8
    },
    {
      "text": "del",
      "start": 2.8,
      "end": 3
    },
    {
      "text": "viernes",
      "start": 3,
      "end": 3.42
    },
    {
      "text": "al",
      "start": 3.42,
      "end": 3.78
    },
    {
      "text": "8,",
      "start": 3.78,
      "end": 4.24
    },
    {
      "text": "somos",
      "start": 4.58,
      "end": 5.02
    },
    {
      "text": "cuatro",
      "start": 5.02,
      "end": 5.52
    },
    {
      "text": "personas",
      "start": 5.52,
      "end": 5.78
    },
    {
      "text": "y",
      "start": 5.78,
      "end": 6
    },
    {
      "text": "una",
      "start": 6,
      "end": 6.14
    },
    {
      "text": "de",
      "start": 6.14,
      "end": 6.38
    },
    {
      "text": "ellas",
      "start": 6.38,
      "end": 6.6
    },
    {
      "text": "es",
      "start": 6.7,
      "end": 6.96
    },
    {
      "text": "vegetariana,",
      "start": 6.96,
      "end": 7.78
    },
    {
      "text": "gracias.",
      "start": 8.22,
      "end": 8.44
    }
  ],
  "segments": [
    {
      "text": "Hola, te llamo para confirmar la reserva del viernes al 8, somos cuatro personas y una de ellas es vegetariana, gracias.",
      "start": 0.26,
      "end": 8.44
    }
  ]
}
```

5040 ms, $0.000153.

## Good for

- Transcribe voice notes and calls
- Subtitles with word timing
- Searchable podcast archives
- Voice input for forms and chat

## Limits and caveats

- A small model: noisy audio, heavy accents and crosstalk cost accuracy. Clean recordings do best.
- No speaker labels yet.
- Long silences can produce a repeated phrase; trim silence first if you can.
- `translate` gives the gist, not a polished translation.
