单次图片翻译（文件请求）

请求参数

Query 参数

Action

string

服务类型

必需

示例值:

GetImageTranslate

SourceLanguage

enum<string> <enum>

原始图片语⾔

必需

枚举值:

CHSCHTENGESPJPNKORPTROMRUSVIN

示例值:

CHS

TargetLanguage

enum<string> <enum>

目标图片语言

必需

枚举值:

ARBGBNCHSCHTCSYDADEUELENGESPETFAFIFILFRAGUHUNIDITAJPNJWKORMSMYNLDPLKPTBROMRUSTHTLTRKVIN

示例值:

ENG

Url

string

必需

图⽚地址，url 参数在传递时需要进行 urlencode

示例值:

local

ImgTransKey

string

必需

图片翻译服务标识码，参考访问控制

CommitTime

string

秒级时间戳

必需

示例值:

Sign

string

必需

签名。签名⽅法: md5( CommitTime + '_' + UserKey + '_' + ImgTransKey ) 小写

示例值:

MD5(CommitTime + "_" + UserKey + "_" + ImgTransKey)

EngineType

integer

可选

翻译引擎。选填。默认与“图片翻译服务标识码”保持一致，当前仅当“图片翻译服务标识码”为“阿里云图片翻译服务标识码”时，接受 EngineType=5 为 ChatGPT 翻译，其他无效

示例值:

5

NeedWatermark

integer

可选

是否添加水印，1=添加，0=不添加，默认为 1。需在 Web 端配置水印模板，否则不添加

示例值:

0

NeedRmUrl

integer

可选

是否返回去文字图片链接。1=返回去文字图片链接，其它或无此字段，则不返回去文字图片链接

示例值:

1

Qos

string

可选

翻译速度与翻译质量的偏好选项。LowLatency=偏好速度而牺牲质量，BestQuality=偏好图片翻译的质量

示例值:

LowLatency

Body 参数multipart/form-data

file-stream

file

可选

图片文件数据流，file-stream参数与file-base64参数二选一

示例值:

cmMtdXBsb2FkLTE3NDg2MTUxOTk3NTYtNQ==/WechatIMG5867.jpg

file-base64

string

可选

图片文件base64 编码，file-stream参数与file-base64参数二选一

示例值:

data:image/png;base64,iVBORw0KGgoAAAANSU...

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST 'https://api2.tosoiot.com?Action=GetImageTranslate&SourceLanguage=CHS&TargetLanguage=ENG&Url=local&ImgTransKey&CommitTime={{$date.timestamp}}&Sign=MD5(CommitTime + "_" + UserKey + "_" + ImgTransKey)&EngineType=5&NeedWatermark=0&NeedRmUrl=1&Qos=LowLatency' \
--form 'file-stream=@"cmMtdXBsb2FkLTE3NDg2MTUxOTk3NTYtNQ==/WechatIMG5867.jpg"' \
--form 'file-base64="data:image/png;base64,iVBORw0KGgoAAAANSU..."'

返回响应

🟢200成功

application/json

OK

Body

返回结果

Code

integer <int32>

返回码

可选

Message

string

返回信息

可选

Data

object

返回体

可选

SourceLanguage

string

来源语⾔

可选

TargetLanguage

string

目标语⾔

可选

OriginText

string

原文

可选

Text

string

翻译结果

可选

RequestId

string

请求的唯一 id

可选

示例

{
    "Code": 0,
    "Message": "string",
    "Data": {
        "SourceLanguage": "string",
        "TargetLanguage": "string",
        "OriginText": "string",
        "Text": "string"
    },
    "RequestId": "string"
}