Amazon Polly Polly Operations API
The Polly Operations API from Amazon Polly — 1 operation(s) for polly operations.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-polly:amazon-polly-operations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.1.0
info:
title: Amazon Polly Operations API
version: '2016-06-10'
description: Generated from AWS's published Smithy model for Amazon Polly. 1 operation(s).
contact:
name: Amazon Web Services
url: https://aws.amazon.com/contact-us/
license:
name: Apache 2.0
identifier: Apache-2.0
url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://polly.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
paths:
/v1/synthesisStream:
post:
operationId: StartSpeechSynthesisStream
summary: Start Speech Synthesis Stream
description: 'Synthesizes UTF-8 input, plain text, or SSML over a bidirectional streaming connection. Specify synthesis
parameters in HTTP/2 headers, send text incrementally as events on the input stream, and receive synthesized audio
as it becomes available. This operation serves as a bidirectional counterpart to SynthesizeSpeech: SynthesizeSpeech'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/StartSpeechSynthesisStreamOutput'
'500':
description: ServiceFailureException
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceFailureException'
'402':
description: ServiceQuotaExceededException
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceQuotaExceededException'
'400':
description: ThrottlingException; ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/StartSpeechSynthesisStreamInput'
tags:
- Operations
components:
securitySchemes:
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical
request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: polly
schemas:
AudioEvent:
type: object
properties:
AudioChunk:
type: string
format: byte
description: A chunk of synthesized audio data encoded in the format specified by the OutputFormat parameter.
CloseStreamEvent:
type: object
properties: {}
FlushStreamConfiguration:
type: object
properties:
Force:
type: boolean
description: Specifies whether to force the synthesis engine to immediately write buffered audio data to the output
stream.
ServiceFailureException:
type: object
properties:
message:
type: string
ServiceQuotaExceededException:
type: object
properties:
message:
type: string
quotaCode:
type: string
enum:
- input-stream-inbound-event-timeout
- input-stream-timeout
description: The quota code identifying the specific quota.
serviceCode:
type: string
enum:
- polly
description: The service code identifying the originating service.
required:
- message
- quotaCode
- serviceCode
StartSpeechSynthesisStreamActionStream:
type: object
properties:
TextEvent:
$ref: '#/components/schemas/TextEvent'
CloseStreamEvent:
$ref: '#/components/schemas/CloseStreamEvent'
description: Exactly one member is set.
StartSpeechSynthesisStreamEventStream:
type: object
properties:
AudioEvent:
$ref: '#/components/schemas/AudioEvent'
StreamClosedEvent:
$ref: '#/components/schemas/StreamClosedEvent'
ValidationException:
$ref: '#/components/schemas/ValidationException'
ServiceQuotaExceededException:
$ref: '#/components/schemas/ServiceQuotaExceededException'
ServiceFailureException:
$ref: '#/components/schemas/ServiceFailureException'
ThrottlingException:
$ref: '#/components/schemas/ThrottlingException'
description: Exactly one member is set.
StartSpeechSynthesisStreamInput:
type: object
properties:
Engine:
type: string
enum:
- standard
- neural
- long-form
- generative
description: Specifies the engine for Amazon Polly to use when processing input text for speech synthesis. Currently,
only the generative engine is supported. If you specify a voice that the selected engine doesn't support, Amazon
Polly returns an error.
LanguageCode:
type: string
enum:
- arb
- cmn-CN
- cy-GB
- da-DK
- de-DE
- en-AU
- en-GB
- en-GB-WLS
- en-IN
- en-US
- es-ES
- es-MX
- es-US
- fr-CA
- fr-FR
- is-IS
- it-IT
- ja-JP
- hi-IN
- ko-KR
- nb-NO
- nl-NL
- pl-PL
- pt-BR
- pt-PT
- ro-RO
- ru-RU
- sv-SE
- tr-TR
- en-NZ
- en-ZA
- ca-ES
- de-AT
- yue-CN
- ar-AE
- fi-FI
- en-IE
- nl-BE
- fr-BE
- cs-CZ
- de-CH
- en-SG
description: An optional parameter that sets the language code for the speech synthesis request. Specify this parameter
only when using a bilingual voice. If a bilingual voice is used and no language code is specified, Amazon Polly
uses the default language of the bilingual voice.
LexiconNames:
type: array
items:
type: string
description: The names of one or more pronunciation lexicons for the service to apply during synthesis. Amazon Polly
applies lexicons only when the lexicon language matches the voice language.
OutputFormat:
type: string
enum:
- json
- mp3
- ogg_opus
- ogg_vorbis
- pcm
- mulaw
- alaw
description: The audio format for the synthesized speech. Currently, Amazon Polly does not support JSON speech marks.
SampleRate:
type: string
description: The audio frequency, specified in Hz.
VoiceId:
type: string
enum:
- Aditi
- Amy
- Astrid
- Bianca
- Brian
- Camila
- Carla
- Carmen
- Celine
- Chantal
- Conchita
- Cristiano
- Dora
- Emma
- Enrique
- Ewa
- Filiz
- Gabrielle
- Geraint
- Giorgio
- Gwyneth
- Hans
- Ines
- Ivy
- Jacek
- Jan
- Joanna
- Joey
- Justin
- Karl
- Kendra
- Kevin
- Kimberly
- Lea
- Liv
- Lotte
- Lucia
- Lupe
- Mads
- Maja
- Marlene
- Mathieu
- Matthew
- Maxim
- Mia
- Miguel
- Mizuki
- Naja
- Nicole
- Olivia
- Penelope
- Raveena
- Ricardo
- Ruben
- Russell
- Salli
- Seoyeon
- Takumi
- Tatyana
- Vicki
- Vitoria
- Zeina
- Zhiyu
- Aria
- Ayanda
- Arlet
- Hannah
- Arthur
- Daniel
- Liam
- Pedro
- Kajal
- Hiujin
- Laura
- Elin
- Ida
- Suvi
- Ola
- Hala
- Andres
- Sergio
- Remi
- Adriano
- Thiago
- Ruth
- Stephen
- Kazuha
- Tomoko
- Niamh
- Sofie
- Lisa
- Isabelle
- Zayd
- Danielle
- Gregory
- Burcu
- Jitka
- Sabrina
- Jasmine
- Jihye
- Ambre
- Beatrice
- Florian
- Lennart
- Lorenzo
- Tiffany
- Arjun
- Carlos
- Carolina
- Curtis
- Hyunduk
- Kenneth
- Kiara
- Leo
- Nate
- Tina
description: The voice to use in synthesis. To get a list of available voice IDs, use the DescribeVoices operation.
ActionStream:
$ref: '#/components/schemas/StartSpeechSynthesisStreamActionStream'
required:
- Engine
- OutputFormat
- VoiceId
StartSpeechSynthesisStreamOutput:
type: object
properties:
EventStream:
$ref: '#/components/schemas/StartSpeechSynthesisStreamEventStream'
StreamClosedEvent:
type: object
properties:
RequestCharacters:
type: integer
description: The total number of characters synthesized during the streaming session.
TextEvent:
type: object
properties:
Text:
type: string
description: The text content to synthesize. If you specify ssml as the TextType, follow the SSML format for the
input text.
TextType:
type: string
enum:
- ssml
- text
description: 'Specifies whether the input text is plain text or SSML. Default: plain text.'
FlushStreamConfiguration:
$ref: '#/components/schemas/FlushStreamConfiguration'
required:
- Text
ThrottlingException:
type: object
properties:
message:
type: string
throttlingReasons:
type: array
items:
$ref: '#/components/schemas/ThrottlingReason'
description: A list of reasons explaining why the request was throttled.
ThrottlingReason:
type: object
properties:
reason:
type: string
description: The reason code explaining why the request was throttled.
resource:
type: string
description: The resource that caused the throttling.
ValidationException:
type: object
properties:
message:
type: string
reason:
type: string
enum:
- unsupportedOperation
- fieldValidationFailed
- other
- invalidInboundEvent
description: The reason the request failed validation.
fields:
type: array
items:
$ref: '#/components/schemas/ValidationExceptionField'
description: The fields that caused the validation error.
required:
- message
- reason
ValidationExceptionField:
type: object
properties:
name:
type: string
description: The name of the field that failed validation.
message:
type: string
description: A message describing why the field failed validation.
required:
- name
- message
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/polly/service/2016-06-10/polly-2016-06-10.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)