Zum Inhalt springen
DeutschlandGPT

Create transcription

Transcribes audio into text. Compatible with the OpenAI /v1/audio/transcriptions API.

Accepts an audio file (max 25 MB) as multipart/form-data and returns the transcript in the requested response_format. Available models include the EU-hosted Voxtral default and ElevenLabs Scribe (scribe_v2, scribe_v1) — swap the model string. The diarize, num_speakers, timestamps_granularity, tag_audio_events, and temperature fields are ElevenLabs Scribe options (ignored by Voxtral). Speaker segments and word timestamps are returned only when you request response_format=verbose_json with an ElevenLabs Scribe model: diarize=true adds a segments array (grouped by speaker) and timestamps_granularity (word/character) adds a words array. The json/text formats always return the plain transcript. Subtitle formats such as srt and vtt are not supported. Use /v2/models/all to discover audio transcription models.

POSThttps://api.deutschlandgpt.de/v2/audio/transcriptionsTry it

Example request

curl https://api.deutschlandgpt.de/v2/audio/transcriptions \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY"

Response

200application/json
{
  "text": "string"
}

Transcription result. The media type depends on response_format.

Also available as text/plain

The response takes one of the following shapes:

Variant 1

Returned when response_format is json (default).

textstringrequired

The transcribed text.

Variant 2

Returned when response_format is verbose_json. words and segments appear only on the ElevenLabs Scribe path.

textstringrequired

The transcribed text.

wordsobject[]optional

Word-level timestamps. Present only on the ElevenLabs Scribe path when timestamps_granularity is word or character (omitted for none).

wordstringrequired

The transcribed word or sound.

startnumberoptional

Start time of the token in seconds.

endnumberoptional

End time of the token in seconds.

typestringrequired

Token type. audio_event marks non-speech sounds such as laughter (see tag_audio_events).

speakerstringoptional

Identifier of the speaker of this token. Present only when diarize=true.

segmentsobject[]optional

Transcript grouped into consecutive runs by speaker. Present only on the ElevenLabs Scribe path when diarize=true.

speakerstringoptional

Identifier of the speaker for this segment.

textstringrequired

The text spoken in this segment.

startnumberoptional

Start time of the segment in seconds.

endnumberoptional

End time of the segment in seconds.

usageobjectrequired
audioSecondsnumberrequired

Duration of the input audio in seconds, as reported by the provider.

costInEuronumberrequired

Amount deducted from the workspace credit balance for this request, in EUR.

Response headers
X-Request-IDstring

Unique request identifier (req_<id>). Include in support tickets.

Response codes

200

Transcription result. The media type depends on response_format.

object | object
400

Invalid request — missing file, file exceeds 25 MB, or provider error.

Error
401

Unauthorized — missing or invalid API key.

402

Insufficient credits.

403

API key lacks permission for this model.

404

Model not found or not configured for this workspace.

500

Server error.

Was this page helpful?