Java Library

The official Java library wraps the whole Ollang integration API — projects, uploads, orders, folders, revisions, translation memories, custom instructions, content, billing, locales and Figma — using the JDK’s built-in HTTP client, with Gson as the only runtime dependency. Source code lives in the java/ directory of the SDK repository. Requires Java 11+.

Installation

Maven:

<dependency>
  <groupId>com.ollang</groupId>
  <artifactId>ollang-sdk</artifactId>
  <version>0.2.1</version>
</dependency>

Gradle:

implementation 'com.ollang:ollang-sdk:0.2.1'

Authentication

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

import com.ollang.sdk.Ollang;

Ollang ollang = Ollang.builder()
    .apiKey(System.getenv("OLLANG_API_KEY"))
    .build();

Quick Start

import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
import com.ollang.sdk.Ollang;
import java.nio.file.Path;

Ollang ollang = Ollang.builder()
    .apiKey(System.getenv("OLLANG_API_KEY"))
    .build();

// Upload a file (creates a project)
JsonElement upload = ollang.uploads().direct(Path.of("video.mp4"), "My Video", "en");
String projectId = upload.getAsJsonObject().get("projectId").getAsString();

// Create an order
JsonObject params = new JsonObject();
params.addProperty("orderType", "cc");
params.addProperty("level", 1);
params.addProperty("projectId", projectId);
params.add("targetLanguageConfigs", JsonParser.parseString(
    "[{\"language\":\"fr\",\"isRush\":false},{\"language\":\"de\",\"isRush\":false}]"));
JsonElement orders = ollang.orders().create(params);

// Check order status
String orderId = orders.getAsJsonArray().get(0).getAsJsonObject().get("orderId").getAsString();
JsonElement status = ollang.orders().get(orderId);
System.out.println(status);

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. The Path overloads use the file’s own name; the in-memory overload takes it as an argument:

ollang.uploads().direct(bytes, "en.json", "App strings", "en", null);

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

Uploading VTT subtitles

The VTT overloads take a source project ID and a display name, replacing the old order ID argument. Source language comes from the project; the response contains projectId.

ollang.uploads().vtt(Path.of("subtitles.vtt"), projectId, "Subtitles");
ollang.uploads().vtt(bytes, "subtitles.vtt", projectId, "Subtitles");

Resources

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

All methods return the parsed JSON response as a Gson JsonElement. Non-2xx responses throw OllangApiException, which carries the HTTP status code and the response body (raw and parsed).

More Examples

import com.ollang.sdk.resources.Orders;

// List orders with pagination and filters
JsonElement page = ollang.orders().list(
    new Orders.ListOptions().page(1).take(20).status("completed"));

// Request a revision on an order
ollang.revisions().create("ORDER_ID", "wrongSubtitle", "00:01:23", "Fix the terminology here");

// Custom instructions
ollang.customInstructions().create("tone", "Formal, brand-safe tone", null);

Resolve a language code

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

JsonElement matches = ollang.locales().search("portu");
JsonElement check = ollang.locales().validate("pt-PT");

Translation memories

JsonElement memory = ollang.memories().create("Brand terms");
String memoryId = memory.getAsJsonObject().get("id").getAsString();

JsonElement job = ollang.memories().importItems(
    memoryId,
    List.of(Map.of(
        "sourceLanguage", "en",
        "targetLanguage", "fr",
        "sourceText", "Sign in",
        "targetText", "Se connecter")));

// Importing is asynchronous — poll the job for progress
String jobId = job.getAsJsonObject().get("jobId").getAsString();
JsonElement progress = ollang.memories().getImportJob(jobId);

Folders

import com.ollang.sdk.resources.Folders;

JsonElement folders = ollang.folders().list(new Folders.ListOptions().page(1).take(20));
JsonElement pairs = ollang.folders().orderLanguagePairs("FOLDER_ID", "completed");

// Assign a translator to every French order in the folder
ollang.folders().assignTranslator("FOLDER_ID", "TRANSLATOR_ID", "2026-06-01", null, "fr");

Billing

import com.ollang.sdk.resources.Billing;

JsonElement wallet = ollang.billing().credits();
JsonElement usage = ollang.billing().consumption(
    new Billing.ConsumptionOptions().page(1).take(20).from("2026-01-01").provider("deepl"));

Large remote files

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

JsonElement project = ollang.projects().createByUrl(
    "https://example.com/video.mp4", "Launch video", "en");

XLSX exports

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

byte[] data = ollang.orders().exportXlsx("ORDER_ID");

ollang.orders().exportXlsxToFile("ORDER_ID", Path.of("out/order.xlsx"));
ollang.folders().exportXlsxToFile(
    List.of("FOLDER_ID"), List.of("fr", "de"), Path.of("out/folders.xlsx"));

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

Ollang SDK

Client Libraries

Java Library

Java 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

​Java 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

Java 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