GetHtmlTranslateTask
Retrieves the result of an HTML translation task from Tongyi Multimodal Translation.
Try it now
Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.
RAM authorization
The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:
-
Action: The actions can be used in the
Actionelement of RAM permission policy statements to grant permissions to perform the operation. -
API: The API that you can call to perform the action.
-
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
-
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the
Resourceelement of the policy. - For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the
Resourceelement of the policy.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the
-
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
-
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.
Action | Access level | Resource type | Condition key | Dependent action |
|---|---|---|---|---|
anytrans:GetHtmlTranslateTask | none | *All Resource
| None | None |
Request syntax
POST /anytrans/translate/html/get HTTP/1.1
Request parameters
Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| workspaceId | string | Yes | The ID of the Model Studio workspace. | llm-kqtrcpdee4xm29xx |
| taskId | string | No | The ID of the HTML translation task. | 868c2fdd-96c2-4546-96d2-a259b8f35252 |
Response elements
Element | Type | Description | Example |
|---|---|---|---|
object | The response schema. | ||
| code | string | The operation status code. | success |
| message | string | The response message. | success |
| requestId | string | The ID of the request. Use this ID to trace the request. | 04B53310-CB1A-14B4-AC85-26C154D8366A |
| success | boolean | Indicates whether the request succeeded. Valid values:
| true |
| httpStatusCode | string | The HTTP status code returned by the server. | 200 |
| data | object | The response data. | |
| translation | string | Translation Result | <!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="utf-8"/> <meta content="width=device-width, initial-scale=1.0" name="viewport"/> <title>My First Webpage</title> </head> <body> <h1>Welcome to my webpage!</h1> <p>This is a simple HTML page.</p> <p>Learning HTML is the first step to entering web development.</p> <a href="https://www.example.com">Click here to visit the sample website</a> </body> </html> |
| usage | object | Details about token usage. | |
| inputTokens | integer | The number of tokens in the input. | 22 |
| outputTokens | integer | The number of tokens in the output. | 19 |
| totalTokens | integer | The total number of tokens for the request. | 41 |
Examples
Success response
JSON format
{
"code": "success",
"message": "success",
"requestId": "04B53310-CB1A-14B4-AC85-26C154D8366A",
"success": true,
"httpStatusCode": "200",
"data": {
"translation": "\n\n\n\n\n\nMy First Webpage\n\n\nWelcome to my webpage!\nThis is a simple HTML page.\nLearning HTML is the first step to entering web development.\nClick here to visit the sample website\n\n