Spiral gives your agent every tool with one account. Browse the tools →

Codex · AudioReleased 2026-11-09

How to Use Scribe v3 in Codex

Scribe v3 turns recorded meetings, interviews, and videos into transcripts with speaker labels and word timestamps. Compared with Scribe v2, it improves transcription accuracy and speaker labeling.

Prompts to try with Scribe v3 in Codex

Copy an example into Codex, or ask in your own words.

Use Scribe v3 to transcribe recordings/product-review.mp4 with speaker labels. Compare the requested changes with the project files and draft an issue for each request, including its timestamp.

Scribe v3Codex
Try asking
  • Use Scribe v3 to transcribe recordings/demo.wav in English. Compare the spoken walkthrough with README.md and propose documentation corrections with supporting timestamps.

  • Use Scribe v3 to transcribe recordings/customer-interview.mp3 with two expected speakers. Draft product feedback notes and keep customer quotes separate from your interpretation.

  • Use Scribe v3 to transcribe recordings/tutorial.mp4. Use the word timestamps to draft captions and save them as captions/tutorial.srt.

  • Use Scribe v3 to transcribe recordings/architecture-review.wav with speaker labels. Compare the discussion with docs/architecture.md and draft updates supported by transcript timestamps.

How to set up Scribe v3 in Codex

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the hosted server
    codex mcp add spiral --url https://api.spiral.ai/mcp
  2. Sign in

    Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.

    codex mcp login spiral

Use the Spiral skill

  1. Send Codex this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Scribe v3

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "elevenlabs",
        "model": "scribe_v3",
        "input": {
          "file": "<file>"
        }
      }'

Then paste one of the prompts above: Codex finds Scribe v3 on Spiral, shows the price and runs it.

Scribe v3 providers and prices

Spiral runs Scribe v3 through ElevenLabs. Open a card for today's price, with every fee included.

ElevenLabsAudio
Scribe v3
scribe_v3

Settings you can ask for

Scribe v3 works from your file and source URL. Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seed0 to 2147483647

If specified, our system will make a best effort to sample deterministically, such that repeated requests with the same seed and parameters should return the same result. Determinism is not guaranteed. Must be an integer between 0 and 2147483647.

Diarizeon or offoff

Whether to annotate which speaker is currently talking in the uploaded file.

File formatpcm_s16le_16 or otherother

The format of input audio. Options are 'pcm_s16le_16' or 'other' For pcm_s16le_16, the input audio must be 16-bit PCM at a 16kHz sample rate, single channel (mono), and little-endian byte order. Latency will be lower than with passing an encoded waveform.

No verbatimon or offoff

If true, the transcription will not have any filler words, false starts and non-speech sounds. Only supported with scribe_v2 model.

Temperature0 to 2

Controls the randomness of the transcription output. Accepts values between 0.0 and 2.0, where higher values result in more diverse and less deterministic results. If omitted, we will use a temperature based on the model you selected which is usually 0.

Number of speakers1 to 32

The maximum amount of speakers talking in the uploaded file. Can help with predicting who speaks when. The maximum amount of speakers that can be predicted is 32. Defaults to null, in this case the amount of speakers is set to the maximum value the model supports.

Tag audio eventson or offon

Whether to tag audio events like (laughter), (footsteps), etc. in the transcription.

Use multi channelon or offoff

Whether the audio file contains multiple channels where each channel contains a single speaker. When enabled, each channel is transcribed independently. By default a separate transcript is returned per channel; set multichannel_output_style='combined' to instead receive a single transcript with all channels merged and sorted by time. Each word in the response includes a 'channel_index' field indicating which channel it was spoken on. A maximum of 5 channels is supported. Each channel is billed independently at the full audio duration, so cost scales linearly with the number of channels.

Detect speaker roleson or offoff

Whether to detect speaker roles (agent vs customer). Requires diarize=true. Cannot be used with use_multi_channel=true. When enabled, speaker_id values will be 'agent' and 'customer' instead of 'speaker_0', 'speaker_1', etc. Usage incurs an additional 10% surcharge on base transcription cost.

Diarization threshold0.1 to 0.4

Diarization threshold to apply during speaker diarization. A higher value means there will be a lower chance of one speaker being diarized as two different speakers but also a higher chance of two different speakers being diarized as one speaker (less total speakers predicted). A low value means there will be a higher chance of one speaker being diarized as two different speakers but also a lower chance of two different speakers being diarized as one speaker (more total speakers predicted). Can only be set when diarize=True and num_speakers=None. Defaults to None, in which case we will choose a threshold based on the model_id (0.22 usually).

Timestamps granularitynone, word, or characterword

The granularity of the timestamps in the transcription. 'word' provides word-level timestamps and 'character' provides character-level timestamps per word.

Multichannel output styleseparate or combinedseparate

Controls the response shape when use_multi_channel is enabled. 'separate' (default) returns one transcript per channel under 'transcripts'. 'combined' merges all channels into a single transcript whose words are sorted by start time, each carrying a 'channel_index' - matching the single-channel response shape. 'combined' requires timestamps (timestamps_granularity must not be 'none') and does not support entity detection or redaction.

Every API field of Scribe v3 is on its tool page: open its card above.

What can you do with Scribe v3 in Codex?

Turn recorded product discussions into timestamped evidence for implementation work. A coding agent can compare Scribe v3 transcripts with project files and draft issues or documentation from what was said.

Meeting decisions with supporting timestamps

Transcribe a recorded meeting with Scribe v3, then have your agent extract decisions and link each one to the relevant passage.

Interview quote selection

Use Scribe v3 to separate interviewer and guest speech. Ask your agent to collect candidate quotes with timestamps for review against the recording.

Podcast editing notes

Transcribe an episode with Scribe v3, then have your agent identify topic changes and passages to review during editing.

Video caption drafts

Use Scribe v3 word timestamps as the basis for caption timing. Have your agent divide the transcript into readable caption lines.

Lecture study notes

Transcribe a recorded lecture with Scribe v3. Ask your agent to organize the transcript into topics, definitions, and questions for review.

Support call review

Use Scribe v3 speaker labels to distinguish turns in recorded calls. Have your agent extract the reported problem, proposed resolution, and supporting timestamps.

Searchable voice notes

Turn recorded voice notes into text with Scribe v3, then ask your agent to add concise titles and topic labels.

Sound cues for accessible transcripts

Keep Scribe v3 audio event tags when laughter, applause, or music helps explain a recording. Have your agent preserve those cues in the transcript draft.

Questions about Scribe v3 in Codex

Can Codex use Scribe v3?

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Scribe v3 like any built-in tool.

How much does Scribe v3 cost in Codex?

$0.004335 per run at the default inputs for 60 seconds of input. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

Do I need an ElevenLabs account to use Scribe v3 in Codex?

No. Spiral runs Scribe v3 on its own ElevenLabs account. You sign in to Spiral once and never paste a key.

How long does it take to set up Scribe v3 in Codex?

About two minutes: add the hosted server, then sign in.

Does Codex wait while Scribe v3 runs?

Scribe v3 runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

What is Scribe v3 best used for?

Use Scribe v3 to transcribe recorded conversations, including meetings and interviews. Speaker labels and word timestamps help an agent turn the transcript into notes or locate passages in the recording.

How does Scribe v3 improve on Scribe v2?

ElevenLabs reports 27% lower word error rate across 102 languages on FLEURS, plus improved speaker labeling. Treat the benchmark as a comparison, then evaluate recordings that resemble your actual work.

Does Scribe v3 translate speech into English?

Scribe v3 transcribes speech in the language spoken. Ask your agent to translate the finished transcript as a separate step.

Can Scribe v3 distinguish several speakers?

Yes, Scribe v3 supports speaker labels for up to 32 speakers. Supplying the expected speaker count can help with predicting who speaks when.

How long can a recording be?

Scribe supports recordings up to 15 hours long. Split longer recordings into shorter sections before transcription.

Get started

Start using Scribe v3 in Codex

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Codex:

Set up Codex

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options