GPT Transcribe API reference
Two ways to transcribe speech
Call GPT Transcribe from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in USD, and a request you can paste into a terminal.
At a glance
- Made by
- OpenAI
- Output
- Audio
- From
- $0.000015 USD per second of output
Prices are in USD, charged to your separate API wallet. A task reserves the maximum possible charge when accepted and settles actual usage on completion; any remainder is released. Failed tasks are not charged. Call POST /api/v1/jobs/quote for an exact quote before running.
Speech to Text
openai/gpt-transcribe/speech-to-text
Price
| Option | USD |
|---|---|
Default | $0.000075 per second of output |
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
audio_urlRequired | string (uri) | — | — | Recording to transcribe. Maximum file size is 25 MB and duration is two hours. |
languageOptional | string | — | aa, ab, ae, af, ak, am, an, ar, as, av, ay, az, ba, be, … (+170) · up to 2 characters | Two-letter spoken language code. |
promptOptional | string | — | up to 2,048 characters | Spelling and brief context in the language of the recording. |
language_hintsOptional | array<object> | — | up to 10 items | Likely spoken language codes, one per row. |
keytermsOptional | array<object> | — | up to 100 items | Names and technical vocabulary to recognize, one term per row. |
temperatureOptional | number | — | 0 to 1 | Sampling temperature for recognizing the recording. |
Example request
This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.
The example uses PopNow sample files in audio_url. Replace them with your own public HTTPS links, uploads or saved assets.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "openai/gpt-transcribe/speech-to-text",
"input": {
"prompt": "A bright, cheerful scene with soft natural light",
"audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3"
}
}'The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Realtime Transcription
openai/gpt-transcribe/realtime-transcription
Price
| Option | USD |
|---|---|
Default | $0.000015 per second of output |
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
audio_urlOptional | string (uri) | — | — | Short WAV required for a single task. Live sessions instead send raw samples over the transcription WebSocket. |
max_audio_secondsOptional | integer | 15 | 1 to 60 | Maximum admitted length of each audio segment; commit earlier at a complete phrase. |
promptOptional | string | — | up to 2,048 characters | Background context for speech recognition, rather than an instruction to answer or summarize. |
language_hintsOptional | array<object> | — | up to 10 items | Likely spoken language codes, one per row. |
keytermsOptional | array<object> | — | up to 100 items | Names and technical vocabulary to recognize, one term per row. |
audio_input_formatOptional | string | pcm | pcm, g711_ulaw, g711_alaw | Encoding of live microphone samples; PCM is 24 kHz mono 16-bit, G.711 is 8 kHz. |
audio_noise_reductionOptional | string | near_field | near_field, far_field, none | Input denoising profile for a close microphone, room microphone, or preprocessed audio. |
realtime_sessionOptional | object | — | — | Advanced native session configuration; overlapping regular controls must agree. Function tools are executed by your application. |
Example request
This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "openai/gpt-transcribe/realtime-transcription",
"input": {
"prompt": "A bright, cheerful scene with soft natural light",
"max_audio_seconds": 15
}
}'The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"