將圖片上的文字從一種語言翻譯成另一種語言,并輸出一張盡可能忠于原圖的新圖片。
接口說明
請確保在使用該接口前,已充分了解圖片翻譯產(chǎn)品的收費方式和價格。
該接口適用于通用圖片翻譯和電商圖片翻譯。 如需調(diào)用證件翻譯,請參考證件翻譯調(diào)用指南。
圖片限制
- 文件大小限制:10M
- 像素限制:長寬比 < 10:1
- 支持的格式:jpg, jpeg, png, bmp, gif(僅翻譯第一幀), webp
說明
僅支持通過 POST 方式調(diào)用
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
alimt:TranslateImage |
|
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ImageUrl | string | 否 | 原圖 URL,跟 Base64 不能同時為空,優(yōu)先取 Base64。 | https://example.com/example.jpg |
ImageBase64 | string | 否 | 原圖 Base64,跟 URL 不能同時為空,優(yōu)先取 Base64。 | /9j/4...H/9k= |
SourceLanguage | string | 否 | 源語種,支持的語種參考,必填(請忽略表格中“是否必填”中的“否”) | zh |
TargetLanguage | string | 否 | 目標語種,支持的語種參考,必填(請忽略表格中“是否必填”中的“否”) | en |
Field | string | 否 | 翻譯領(lǐng)域, 可選值如下。
默認及未識別領(lǐng)域均按通用圖片翻譯處理。 | general |
Ext | string | 否 | 擴展信息, JSON String 格式,里面可以包含的字段如下。
| {"needEditorData": "false", "ignoreEntityRecognize": "true"} |
返回參數(shù)
示例
正常返回示例
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. | 子賬號沒有權(quán)限 |
401 | System.AccountNotActivated | The account has not activated the service. | 賬號沒有開通服務 |
406 | System.ParameterError | Some required parameters are missing. | 參數(shù)錯誤 |
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以內(nèi) |
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. | 段落合并錯誤 |
訪問錯誤中心查看更多錯誤碼。