Python Library

The official Python library wraps the whole Ollang integration API — projects, uploads, orders, folders, revisions, translation memories, custom instructions, content, billing, locales and Figma — in a simple, Pythonic client. Source code lives in the python/ directory of the SDK repository.

Installation

pip install ollang-sdk

Requires Python 3.8+. The only dependency is requests.

Authentication

Sign up or log in at Olabs
Create or select a project
Generate an API key from project settings

from ollang import Ollang

client = Ollang(api_key="your-api-key")

Quick Start

from ollang import Ollang

client = Ollang(api_key="your-api-key")

# Upload a file (creates a project)
upload = client.uploads.direct(
    "./video.mp4",
    name="My Video",
    source_language="en",
)

# Create an order
orders = client.orders.create(
    order_type="cc",
    level=1,
    project_id=upload["projectId"],
    target_language_configs=[
        {"language": "fr", "isRush": False},
        {"language": "de", "isRush": False},
    ],
)

# Check order status
status = client.orders.get(orders[0]["orderId"])
print(status)

# Download links, once the order completes
for doc in status.get("orderDocs", []):
    print(doc["type"], doc["name"], doc["url"])

Naming the uploaded file

The platform takes the stored file’s extension from the name the file is sent under, and rejects an upload it cannot get one from. A path supplies it; raw bytes and in-memory streams do not, so pass filename alongside them:

client.uploads.direct(
    json.dumps(strings).encode(),
    name="App strings",
    source_language="en",
    filename="en.json",
)

name is the display name for the created project; it does not need an extension of its own.

Uploading VTT subtitles

Pass project_id and name instead of the old order_id argument. The API attaches subtitles to a project and returns projectId; source language defaults to the project’s language.

subtitles = client.uploads.vtt(
    './subtitles.vtt', project_id=upload["projectId"], name="Subtitles"
)
print(subtitles["projectId"])

Resources

Resource	Description
`client.projects`	Create, read and list projects
`client.uploads`	Upload files, or register remote ones by URL
`client.orders`	Create, track, review and export orders
`client.folders`	Browse folders and act on all their orders at once
`client.revisions`	Request revisions on completed orders
`client.memories`	Translation memories and their items
`client.custom_instructions`	Set custom translation instructions
`client.content`	Import and export translation units
`client.billing`	Credit wallet and consumption history
`client.locales`	Resolve and validate language codes
`client.figma`	Import Figma files and track their orders

All methods return the parsed JSON response as plain dicts and lists. Non-2xx responses raise ollang.OllangAPIError, which carries status_code and the parsed error body.

More Examples

# List orders with pagination and filters
page = client.orders.list(page=1, take=20, status="completed")
for order in page["data"]:
    print(order["id"], order.get("status"))

# Request a revision on an order
client.revisions.create(
    order_id="ORDER_ID",
    type="wrongSubtitle",
    time="00:01:23",
    description="Fix the terminology in this segment",
)

# Custom instructions
client.custom_instructions.create(
    key="tone",
    value="Formal, brand-safe tone for all marketing content",
)

Resolve a language code

Order and project creation match language codes exactly, so resolve anything uncertain instead of guessing at a region subtag.

matches = client.locales.search("portu")
check = client.locales.validate("pt-PT")

Translation memories

memory = client.memories.create("Brand terms")

job = client.memories.import_items(
    memory["id"],
    [
        {
            "sourceLanguage": "en",
            "targetLanguage": "fr",
            "sourceText": "Sign in",
            "targetText": "Se connecter",
        }
    ],
)

# Importing is asynchronous — poll the job for progress
print(client.memories.get_import_job(job["jobId"])["status"])

# Reuse a memory when creating an order
client.orders.create(
    order_type="document",
    level=1,
    project_id="PROJECT_ID",
    target_language_configs=[{"language": "fr"}],
    selected_memories=[memory["id"]],
)

Folders

folders = client.folders.list(page=1, take=20)
pairs = client.folders.order_language_pairs("FOLDER_ID", status="completed")

# Assign a translator to every French order in the folder
client.folders.assign_translator(
    "FOLDER_ID",
    translator_id="TRANSLATOR_ID",
    target_language="fr",
    deadline="2026-06-01",
)

Billing

wallet = client.billing.credits()
usage = client.billing.consumption(page=1, take=20, from_="2026-01-01", provider="deepl")

Large remote files

create_by_url hands the platform a URL to fetch server-side, so the bytes never pass through your process and there is no practical size ceiling.

project = client.projects.create_by_url(
    url="https://example.com/video.mp4",
    name="Launch video",
    source_language="en",
)

XLSX exports

The export endpoints return raw bytes. Each has a ..._to_file companion that writes the workbook to a path, creating parent directories as needed.

data = client.orders.export_xlsx("ORDER_ID")

client.orders.export_xlsx_to_file("ORDER_ID", "out/order.xlsx")
client.folders.export_xlsx_to_file(["FOLDER_ID"], ["fr", "de"], "out/folders.xlsx")

The underlying HTTP client stays available for anything not wrapped yet: client.client.get("/integration/orders"). See the full API reference for every endpoint.

Ollang SDK

Client Libraries

Python Library

Python Library

Installation

Authentication

Quick Start

Naming the uploaded file

Uploading VTT subtitles

Resources

More Examples

Resolve a language code

Translation memories

Folders

Billing

Large remote files

XLSX exports

​Python Library

​Installation

​Authentication

​Quick Start

​Naming the uploaded file

​Uploading VTT subtitles

​Resources

​More Examples

​Resolve a language code

​Translation memories

​Folders

​Billing

​Large remote files

​XLSX exports

Python Library

Installation

Authentication

Quick Start

Naming the uploaded file

Uploading VTT subtitles

Resources

More Examples

Resolve a language code

Translation memories

Folders

Billing

Large remote files

XLSX exports