===========
Basic guide
===========

This is the most basic guide to using ``POST /api/speak`` to send a speech synthesis request and receive results.

There are two ways to use typecast voice synthesis api.  |br|
First, **polling** is used to make periodic requests to the typecast server to retrieve whether speech synthesis is complete.  |br|
Second, **webhook** is used to receive a message from the typecast server when speech synthesis is complete.  

In general, polling is easy to implement, so if you don't need to receive synthesized speech right away, it's a good choice.  |br|
On the other hand, if you need to receive the synthesized speech as soon as possible, webhooks are better.


.. toctree::
   :maxdepth: 3

   polling
   webhook
   synchronous


.. |br| raw:: html

      <br>