Translation

result = client.translate(
    text="Sannu da zuwa",
    source_language="Hausa",
    target_language="Yoruba",
    domain="general conversation",
)
 
print(result.text)
print(result.usage.total_tokens)

client.translate() returns TextResult. Its main fields are text, status, usage, processing_time, model_name, and job_id. The SDK validates both language names before sending the request.

Stream a response

for event in client.translate(
    "Good morning",
    source_language="English",
    target_language="Hausa",
    stream=True,
):
    print(event)

Async client

import asyncio
import os
import orbitalsai
 
async def main():
    async with orbitalsai.AsyncClient(
        api_key=os.environ["ORBITALSAI_API_KEY"]
    ) as client:
        result = await client.translate(
            "Sannu da zuwa",
            source_language="Hausa",
            target_language="English",
        )
        print(result.text)
 
asyncio.run(main())

For work that should not hold a connection open, use client.submit_text_job(task="translate", ...).

See the Translation guide, Async jobs, and Translation API.

Stream a response

Async client

On this page