Skip to main content

translate

The translate function provides AI-powered language translation.

Import​

from openstackai import translate

Basic Usage​

# Auto-detect source language
result = translate("Hello, world!", to="es")
# "Β‘Hola, mundo!"

# Specify source language
result = translate("Bonjour", from_lang="fr", to="en")
# "Hello"

Parameters​

ParameterTypeDefaultDescription
textstrrequiredText to translate
tostrrequiredTarget language code
from_langstr"auto"Source language (auto-detect)
preserve_formatboolTrueKeep formatting

Language Codes​

CodeLanguage
enEnglish
esSpanish
frFrench
deGerman
itItalian
ptPortuguese
zhChinese
jaJapanese
koKorean
arArabic

Examples​

Basic Translation​

from openstackai import translate

# English to Spanish
spanish = translate("The quick brown fox", to="es")
print(spanish)

# French to English
english = translate("Je suis un dΓ©veloppeur", to="en")
print(english)

Batch Translation​

texts = [
"Hello",
"How are you?",
"Goodbye"
]

translations = [translate(t, to="de") for t in texts]

Preserve Formatting​

markdown = """
# Title

- Point 1
- Point 2
"""

translated = translate(markdown, to="fr", preserve_format=True)
# Preserves markdown structure

Async Usage​

import asyncio
from openstackai import translate

async def main():
result = await translate.async_("Hello world", to="ja")
print(result)

asyncio.run(main())

See Also​

  • [[ask]] - Question answering
  • [[generate]] - Content generation
  • [[summarize]] - Summarization