API Reference

Base URL#

http://localhost:8012/api/v1

All endpoints require Bearer token authentication in the Authorization header.

Translation#

Translate Text#

Translate a single text segment with domain specialization.

Request Body:

{
  "text": "يجب على جميع الجهات الحكومية الالتزام بمعايير الأمن السيبراني",
  "source_lang": "ar",
  "target_lang": "en",
  "domain": "administrative"
}

Response:

{
  "id": "tr-a1b2c3",
  "source_text": "يجب على جميع الجهات الحكومية الالتزام بمعايير الأمن السيبراني",
  "translated_text": "All government entities must comply with cybersecurity standards",
  "source_lang": "ar",
  "target_lang": "en",
  "domain": "administrative",
  "quality_score": 0.92,
  "model_used": "llama-3.3-70b-versatile",
  "tokens_used": 156,
  "created_at": "2024-01-15T10:30:00Z"
}

Batch Translate#

Translate multiple text segments in a single request (max 50 segments).

Request Body:

{
  "texts": [
    "First segment to translate",
    "Second segment to translate"
  ],
  "source_lang": "auto",
  "target_lang": "ar",
  "domain": "legal"
}

Response:

{
  "translations": [...],
  "total": 2,
  "domain": "legal"
}

Translate Document#

Upload a document file for end-to-end translation. Accepts multipart/form-data.

Form Fields:

Response:

{
  "id": "doc-a1b2c3",
  "filename": "contract.pdf",
  "source_lang": "ar",
  "target_lang": "en",
  "domain": "legal",
  "status": "completed",
  "total_segments": 120,
  "translated_segments": 120,
  "translated_text": "...",
  "created_at": "2024-01-15T10:30:00Z",
  "completed_at": "2024-01-15T10:30:25Z"
}

Detect Language#

Detect the language of input text.

Request Body:

{
  "text": "All government entities must comply with cybersecurity standards"
}

Response:

{
  "language": "en",
  "confidence": 0.98,
  "script": "Latin"
}

Translation History#

List past translations with pagination and filtering.

Query Parameters:

Translation Memory#

Create TM Entry#

Add a translation pair to the memory.

List TM Entries#

Browse TM entries with filtering by language, domain, and search.

Get TM Entry#

Update TM Entry#

Delete TM Entry#

Requires admin role.

Export TMX#

Export translation memory as a TMX XML file.

Import TMX#

Import a TMX file to bulk-load TM entries. Requires admin role. Accepts .tmx or .xml files via multipart/form-data.

Glossaries#

Create Glossary#

List Glossaries#

Get Glossary#

Update Glossary#

Delete Glossary#

Requires admin role.

Create Glossary Entry#

List Glossary Entries#

Update Glossary Entry#

Delete Glossary Entry#

Requires admin role.

Health#

Health Check#

Returns service health status and version information.