PopNowAPI Docs
Main content

TTS-1 HD API reference

TTS-1 HD turns finished copy into quality-focused narration, with preset voices and selectable compressed or uncompressed audio.

Call TTS-1 HD 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.006 USD per 1,000 characters

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.

Text to Speech

openai/tts-1-hd/text-to-speech

Price

OptionUSD
Default$0.006 per 1,000 characters

Parameters

FieldTypeDefaultAllowedWhat it does
textRequiredstring—up to 4,096 charactersWords to be spoken; spaces and punctuation count as characters.
voice_idOptionalstringalloyalloy, ash, coral, echo, fable, onyx, nova, sage, shimmerBuilt-in voice for this Speech model.
speedOptionalnumber10.25 to 4Speaking speed multiplier.
output_formatOptionalstringmp3mp3, opus, aac, flac, wav, pcmAudio file encoding; pcm is raw 24 kHz 16-bit little-endian audio.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

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/tts-1-hd/text-to-speech",
  "input": {
    "text": "Hi there! This voice was created with the PopNow API in just a few seconds."
  }
}'

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"

Next steps

On this page