SubmitTranslationTask — Submit a translation task - Real Translation Buddy-Real Translation Buddy(Real Translation Buddy)-阿里云帮助中心

Learn the SubmitTranslationTask request parameters, supported language pairs, response fields, and examples.

Warning

This endpoint consumes Credits. Ensure the account has enough Credits before submitting. You can use the CreditsAvailable field returned by UploadTranslationFile as a preliminary reference; the submission result is final. If the balance is insufficient, the request fails with Credits.NotEnough.

Note

Rate limit: 5 QPS per account, concurrency 5.

Request parameters

Parameter	Type	Required	Description
TaskId	string	Conditional	Task ID obtained from `UploadTranslationFile`. Mutually exclusive with `BaseTaskId`.
BaseTaskId	string	Conditional	Pass in when re-submitting a translation; it is the ID of a previously submitted task. Mutually exclusive with `TaskId`.
Config	object	Yes	Required. Translation config.
Config.SourceLanguage	string	Yes	Required. Source language code, e.g. `zh`, `en`, `ja`.
Config.TargetLanguage	string	Yes	Required. Target language code, e.g. `en`, `zh`, `ja`.
`SourceLanguage` and `TargetLanguage` must form a supported language pair. For the complete range, see Supported Formats & Languages.
Config.Font	string	No	Target font. Available values come from the `Fonts` field returned by `UploadTranslationFile`; for re-translation of a historical task, use GetTranslationTask to fetch them.
Config.Style	string	No	Translation style. Only effective for PPT files. `normal` — Standard, fully preserves the original content. `minimal` — More condensed content and refined layout.
Config.GlossaryIds	array<string>	No	List of termbase IDs. When specified, the translation engine prioritizes terms from these termbases. Termbase IDs can be obtained from the console.
Config.AgentId	string	No	The AgentId corresponding to the Agent Console platform.
CustomTerms	array<object>	No	Custom terminology list, up to 100 entries. Only affects the current task.
CustomTerms[].SourceTerm	string	-	Source term.
CustomTerms[].TargetTerm	string	-	Target term.

Note

Custom terms are advisory only; the actual translation may vary. The final output prevails.

Response parameters

Field	Type	Description
TaskId	string	Translation task ID.
Status	string	Task status. Usually `PENDING` after submission. Possible values: `ANALYZED`, `PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`, `CANCELLED`

Example

Java — new task

import com.aliyun.realtranslationagent20260622.models.*;

import java.util.ArrayList;
import java.util.List;

// Build translation config
SubmitTranslationTaskRequest.SubmitTranslationTaskRequestConfig config =
        new SubmitTranslationTaskRequest.SubmitTranslationTaskRequestConfig()
                .setSourceLanguage("zh")
                .setTargetLanguage("en")
                .setFont("Calibri")
                .setStyle("normal");

// Build custom terms (optional)
List<SubmitTranslationTaskRequest.SubmitTranslationTaskRequestCustomTerms> customTerms = new ArrayList<>();
customTerms.add(new SubmitTranslationTaskRequest.SubmitTranslationTaskRequestCustomTerms()
        .setSourceTerm("人工智能")
        .setTargetTerm("Artificial Intelligence"));
customTerms.add(new SubmitTranslationTaskRequest.SubmitTranslationTaskRequestCustomTerms()
        .setSourceTerm("机器学习")
        .setTargetTerm("Machine Learning"));

// Submit the task
SubmitTranslationTaskRequest request = new SubmitTranslationTaskRequest()
        .setTaskId("your-task-id")  // from UploadTranslationFile
        .setConfig(config)
        .setCustomTerms(customTerms);

SubmitTranslationTaskResponse response = client.submitTranslationTask(request);
System.out.println("TaskId: " + response.getBody().getData().getTaskId());
System.out.println("Status: " + response.getBody().getData().getStatus());

Java — retranslate

SubmitTranslationTaskRequest.SubmitTranslationTaskRequestConfig config =
        new SubmitTranslationTaskRequest.SubmitTranslationTaskRequestConfig()
                .setSourceLanguage("zh")
                .setTargetLanguage("ja")
                .setFont("MS Mincho");

SubmitTranslationTaskRequest request = new SubmitTranslationTaskRequest()
        .setBaseTaskId("history-task-id")  // historical task ID
        .setConfig(config);

SubmitTranslationTaskResponse response = client.submitTranslationTask(request);

Sample response

{
  "Data": {
    "TaskId": "f9c35b0453b",
    "Status": "PENDING"
  }
}

Notes

TaskId and BaseTaskId are mutually exclusive; do not pass both.
Style is only effective for PPT files; passing it for other formats has no effect.
After submission, Credits are frozen. On completion they are settled by actual consumption; on cancellation they are fully refunded.

Error codes

Code	Description
`InvalidParameter`	Parameter validation failed
`InvalidParameter.Config`	Translation config is invalid
`Task.NotFound`	Task does not exist or you have no access
`Credits.NotEnough`	Insufficient Credits balance
`Sensitive.Blocked`	Document contains blocked sensitive content