Quality Tiers

Langbly supports a quality parameter that controls the translation pipeline used for your request.

Available Tiers

Tier	Status	Description	Latency	Cost
standard	Available	Single-pass context-aware translation with locale-aware formatting	~1-3s	Included in plan
premium	Coming soon	Multi-agent pipeline with MQM quality review	~5-10s	TBD

Usage

Add the quality parameter to your request body:

{
  "q": "Hello world",
  "target": "nl",
  "quality": "standard"
}

If omitted, quality defaults to "standard".

Standard Quality

The standard tier is the default and currently the only available tier. It provides:

• Single-pass context-aware translation using state-of-the-art models
• Locale-aware formatting (decimals, dates, time, units per target language)
• Protected zones for placeholders, HTML tags, URLs, and other non-translatable content
• Glossary support for enforcing consistent terminology
• Formality control for tone adjustment

Standard quality is suitable for the vast majority of use cases: website content, product descriptions, support articles, UI strings, documentation, and more.

Premium Quality (Coming Soon)

The premium tier is under development and will add a multi-agent quality review pipeline inspired by the MQM (Multidimensional Quality Metrics) framework.

The premium pipeline will:

1. Translate: Initial translation by the primary model
2. Review: A second agent evaluates the translation against MQM dimensions (accuracy, fluency, terminology, locale conventions)
3. Refine: Issues flagged by the reviewer are corrected in a final pass
4. Score: Each translation receives a quality score

Use Cases for Premium

• Legal and compliance documents
• Marketing copy where tone and nuance matter
• Published content (books, articles, press releases)
• Regulated industries (healthcare, finance)

Pricing

Premium tier pricing will be announced when the feature launches. It will use additional compute and will be priced accordingly, so expect roughly 2-3x the standard rate.

SDK Examples

Python

from langbly import Langbly

client = Langbly(api_key="your-key")

result = client.translate(
    q="Hello world",
    target="nl",
    quality="standard"
)

Node.js

import { Langbly } from 'langbly';

const client = new Langbly({ apiKey: 'your-key' });

const result = await client.translate({
  q: 'Hello world',
  target: 'nl',
  quality: 'standard',
});

cURL

curl -X POST https://api.langbly.com/language/translate/v2 \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "Hello world",
    "target": "nl",
    "quality": "standard"
  }'

Error Handling

If you send quality: "premium" before the tier is available, the API returns:

{
  "error": {
    "code": 400,
    "message": "Premium quality tier coming soon. Use 'standard' for now.",
    "status": "INVALID_ARGUMENT"
  }
}

Invalid quality values return:

{
  "error": {
    "code": 400,
    "message": "Invalid quality: must be 'standard' or 'premium'",
    "status": "INVALID_ARGUMENT"
  }
}