After having successfully trained your model, you can translate content
using the
Cloud Translation API v3beta1
translateText method. The Cloud Translation API v3beta1 supports using
glossaries
and Batch translation requests.
REST & CMD LINE
Make sure you have enabled the Cloud AutoML API for your project. This is necessary when using AutoML models with AutoML API. See this Getting started document to enable the API.Before using any of the request data below, make the following replacements:
- project-number-or-id: your Google Cloud project number or ID
HTTP method and URL:
POST https://translation.googleapis.com/v3/projects/project-number-or-id/locations/us-central1:translateText
Request JSON body:
{
"model": "projects/project-number-or-id/locations/us-central1/models/TRL1395675701985363739",
"sourceLanguageCode": "en",
"targetLanguageCode": "ru",
"contents": ["Dr. Watson, please discard your trash. You've shared unsolicited email with me.
Let's talk about spam and importance ranking in a confidential mode."]
}
To send your request, choose one of these options:
curl
Save the request body in a file called request.json,
and execute the following command:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://translation.googleapis.com/v3/projects/project-number-or-id/locations/us-central1:translateText
PowerShell
Save the request body in a file called request.json,
and execute the following command:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/project-number-or-id/locations/us-central1:translateText " | Select-Object -Expand Content
You should receive a JSON response similar to the following:
{
"translation": {
"translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора.
Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о
спаме и важности рейтинга в конфиденциальном режиме.",
"model": "projects/project-number/locations/us-central1/models/TRL1395675701985363739"
}
}
C#
Go
Java
Node.js
PHP
Python
Ruby
Using the AutoML API
You can also use the AutoML API to translate content with your custom model, as shown in the following example.
Web UI
Open the AutoML Translation UI and click the lightbulb icon to the left of "Models" in the left navigation bar to display the available models.
To view the models for a different project, select the project from the drop-down list in the upper right of the title bar.
Click the row for the model you want to use to translate your content.
Click the Predict tab just below the title bar or the Test and use link below the model information on the Train tab.
Enter content in the source language into the text box on the right and click Translate.
You can compare the results from your custom model to the Google NMT model.
REST & CMD LINE
Before using any of the request data below, make the following replacements:
- model-name: the full name of your model. The full
name of your model includes your project name and location. A
model name looks similar to the following example:
projects/project-id/locations/us-central1/models/model-id. - source-language-text: the text that you want to translate from the source language to the target language
HTTP method and URL:
POST https://automl.googleapis.com/v1/model-name:predict
Request JSON body:
{
"payload" : {
"textSnippet": {
"content": "source-language-text"
}
}
}
To send your request, choose one of these options:
curl
Save the request body in a file called request.json,
and execute the following command:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://automl.googleapis.com/v1/model-name:predict
PowerShell
Save the request body in a file called request.json,
and execute the following command:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://automl.googleapis.com/v1/model-name:predict" | Select-Object -Expand Content
You should receive a JSON response similar to the following:
{
"payload": [
{
"translation": {
"translatedContent": {
"content": "target-language-text"
}
}
}
]
}
C#
Go
Java
Node.js
PHP
Python
Before you can run this code example, you must install the Python Client Libraries.- The
model_full_idparameter is the full name of your model. For example:projects/434039606874/locations/us-central1/models/3745331181667467569.