將圖片上的文字從一種語言翻譯成另一種語言，并輸出一張盡可能忠于原圖的新圖片。
接口說明
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| alimt:TranslateImage |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ImageUrl | string | 否 | 原圖 URL，跟 Base64 不能同時為空，優先取 Base64。 | https://example.com/example.jpg |
| ImageBase64 | string | 否 | 原圖 Base64，跟 URL 不能同時為空，優先取 Base64。 | /9j/4...H/9k= |
| SourceLanguage | string | 否 | 源語種，支持的語種參考，必填（請忽略表格中“是否必填”中的“否”） | zh |
| TargetLanguage | string | 否 | 目標語種，支持的語種參考，必填（請忽略表格中“是否必填”中的“否”） | en |
| Field | string | 否 | 翻譯領域， 可選值如下。
默認及未識別領域均按通用圖片翻譯處理。 | general |
| Ext | string | 否 | 擴展信息, JSON String 格式，里面可以包含的字段如下。
| {"needEditorData": "false", "ignoreEntityRecognize": "true"} |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "D774D33D-F1CB-5A2C-A787-E0A2179239CE",
"Code": 200,
"Message": "Error Message",
"Data": {
"InPaintingUrl": "https://example.com/example.jpg",
"TemplateJson": "Editor Template Json String",
"FinalImageUrl": "https://example.com/example.jpg"
}
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | Parameter.SourceLangError | Source languages are not supported. | 源語種不支持。 |
| 400 | Parameter.TargetLangError | Target languages are not supported. | 目標語種不支持。 |
| 401 | System.subNotPermission | The sub-account is not authorized to perform the operation. | 子賬號沒有權限 |
| 401 | System.AccountNotActivated | The account has not activated the service. | 賬號沒有開通服務 |
| 406 | System.ParameterError | Some required parameters are missing. | 參數錯誤 |
| 406 | Parameter.ImageUrlError | Failed to obtain the image from the URL. | 從URL下載圖片失敗 |
| 406 | Parameter.ImageSizeError | Image size should be within 15px to 8192px. | 圖片尺寸超出限制，需在15px到8192px之間 |
| 406 | Parameter.ImageFormatError | The image format is not supported. | 圖片格式不支持 |
| 406 | Parameter.ImageFileSizeError | The image file size should be within 10 MB. | 圖片大小超出限制，需在10MB以內 |
| 500 | System.unknownError | An unknown error occurred. | 未知錯誤 |
| 500 | ImageTranslate.TranslationError | Image translation error. | 圖片翻譯錯誤 |
| 500 | ImageTranslate.FusionError | Image fusion error. | 合圖錯誤 |
| 500 | ImageTranslate.EraseError | Image erasing error. | 擦圖錯誤 |
| 500 | ImageTranslate.TextTranslationError | Text translation error. | 文本翻譯錯誤 |
| 500 | ImageTranslate.TextToParagraphError | Text to paragraph error. | 段落合并錯誤 |
訪問錯誤中心查看更多錯誤碼。