Documentation

Platform Guide

Chat Interface

The chat interface provides a conversational AI experience with streaming AI responses. Type your message and press Enter to send. The AI speaks Sango, French, and English and helps you learn vocabulary, grammar, and cultural context.

Translation

Translate text between Sango, French, and English. All five directions are supported: FR→SG, EN→SG, SG→FR, SG→EN, and auto-detect. The AI provides contextual translations with cultural awareness.

Vocabulary & Learning

The Learn page includes 289+ verified Sango words with pronunciation guides, flashcards, quizzes, and fill-in-the-blank exercises organized by category (greetings, numbers, colors, family, food, etc.) and difficulty level.

Keyboard Shortcuts

• Enter — Send message
• Shift + Enter — New line

API Reference

The translation and vocabulary endpoints are publicly accessible without authentication. The chat endpoint requires a JWT token. See the Developer Portal for working code examples.

POST /api/v1/translate

Translate text between French, English, and Sango. No authentication required.

Request Body

{
  "text": "Bonjour, comment allez-vous?",
  "source_language": "french",   // "french" | "sango" | "english" | "auto"
  "target_language": "sango",    // "french" | "sango" | "english"
  "include_alternatives": false  // optional
}

Response (200)

{
  "translated_text": "Bara âla, tongana nye?",
  "source_language": "french",
  "target_language": "sango",
  "word_count": 3,
  "confidence": 0.95
}

POST /api/v1/vocabulary/search

Search the verified Sango vocabulary database. Returns matching words with pronunciation guides and example sentences. No authentication required.

Request Body

{
  "query": "hello",       // search term
  "limit": 10,            // max results (default 10)
  "status": "verified"    // filter by status
}

Response (200)

{
  "words": [{
    "word_id": "gree-903",
    "sango": "bala ala",
    "french": "bonjour",
    "english": "hello",
    "category": "greetings",
    "difficulty": "beginner",
    "pronunciation_guide": "Ba-la ala"
  }],
  "count": 1,
  "total_available": 289
}

GET /api/v1/vocabulary/random/{count}

Get random verified vocabulary words. Useful for quiz games and flashcards. No authentication required.

Response (200)

{
  "words": [{
    "word_id": "colo-951",
    "sango": "sango ya nzöngo",
    "french": "jaune",
    "english": "yellow",
    "category": "colors",
    "difficulty": "beginner"
  }],
  "count": 5
}

POST /api/v1/chat

AI-powered Sango language assistant. Requires authentication (JWT token).

Headers

Authorization: Bearer <JWT_TOKEN>
Content-Type: application/json

Request Body

{
  "message": "How do you say goodbye in Sango?",
  "mode": "learning"
}

Authentication

• Public endpoints (translate, vocabulary): No authentication needed. Just send your request.
• Protected endpoints (chat, user progress): Require an Authorization: Bearer <JWT> header. Users authenticate via Google OAuth or email/password on the SangoAI web app.
• API keys (coming soon): Dedicated X-API-Key header for developer integrations with higher rate limits.

Error Handling

Language Support

Supported Languages

• Sango (Sängö) — national language of the Central African Republic (5M+ speakers)
• French (Français) — official language of the CAR
• English — for international users

Sango Orthography

SangoAI uses the standard Sango orthography with diacritics: â, ê, ë, î, ö, ô, û, ü, ï. The translation engine handles accent-insensitive matching for input.

Privacy

Chat conversations are stored in your browser and on our servers for context. Translation requests are not stored permanently. We do not share your data with third parties.