Speech infrastructure · v1

Build on Africa's
linguistic engine.

Translation · Transcription · Voice — 70+ dialects

Translation, dialect-native voice synthesis, voice cloning and conversation for Mina, Fon, Goun and 70+ underrepresented dialects — powered by models trained on community-validated data.

Quickstart

curl -X POST https://gateway.godai.africa/v1/translate \  -H "x-api-key: godai_live_…" \  -d '{"text":"bonjour","target_lang":"mina"}'

Quickstart

Start building with your API key

Create an account, generate a key, ship your first request in about a minute.

1

Sign in to GodAI — your account is your console.

2

Pick a plan and generate your key — it goes live the moment your subscription is confirmed.

3

Set your base URL to https://gateway.godai.africa and call /v1/translate.

Endpoints

Translate it, speak it, chat with it.

POST/v1/translate1 cr / 100 chars

Dialect-aware translation powered by GodAI's fine-tuned NLLB. Supports Mina, Fon, Goun and 70+ African dialects ↔ French / English / and more.

All requests need x-api-key · Responses carry X-GodAI-Credits-Remaining · Read-only keys can only call GET endpoints.

curl -X POST https://gateway.godai.africa/v1/translate \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -d '{"text":"bonjour","source_lang":"french","target_lang":"mina"}'

Response

{ "translation": "m'do gbe", "model": "v5", "credits_charged": 1 }
GET/v1/lookup1 cr / request

Search the GodAI linguistic corpus — validated dictionary entries, proverbs and cultural expressions across all dialects.

All requests need x-api-key · Responses carry X-GodAI-Credits-Remaining · Read-only keys can only call GET endpoints.

curl "https://gateway.godai.africa/v1/lookup?q=bonjour&limit=5" \
  -H "x-api-key: YOUR_KEY"

Response

{ "query": "bonjour", "count": 2, "results": [ … ] }
GET/v1/dialects1 cr / request

List every supported dialect — language code, region, country and flag.

All requests need x-api-key · Responses carry X-GodAI-Credits-Remaining · Read-only keys can only call GET endpoints.

curl "https://gateway.godai.africa/v1/dialects" -H "x-api-key: YOUR_KEY"

Response

{ "dialects": [ { "id": 2, "name": "Mina", "iso639": "gej", "bcp47": "gej-TG", "country": "Togo", "flag": "🇹🇬" }, … ] }
POST/v1/speak1 cr / 100 chars

Native dialect text-to-speech — Mina, Goun, Fon and more. Returns raw audio/wav spoken by GodAI's dialect voices.

All requests need x-api-key · Responses carry X-GodAI-Credits-Remaining · Read-only keys can only call GET endpoints.

curl -X POST https://gateway.godai.africa/v1/speak \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -d '{"text":"akpe na wò","dialect_id":2}' \
  --output mina.wav

Response

→ audio/wav stream · X-Is-Finetuned: true
POST/v1/speak/euro1 cr / 100 chars

French & English text-to-speech with voice cloning — pass a speaker's reference_audio_url (e.g. their dialect contribution clip) to render FR/EN speech in THEIR voice, or omit it for the default voice.

All requests need x-api-key · Responses carry X-GodAI-Credits-Remaining · Read-only keys can only call GET endpoints.

curl -X POST https://gateway.godai.africa/v1/speak/euro \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -d '{"text":"bonjour le monde","language":"french",\n       "reference_audio_url":"https://…/clip.wav"}' \
  --output voice.wav

Response

→ audio/wav stream · X-Used-Voice-Clone: true
POST/v1/chat25 cr / request

Conversational GodAI — OpenAI-style messages, answers grounded in the dialect corpus. Streams SSE deltas by default; set stream:false for a single JSON reply.

All requests need x-api-key · Responses carry X-GodAI-Credits-Remaining · Read-only keys can only call GET endpoints.

curl -X POST https://gateway.godai.africa/v1/chat \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -d '{"messages":[{"role":"user","content":"Explique ce proverbe mina"}],\n       "stream":false}'

Response

{ "reply": "…", "model": "qwen", "credits_charged": 25 }