---
title: "Translation recipes"
manual: "LLM Foundation"
version: "main"
permalink: "https://docs.typo3.org/permalink/netresearch/nr-llm:translation-recipes@main"
source: "Developer/FeatureServices/Translation.rst"
rendered: "2026-11-12T15:41:35+00:00"
---

# Translation recipes {#translation-recipes}

## TranslationService {#feature-services-translation}

**Purpose**: Language translation with formatting and terminology options.

### Use cases {#feature-services-translation-use-cases}

-   Translation suggestions (textdb).
-   Content localization.
-   Glossary-aware translation.

### Key features {#feature-services-translation-features}

-   Language detection.
-   Glossary support.
-   Formality levels.
-   Domain specialization.
-   Quality scoring.

### Example {#feature-services-translation-example}

**Example: Using TranslationService**

```php
use Netresearch\NrLlm\Service\Feature\TranslationService;
use Netresearch\NrLlm\Service\Option\TranslationOptions;

$result = $translationService->translate(
    text: 'The TYPO3 extension is great',
    targetLanguage: 'de',
    options: new TranslationOptions(
        glossary: ['TYPO3' => 'TYPO3'],
        formality: 'formal',
        domain: 'technical',
    ),
);

echo $result->translation;
echo $result->confidence;
```

### Methods {#feature-services-translation-methods}

**TranslationService methods**

```php
use Netresearch\NrLlm\Service\Option\TranslationOptions;

// Basic translation
$result = $translationService->translate('Hello, world!', 'de');

// With options
$result = $translationService->translate(
    $text,
    targetLanguage: 'de',
    sourceLanguage: 'en',
    options: new TranslationOptions(
        formality: 'formal',
        domain: 'technical',
        glossary: [
            'TYPO3' => 'TYPO3',
            'extension' => 'Erweiterung',
        ],
        preserveFormatting: true,
    ),
);

// TranslationResult properties
$translation = $result->translation;
$sourceLanguage = $result->sourceLanguage;
// Finish-reason heuristic, not a translation-quality probability.
$confidence = $result->confidence;

// Batch translation
$results = $translationService->translateBatch($texts, 'de');

// Language detection
$language = $translationService->detectLanguage($text);

// A separate paid model judgment, not verified translation quality.
$score = $translationService->scoreTranslationQuality($source, $translation, 'de');
```