Translation

Deprecation notice

All existing translation APIs were deprecated on June 9, 2025. Please use a chat model such as Solar Mini 4 instead.

Context-aware translation models that leverage previous dialogues to ensure unmatched coherence and continuity in your conversations.

What models does Upstage provide?

Alias	Currently points to	RPM / TPM (Learn more)
translation-enko	translation-enko-241104	100 / 100,000
translation-koen	translation-koen-240507	100 / 100,000

Simple zero-shot translation

from openai import OpenAI # openai==1.52.2
 
client = OpenAI(
    api_key="UPSTAGE_API_KEY_INJECT",
    base_url="https://api.upstage.ai/v1"
)
 
zero_shot_translation = client.chat.completions.create(
    model="translation-enko",
    messages=[
        {
            "role": "user",
            "content": "How's going? Did you eat lunch? "
        }
    ],
    stream=False,
)

print("Zero-shot translation:", zero_shot_translation.choices[0].message.content)

# Use with stream=False
# print(stream.choices[0].message.content)

Output

Zero-shot translation: 어떻게 지내? 점심은 먹었어?

Understanding the tone in translation

Consistency in tone across translations is vital. By providing examples, the service can maintain a uniform tone throughout. This includes formal, friendly, or character-specific styles. It also accurately replicates Korean honorifics and levels of formality. The service adapts its translation style to suit various contexts, from business documents to character dialogues, ensuring natural and appropriate translations in the target language.

few_shot_stream = client.chat.completions.create(
    model="translation-enko",
    messages=[
        {
            "role": "user",
            "content": "Hi"
        },
        {
            "role": "assistant",
            "content": "안녕하시오"
        },
        {
            "role": "user",
            "content": "How's going? Did you eat lunch?"
        }
    ],
    stream=True,
)

print("Few-shot translation with stream: ", end="")
for chunk in few_shot_stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

Output

Few-shot translation with stream: 어떻게 지내오? 점심은 먹었소?

Formatted translation

This service provides translation not just for simple text sentences, but also for subtitle files such as .srt, .txt and well-formatted technical articles and books. Translation API understands and adheres to the specific formatting requirements of these different content types during the translation process. For example, it's maintaining time codes in subtitles or preserving markup in technical documentation, the translation is carried out while respecting the original structure and format of the content

#Formatted Translation 
text = """
1
00:00:00,359 --> 00:00:02,399
llm 이라는, 굉장히 큰 파도가

2
00:00:02,399 --> 00:00:04,560
왔고 그 다음에 많은 회사들이

3
00:00:04,560 --> 00:00:06,660
파도 위에 올라탔는데요. 또 이왕 하는

4
00:00:06,660 --> 00:00:09,300
거 글로벌 1등 정도는 찍어봐야

5
00:00:09,300 --> 00:00:10,740
뭔가 제대로 한다고 생각했던 것

6
00:00:10,740 --> 00:00:12,920
같네요.
"""

formatted_translation = client.chat.completions.create(
    model="translation-koen",
    messages=[
        {
            "role": "user",
            "content": text
        }
    ],
    stream=False,
)

print(formatted_translation.choices[0].message.content)

Output

1
00:00:00,359 --> 00:00:02,399
There was a huge wave called llm

2
00:00:02,399 --> 00:00:04,560
and then a lot of companies

3
00:00:04,560 --> 00:00:06,660
got on the wave. And then, since

4
00:00:06,660 --> 00:00:09,300
we're doing this, we might as well

5
00:00:09,300 --> 00:00:10,740
be the number one global company

6
00:00:10,740 --> 00:00:12,920
in this field.

Parameters

The messages parameter is a list of message objects.
Each message object has a role (which can be one of "user", or "assistant") and content.
The "system" role is not used in the translation API.
A user message is what the user inputs. Through a user message, users can request the translation of a sentence.
The assistant message can either record the previous response from the assistant or be the result of the translation. With multi-turn input, Translation API dynamically adapts to your conversation tone, intelligently translating only the latest message for a seamless experience.

Currently, timeout for non-stream mode is 60 seconds. Please use stream mode for long text translation.

Example

Request

Response

Translation

Deprecation notice

All existing translation APIs were deprecated on June 9, 2025. Please use a chat model such as Solar Mini 4 instead.

Context-aware translation models that leverage previous dialogues to ensure unmatched coherence and continuity in your conversations.

What models does Upstage provide?

Alias	Currently points to	RPM / TPM (Learn more)
translation-enko	translation-enko-241104	100 / 100,000
translation-koen	translation-koen-240507	100 / 100,000

Simple zero-shot translation

from openai import OpenAI # openai==1.52.2
 
client = OpenAI(
    api_key="UPSTAGE_API_KEY_INJECT",
    base_url="https://api.upstage.ai/v1"
)
 
zero_shot_translation = client.chat.completions.create(
    model="translation-enko",
    messages=[
        {
            "role": "user",
            "content": "How's going? Did you eat lunch? "
        }
    ],
    stream=False,
)

print("Zero-shot translation:", zero_shot_translation.choices[0].message.content)

# Use with stream=False
# print(stream.choices[0].message.content)

Output

Zero-shot translation: 어떻게 지내? 점심은 먹었어?

Understanding the tone in translation

few_shot_stream = client.chat.completions.create(
    model="translation-enko",
    messages=[
        {
            "role": "user",
            "content": "Hi"
        },
        {
            "role": "assistant",
            "content": "안녕하시오"
        },
        {
            "role": "user",
            "content": "How's going? Did you eat lunch?"
        }
    ],
    stream=True,
)

print("Few-shot translation with stream: ", end="")
for chunk in few_shot_stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

Output

Few-shot translation with stream: 어떻게 지내오? 점심은 먹었소?

Formatted translation

#Formatted Translation 
text = """
1
00:00:00,359 --> 00:00:02,399
llm 이라는, 굉장히 큰 파도가

2
00:00:02,399 --> 00:00:04,560
왔고 그 다음에 많은 회사들이

3
00:00:04,560 --> 00:00:06,660
파도 위에 올라탔는데요. 또 이왕 하는

4
00:00:06,660 --> 00:00:09,300
거 글로벌 1등 정도는 찍어봐야

5
00:00:09,300 --> 00:00:10,740
뭔가 제대로 한다고 생각했던 것

6
00:00:10,740 --> 00:00:12,920
같네요.
"""

formatted_translation = client.chat.completions.create(
    model="translation-koen",
    messages=[
        {
            "role": "user",
            "content": text
        }
    ],
    stream=False,
)

print(formatted_translation.choices[0].message.content)

Output

1
00:00:00,359 --> 00:00:02,399
There was a huge wave called llm

2
00:00:02,399 --> 00:00:04,560
and then a lot of companies

3
00:00:04,560 --> 00:00:06,660
got on the wave. And then, since

4
00:00:06,660 --> 00:00:09,300
we're doing this, we might as well

5
00:00:09,300 --> 00:00:10,740
be the number one global company

6
00:00:10,740 --> 00:00:12,920
in this field.

Parameters

The messages parameter is a list of message objects.
Each message object has a role (which can be one of "user", or "assistant") and content.
The "system" role is not used in the translation API.
A user message is what the user inputs. Through a user message, users can request the translation of a sentence.
The assistant message can either record the previous response from the assistant or be the result of the translation. With multi-turn input, Translation API dynamically adapts to your conversation tone, intelligently translating only the latest message for a seamless experience.

Currently, timeout for non-stream mode is 60 seconds. Please use stream mode for long text translation.

Translation

What models does Upstage provide?

Simple zero-shot translation

Understanding the tone in translation

Formatted translation

Parameters

Example

Request

Response

On this page

Translation

What models does Upstage provide?

Simple zero-shot translation

Understanding the tone in translation

Formatted translation

Parameters

Example

Request

Response

On this page