Whisper 1 API reference

Convert a recording to text with word timings and longer segments for arranging subtitles.

Call Whisper 1 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.0001 USD per second of output
Model IDs: openai/whisper-1/speech-to-text

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/whisper-1/speech-to-text

Price

Option	USD
`Default`	$0.0001 per second of output

Parameters

Field	Type	Default	Allowed	What it does
`audio_url`Required	`string (uri)`	—	—	Recording to transcribe. Maximum file size is 25 MB and duration is two hours.
`language`Optional	`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.
`prompt`Optional	`string`	—	up to 2,048 characters	Spelling and brief context in the language of the recording.
`temperature`Optional	`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.

POST /api/v1/jobs/createTask

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/whisper-1/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.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"