Amazon Polly Neural API

Turn text into natural-sounding speech. Useful for straightforward narration, explainers and news-style voiceovers.

Amazon · polly-neural

Text to speech

Turn text into natural-sounding speech. Useful for straightforward narration, explainers and news-style voiceovers.

Put a prompt and "model": "polly-neural" on an audio clip, and the render generates it and edits it into the video. To generate it on its own, send the same asset to the generate endpoint.

Built forStraightforward narration · Explainers · News-style reads

Amazon Polly Neural “Here's today's weather for Sydney: sunny, with a top of twenty-four.”
Technical specifications
InputScript text
OutputSpeech
LengthFollows the script
VoicesChoose a voice by name
StyleOptional newscaster style
{
  "asset": {
    "type": "audio",
    "prompt": "Here's today's weather for Sydney: sunny, with a top of twenty-four.",
    "model": "polly-neural",
    "options": {
      "voice": "Joanna"
    }
  }
}
Example request to the generate endpoint.

Options

OptionValuesDefault
voice (required)string
languagestring
newscasterboolean

Pricing

Generation is paid in credits from the same balance as rendering, at what the model's provider charges plus a small margin. See AI generation pricing.

ModeCharged perPrice changes withLength a quote assumes without one
Text to speechCharacter of the prompt, minimum 100Fixed rate—

Get a quote

POST /generate/quote takes the same body as the generate endpoint and returns what that generation would cost. Nothing is generated, reserved or charged.

curl -X POST \
     -H "Content-Type: application/json" \
     -H "x-api-key: $SHOTSTACK_API_KEY" \
     -d '{
       "asset": {
         "type": "audio",
         "prompt": "Here'\''s today'\''s weather for Sydney: sunny, with a top of twenty-four.",
         "model": "polly-neural",
         "options": {
           "voice": "Joanna"
         }
       }
     }' \
     https://api.shotstack.io/edit/stage/generate/quote

The response gives credits, the price of that request, and ceiling, which is true when the request has no length for a model charged by length, so the price is an estimate. Prices follow the providers, so ask again rather than storing one.

How it compares

Amazon Polly Neural beside the other models in Shotstack that make the same thing.

ModelBest forVoicesLanguagesExtra controlsCharged per
Amazon Polly NeuralStraightforward narration and news-style readsPolly voices by name—newscaster styleCharacter of the prompt, minimum 100
ElevenLabs Multilingual v2Consistent narration and localisation2129stability, similarity, styleCharacter of the prompt
ElevenLabs Turbo v2.5Low-latency speech2132stability, similarity, styleCharacter of the prompt
MiniMax Speech 2.8 HDA choice of voices across many languages1738—Character of the prompt

Questions

Do I need an account with the model provider?
No. Generation runs on your Shotstack API key and is paid in credits from the same balance as rendering, so there is no separate account to open and nothing extra to integrate.
Do I pay again for the same asset?
No. Every generated file is stored against your account. An asset with the same type, model, prompt, options and length as one generated before reuses the stored file at no charge.
What happens if a generation fails?
A failed generation isn't charged. If a render fails after some of its assets were generated, those assets are kept, and rendering again reuses them at no charge.
Can I generate an asset without rendering a video?
Yes. POST the asset to the generate endpoint and you get back a URL to the file, to check it before you render, to reuse it across many edits, or to use it outside Shotstack.

Start free

  • 10 free credits to start
  • No credit card required