Skip to content

Translation models

Text Services provides model discovery for transcription translation and future text translation.

Method Path Scope
GET /api/v1/text-services/translation-models text:translation-models:read
GET /api/v1/text-services/translation-models/{model} text:translation-models:read

List Translation Models

GET /api/v1/text-services/translation-models

Requires Authentication - Scopes: text:translation-models:read

Query Parameters

List queries accept page=0, size=20 (1–100), sort=alias,asc, and optional query. The response contains models, size, total, page, filters, and sort.

TranslationModelListResponse
TranslationModelListResponse
{
  "models": [{
    "id": "translation-default", "type": "FAMILY", "displayName": "Translation Default",
    "status": "AVAILABLE", "resolvedModel": "translation-v1", "isDefault": true,
    "capabilities": {
      "supportedLanguagePairs": [{ "sourceLanguageCode": "he", "targetLanguageCode": "en" }],
      "tokenizerId": "unicode-codepoint-v1", "maxInputTokens": 1000000
    },
    "deprecated": false
  }],
  "size": 1, "total": 1, "page": 0, "filters": { "query": null },
  "sort": { "field": "alias", "direction": "asc" }
}
Status Description
200 OK Page returned.
400 Bad Request Invalid page, size or sort.
403 Forbidden Missing catalog scope.

Get Translation Model

GET /api/v1/text-services/translation-models/{model}

Requires Authentication - Scopes: text:translation-models:read

TranslationModelAliasResponse

Returns the model alias with capabilities and deprecation/default metadata.

Status Description
200 OK Model returned.
403 Forbidden Scope or model visibility denied.
404 Not Found Model missing.
410 Gone Model sunset reached.
503 Service Unavailable No usable concrete model.

Omit model when submitting a translation to use the current default. A fallback model may be chosen at admission if the primary is unavailable.

Language-pair matching accepts regional variants of a supported base language. For example, he → en supports he-IL → en-US. Inference receives base language subtags; job and result metadata retain the requested and detected BCP 47 tags.