• 是否需要网络：不能确定
• 是否需要申请API Key：不能确定
• 支持的翻译模式：图片
• 翻译质量：不能确定

未完善

下面的文档只是草案，还没有进行进一步的撰写。

重要

这是一个高级功能，需要您了解基本的API调用知识。

一、基本说明

此功能允许您配置自己的图片翻译API，支持GET和POST两种请求方式（对于图片翻译，POST的Content-Type可以是“application/json; charset=utf-8”或“multipart/form-data”，只需在Content-Type选择框中选择，不需重复显式填写在下面的请求头中）。所有API响应必须为JSON格式。

二、使用场景

一般来说，由于各大翻译API提供商都有自己的签名算法，无法通过简单的GET/POST请求接入，因此实际上自定义图片翻译API可以接入的商用API接口数量有限，更贴合实际的使用场景为接入自己搭建的翻译API接口。

三、参数说明

1、请求方法：可以为GET或POST
2、Content-Type（仅POST）：可以为“application/json”或“multipart/form-data”
3、基础URL：可指定http或https，如不指定scheme，则默认为https
4、查询参数（仅GET）：附加于基础URL之后的参数
5、请求头：发送请求时的头部
6、请求体（仅POST）：发送请求时附带的内容
7、JSON响应路径：调用API后，从响应的JSON中获取翻译结果的路径

注意：
1、在“查询参数”和“Content-Type为‘application/json’的请求体”中，使用“useimgbase64”代表待翻译的图片文件；
2、在“Content-Type为‘multipart/form-data’的请求体”中，使用“useimgfile”代表待翻译的图片文件；
3、同时请注意，务必将“源语言”和“目标语言”的语言代码包含在“查询参数”或“请求体”中。

四、请求示例

GET请求
基础URL：
https://api.example.com/translate

查询参数：
key：img，value：useimgbase64；
key：source，value：ja；
key：target，value：zh

请求头： Authorization = my_custom_token

POST请求
Content-Type:
application/json

基础URL：
https://api.example.com/translate

请求头：
Authorization = my_custom_token

请求体:
key：img，value：useimgbase64；
key：source，value：ja；
key：target，value：zh

POST请求
Content-Type:
multipart/form-data

基础URL：
https://api.example.com/translate

请求头：
Authorization = my_custom_token

请求体:
key：img，value：useimgfile；
key：source，value：ja；
key：target，value：zh

五、JSON响应路径

举例1：
假设成功响应的JSON如下：

{
    "code": 0,
    "msg": "success",
    "data": {
        "translation": "你好世界"
    }
}

则JSON响应路径应填写：data.translation

举例2：
假设成功响应的JSON如下：

{
    "code": 0,
    "msg": "success",
    "result": "你好世界"
}

则JSON响应路径应填写：result

举例3（数组嵌套）：
假设成功响应的JSON如下：

{
    "code": 0,
    "msg": "success",
    "data": {
        "translations": [ 
            {
                "text": "你好世界"
            }
        ]
    }
}

则JSON响应路径应填写：data.translations[0].text

语法说明：使用“.”分隔对象属性，使用“[序号]”访问数组元素（序号从0开始），二者可自由组合，例如：data.list[0].items[2].text

六、在使用该功能之前

您可以先使用Postman、Reqable等工具测试API响应，待测试成功后再将相关参数填入该功能中。