Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.fliiq.ai/llms.txt

Use this file to discover all available pages before exploring further.

This example demonstrates Fliiq’s translation capability paired with text-to-speech — translate text and get native audio pronunciation delivered straight to Telegram.

​
The Setup

A user traveling to Hong Kong wanted to translate phrases on the go and hear how they should sound. They told Fliiq: 
"I need a translator I can message on Telegram. I'll send English phrases
and I want back the Cantonese translation with audio pronunciation."

​
How It Works

The user already had a Telegram bot set up. Through the real-time Telegram listener, they message Fliiq directly: 
User: How do I say "Where is the nearest MTR station?"
Fliiq translates the phrase, generates audio, and replies: 
🔄 English → Cantonese

最近嘅地鐵站喺邊度？
(zeoi3 gan6 ge3 dei6 tit3 zaam6 hai2 bin1 dou6?)

"Where is the nearest MTR station?"

💡 Tip: 地鐵 (dei6 tit3) specifically means MTR/subway.
Locals will understand and point you in the right direction.

🎧 Audio pronunciation attached below.
The audio file follows immediately — generated by text_to_speech with the Cantonese_GentleLady voice and sent via send_telegram_audio.

​
Multi-Language Support

The same pattern works across languages. The agent picks the right TTS voice based on the target language:

​
English → Mandarin

User: Translate "I'd like to check in" to Mandarin

🔄 English → Mandarin

我想办理入住
(wǒ xiǎng bànlǐ rùzhù)

"I'd like to check in."

🎧 Audio attached.

​
Cantonese → English

Translation works in both directions: 
User: What does 唔好意思 mean?

🔄 Cantonese → English

唔好意思 (m4 hou2 ji3 si1)

Means: "Sorry" / "Excuse me" (apologetic)

Used when you've inconvenienced someone — bumping into
them, being late, asking for a favor. More apologetic
than 唔該 which is transactional.

🎧 Cantonese pronunciation attached.

​
As a Scheduled Job

For systematic learning, set up a daily translation challenge: 
name: daily-translations
trigger:
  type: cron
  schedule: "0 13 * * *"
prompt: |
  Pick 5 useful travel phrases and translate them to Cantonese.
  Generate audio for each phrase. Send to Telegram as a daily
  translation drill. Read memory for previous phrases to avoid repeats.
skills:
  - memory_read
  - memory_write
  - text_to_speech
  - send_telegram
  - send_telegram_audio
  - get_current_time
delivery:
  type: telegram
  chat_id: "12345678"
enabled: true

​
Available Voices

The text_to_speech skill supports multiple voices for different languages and styles:
VoiceBest for
Cantonese_GentleLadyCantonese translations
female-shaonvMandarin — casual/conversational
male-qn-jingyingMandarin — formal/professional
See the full voice list in the Core Skills reference.

​
The Key Insight

Translation isn’t just text — pronunciation matters. By pairing the LLM’s translation ability with MiniMax text-to-speech and Telegram delivery, Fliiq becomes a pocket translator that you can hear. Send a message, get back a translation with audio you can play to a taxi driver, waiter, or shopkeeper. For languages like Cantonese where tones completely change meaning, hearing the correct pronunciation is essential — not optional.