Text

Translate text across 19 African and global languages

Translate dialogue transcripts, customer conversations, or plain text across 19 supported African and global languages and 342 source-target translation directions. The developer makes one request and routing is handled automatically. Set `stream: true` to receive Server-Sent Events (`text/event-stream`). Usage is metered against the account balance.

POST
/api/v1/text/translate

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

domainAny properties in TextDomain

Optional industry vertical domain for vocabulary specialization. Defaults to 'general conversation' if omitted.

source_language
Required
Language

Source language of the input text. Must be one of the 19 supported African or global languages.

Value in: "Afrikaans" | "Amharic" | "Arabic" | "English" | "French" | "German" | "Hausa" | "Igbo" | "Isixhosa" | "Italian" | "Kinyarwanda" | "Sesotho" | "Setswana" | "Shona" | "Spanish" | "Swahili" | "Twi" | "Yoruba" | "Zulu"

streamStream

If true, streams output tokens as Server-Sent Events (SSE) text/event-stream. Supported for translation, redaction, and short/detailed summarization. (Not supported for structured summarization).

Default: false

target_language
Required
Language

Target language for translation. Must be one of the 19 supported African or global languages. Must differ from source_language.

Value in: "Afrikaans" | "Amharic" | "Arabic" | "English" | "French" | "German" | "Hausa" | "Igbo" | "Isixhosa" | "Italian" | "Kinyarwanda" | "Sesotho" | "Setswana" | "Shona" | "Spanish" | "Swahili" | "Twi" | "Yoruba" | "Zulu"

text
Required
Text

Input transcript, dialogue, or document text to process.

Minimum length: 1
curl -X POST "https://api.orbitalsai.com/api/v1/text/translate" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "banking",
    "source_language": "Hausa",
    "stream": false,
    "target_language": "English",
    "text": "Agent: Sannu, yaya zan taimaka maka yau?\nCustomer: Ina so in duba asusuna ne."
  }'

Translation completed successfully.

{
  "job_id": 501,
  "missing_ranges": [],
  "model_name": "Perigee-1-text",
  "processing_time": 1.24,
  "result": "string",
  "result_structured": {
    "customer_issue": "Debit card not received after 5 business days.",
    "important_entities": [
      "Debit Card",
      "Express Delivery"
    ],
    "next_action": "Dispatch team tracking number resent via SMS.",
    "resolution_status": "in_progress",
    "sentiment": "neutral",
    "summary": "Customer called regarding a delayed debit card delivery."
  },
  "route": "single_pass",
  "sections": [
    {
      "end": 45.2,
      "failed": false,
      "index": 0,
      "start": 0,
      "summary": "Customer reported transfer failure."
    }
  ],
  "status": "complete",
  "units": {
    "failed": 0,
    "succeeded": 1,
    "total": 1
  },
  "usage": {
    "calls": 1,
    "completion_tokens": 58,
    "cost": 0.0004,
    "prompt_tokens": 142,
    "total_tokens": 200
  }
}

Guide

Translation guide

Previous

Summarize text into English (Short, Detailed, or Structured JSON) POST

Next

Generate speech from a voice reference POST