StartSpeechSynthesisTask - Amazon Polly
Minta SintaksParameter Permintaan URIIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

StartSpeechSynthesisTask

Memungkinkan pembuatan tugas sintesis asinkron, dengan memulai yang baru. SpeechSynthesisTask Operasi ini memerlukan semua informasi standar yang diperlukan untuk sintesis ucapan, ditambah nama bucket Amazon S3 untuk layanan untuk menyimpan output tugas sintesis dan dua parameter opsional (OutputS3KeyPrefixdanSnsTopicArn). Setelah tugas sintesis dibuat, operasi ini akan mengembalikan SpeechSynthesisTask objek, yang akan mencakup pengidentifikasi tugas ini serta status saat ini. SpeechSynthesisTaskObjek tersedia selama 72 jam setelah memulai tugas sintesis asinkron.

Minta Sintaks

POST /v1/synthesisTasks HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "OutputS3BucketName": "string",
   "OutputS3KeyPrefix": "string",
   "SampleRate": "string",
   "SnsTopicArn": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

Engine

Menentukan mesin (standard,neural, long-form ataugenerative) untuk Amazon Polly untuk digunakan saat memproses teks input untuk sintesis ucapan. Menggunakan suara yang tidak didukung untuk mesin yang dipilih akan mengakibatkan kesalahan.

Jenis: String

Nilai yang Valid: standard | neural | long-form | generative

Wajib: Tidak

LanguageCode

Kode bahasa opsional untuk permintaan Sintesis Pidato. Ini hanya diperlukan jika menggunakan suara bilingual, seperti Aditi, yang dapat digunakan untuk bahasa Inggris India (En-in) atau Hindi (Hi-in).

Jika suara dwibahasa digunakan dan tidak ada kode bahasa yang ditentukan, Amazon Polly menggunakan bahasa default suara dwibahasa. Bahasa default untuk suara apa pun adalah yang dikembalikan oleh DescribeVoicesoperasi untuk LanguageCode parameter. Misalnya, jika tidak ada kode bahasa yang ditentukan, Aditi akan menggunakan bahasa Inggris India daripada bahasa Hindi.

Jenis: String

Nilai yang Valid: 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

Wajib: Tidak

LexiconNames

Daftar satu atau lebih nama leksikon pengucapan yang Anda inginkan untuk diterapkan layanan selama sintesis. Leksikon diterapkan hanya jika bahasa leksikon sama dengan bahasa suara.

Tipe: Array string

Anggota Array: Jumlah maksimum 5 item.

Pola: [0-9A-Za-z]{1,20}

Wajib: Tidak

OutputFormat

Format di mana output yang dikembalikan akan dikodekan. Untuk streaming audio, ini akan menjadi mp3, ogg_vorbis, atau pcm. Untuk tanda bicara, ini akan menjadi json.

Jenis: String

Nilai yang Valid: json | mp3 | ogg_vorbis | pcm

Wajib: Ya

OutputS3BucketName

Nama bucket Amazon S3 tempat file output akan disimpan.

Jenis: String

Pola: ^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$

Wajib: Ya

OutputS3KeyPrefix

Awalan kunci Amazon S3 untuk file ucapan keluaran.

Jenis: String

Pola: ^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$

Wajib: Tidak

SampleRate

Frekuensi audio yang ditentukan dalam Hz.

Nilai yang valid untuk mp3 dan ogg_vorbis adalah “8000", “16000", “22050", dan “24000". Nilai default untuk suara standar adalah “22050". Nilai default untuk suara saraf adalah “24000". Nilai default untuk suara bentuk panjang adalah “24000". Nilai default untuk suara generatif adalah “24000".

Nilai yang valid untuk pcm adalah “8000" dan “16000" Nilai default adalah “16000".

Tipe: String

Wajib: Tidak

SnsTopicArn

ARN untuk topik SNS secara opsional digunakan untuk memberikan pemberitahuan status untuk tugas sintesis ucapan.

Jenis: String

Pola: ^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$

Wajib: Tidak

SpeechMarkTypes

Jenis tanda bicara yang dikembalikan untuk teks input.

Tipe: Array string

Anggota Array: Jumlah maksimum 4 item.

Nilai yang Valid: sentence | ssml | viseme | word

Wajib: Tidak

Text

Teks masukan untuk mensintesis. Jika Anda menentukan ssml sebagai TextType, ikuti format SSML untuk teks input.

Tipe: String

Diperlukan: Ya

TextType

Menentukan apakah teks input adalah teks biasa atau SSML. Nilai defaultnya adalah teks biasa.

Jenis: String

Nilai yang Valid: ssml | text

Wajib: Tidak

VoiceId

ID suara untuk digunakan untuk sintesis.

Jenis: String

Nilai yang Valid: 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

Wajib: Ya

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

SynthesisTask

SynthesisTask objek yang memberikan informasi dan atribut tentang tugas sintesis ucapan yang baru dikirimkan.

Tipe: Objek SynthesisTask

Kesalahan

EngineNotSupportedException

Mesin ini tidak kompatibel dengan suara yang Anda tunjuk. Pilih suara baru yang kompatibel dengan mesin atau ganti mesin dan nyalakan kembali operasi.

Kode Status HTTP: 400

InvalidS3BucketException

Nama bucket Amazon S3 yang disediakan tidak valid. Silakan periksa masukan Anda dengan persyaratan penamaan bucket S3 dan coba lagi.

Kode Status HTTP: 400

InvalidS3KeyException

Awalan key Amazon S3 yang disediakan tidak valid. Harap berikan nama kunci objek S3 yang valid.

Kode Status HTTP: 400

InvalidSampleRateException

Tingkat sampel yang ditentukan tidak valid.

Kode Status HTTP: 400

InvalidSnsTopicArnException

Topik SNS yang disediakan ARN tidak valid. Harap berikan ARN topik SNS yang valid dan coba lagi.

Kode Status HTTP: 400

InvalidSsmlException

SSML yang Anda berikan tidak valid. Verifikasi sintaks SSML, ejaan tag dan nilai, lalu coba lagi.

Kode Status HTTP: 400

LanguageNotSupportedException

Bahasa yang ditentukan saat ini tidak didukung oleh Amazon Polly dalam kapasitas ini.

Kode Status HTTP: 400

LexiconNotFoundException

Amazon Polly tidak dapat menemukan leksikon yang ditentukan. Ini bisa disebabkan oleh leksikon yang hilang, namanya salah eja atau menentukan leksikon yang ada di wilayah berbeda.

Verifikasi bahwa leksikon ada, ada di wilayah (lihatListLexicons) dan Anda mengeja namanya dieja dengan benar. Kemudian coba lagi.

Kode Status HTTP: 404

MarksNotSupportedForFormatException

Tanda ucapan tidak didukung untuk yang OutputFormat dipilih. Tanda ucapan hanya tersedia untuk konten dalam json format.

Kode Status HTTP: 400

ServiceFailureException

Kondisi yang tidak diketahui telah menyebabkan kegagalan layanan.

Kode Status HTTP: 500

SsmlMarksNotSupportedForTextTypeException

Tanda ucapan SSML tidak didukung untuk input tipe teks biasa.

Kode Status HTTP: 400

TextLengthExceededException

Nilai parameter “Teks” lebih panjang dari batas yang diterima. Untuk SynthesizeSpeech API, batas untuk teks input adalah maksimum 6000 karakter total, yang tidak lebih dari 3000 karakter dapat ditagih. Untuk StartSpeechSynthesisTask API, maksimum adalah 200.000 karakter, yang tidak lebih dari 100.000 karakter dapat ditagih. Tag SSML tidak dihitung sebagai karakter yang ditagih.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: