Query the Maïka API server for African-language financial text and signed audio.
curl -X POST https://maika.hmtc.bj/api/compose \
-H "Content-Type: application/json" \
-d '{"lang":"fon","amount":7500}'curl -X POST https://maika.hmtc.bj/api/compose \
-H "Content-Type: application/json" \
-d '{"lang":"fon","amount":7500}'
# Then download the signed audio_url returned by /api/compose:
curl -L "<audio_url>" -o maika-fon-7500.wav| Response | audio/wav |
| Access | Requires the temporary signed URL returned by the compose endpoint. |
| Expiry | Audio URLs are short-lived and should not be cached. |
| Field | Type | Required | Description |
|---|---|---|---|
| lang | string | ✓ | Language code (fon, swa, yor…) |
| amount | number | ✓ | Amount as a JSON number, not a string |
| Field | Type | Description |
|---|---|---|
| lang | string | Language code echoed back |
| amount | number | Amount echoed back |
| text | string | Human-readable result |
| currency | string | Currency for this language (FCFA, USD…) |
| name | string | Language name |
| region | string | Geographic region |
| live | boolean | true if audio WAV files are available |
| audio_url | string|null | Temporary signed URL for inline WAV playback when audio is available |
| HTTP | Reason |
|---|---|
| 400 | Missing lang or amount — or amount is not a number |
| 401 | Missing, expired, or invalid audio signature |
| 404 | Unknown language code |
| 405 | Method not allowed — use POST |
| 422 | Amount out of range for this language |
| 429 | Rate limit exceeded |
| 500 | Internal composition error |
| Code | Language | Min | Max | Audio |
|---|---|---|---|---|
| fon | Fongbé | 0 | 999,999,999 | live |
| gun | Goungbé | 0 | 999,999,999 | live |
| min | Mina | 0 | 9,999,999 | live |
| adj | Adja | 0 | 999,999,999 | live |
| den | Dendi | 0 | 999,999,999 | live |
| yor | Yorùbá | 0 | 999,999,999,999 | live |
| amh | አማርኛ | 0 | 999,999,999 | live |
| oro | Afaan Oromo | 0 | 999,999,999 | live |
| ara | Arabic | 0 | 999,999,999 | live |
| eng | English | 0 | 999,999,999 | live |
| fre | Français | 0 | 999,999,999 | live |
| hau | Haoussa | 0 | 999,999,999 | live |
| swa | Kiswahili | 0 | 999,999,999 | live |
| bam | Bamanankan | 0 | 999,999,999 | live |
| ful | Fulfulde | 0 | 999,999,999 | live |
| dio | Dioula | 0 | 9,999,999,999,999 | text only |
| kri | Kriolu | 0 | 9,999,999,999,999 | text only |
| lin | Lingala | 0 | 9,999,999,999,999 | text only |
| wol | Wolof | 0 | 999,999,999 | text only |
| Code | Language | Region | Audio |
|---|---|---|---|
| fon | Fongbé | Bénin | 🔊 live |
| gun | Goungbé | Bénin | 🔊 live |
| min | Mina | Bénin / Togo | 🔊 live |
| adj | Adja | Bénin | 🔊 live |
| den | Dendi | Bénin | 🔊 live |
| yor | Yorùbá | Nigeria / Bénin | 🔊 live |
| amh | አማርኛ | Éthiopie | 🔊 live |
| oro | Afaan Oromo | Éthiopie | 🔊 live |
| ara | Arabic | Afrique du Nord | 🔊 live |
| eng | English | International | 🔊 live |
| fre | Français | International | 🔊 live |
| hau | Haoussa | Afrique de l'Ouest | 🔊 live |
| swa | Kiswahili | Afrique de l'Est | 🔊 live |
| bam | Bamanankan | Mali | 🔊 live |
| ful | Fulfulde | Sahel | 🔊 live |
| dio | Dioula | Mali / Côte d'Ivoire | 📝 text |
| kri | Kriolu | Cabo Verde | 📝 text |
| lin | Lingala | RDC / Congo | 📝 text |
| wol | Wolof | Sénégal | 📝 text |