Many African languages are tonal (i.e. there is a specific way to pronounce them properly). In writing, this is indicated by certain marks which can help the reader (human or AI) to properly pronounce such text. We have built this endpoint with model support for African languages.

​
Request

The tone_mark() function can be used to add tone marks to a sentence. Examples are provided below as a guide for you.

​
Best Practices for Use

When tone marking a sentence, you should use the language code (e.g. yo, ig) and not the full text.

​
Response

The response for speech generation is in bytes.
  • The Content-Type is application/json
  • A request_id is returned for issue resolution with our support team.
Below is an example of a response from the API 
{
  "request_id": "'86095cea-77d5-45ba-a093-0f800ac2c7df'",
  "text": "Báwo ni olólùfẹ́ mi?"
}

​
Language Support

The speech generation model supports the following languages:
  • Yoruba: yo
Support for Igbo is coming soon. More info on languages can be found on the Languages page

​
Examples

Python
import os
from spitch import Spitch

os.environ["SPITCH_API_KEY"] = "YOUR_API_KEY"
client = Spitch()
response = client.text.tone_mark(
    language="yo",
    text="Bawo ni ololufe mi?"
)
print(response.text)   # Báwo ni olólùfẹ́ mi?