图片翻译

识别和翻译图片中的文字，直接得到翻译结果图片，其中的文字被翻译成指定的语言，同时保留原图的排版和样式。

POST https://api.piclaza.com/task/v1/image/translate

Request body

Content-Type: application/json

image_url string required[1]
图片链接

image_urls array of string required[1]
图片链接列表

image_file_b64 string required[1]
图片文件内容，base64 编码格式 (format: data:[<mediatype>][;base64],<data>)

image_name string
image_file_b64 对应的文件名

source_language string required
源语言，目前支持

CHS: 中文(简体)
CHT: 中文(繁体)
ENG: 英语
ESP: 西班牙语
JPN: 日语
KOR: 韩语

target_language string required
目标语言，支持语言列表见支持语言

translation_vendor string
使用的文本翻译引擎，目前支持

Google: (默认) 广泛适用全球多种语言
Papago: 韩语翻译效果好
DeepL: 适用多种语言，在俚语、方言翻译方面表现优异
ChatGPT: 使用目前最好的大语言模型(gpt-4o)，翻译准确
Aliyun: 适合中文翻译

qos string
服务质量等级，目前支持

BestQuality: (默认) 注重翻译效果
LowLatency: 注重翻译速度

1 image_url/image_urls/image_file_b64 是输入图片参数的三种形式，三个参数选择一个

Example

{
    "image_url": "https://m.media-amazon.com/images/I/71Y0duLL0jL._AC_SL1500_.jpg",
    "source_language": "ENG",
    "target_language": "KOR",
    "translation_vendor": "Google"
}

Response body

Content-Type: application/json

code integer
状态码，非 0 表示错误，具体含义见响应状态码说明

message string
错误信息

data map
返回数据

results array of Task object

Example

{
    "code": 0,
    "data": {
        "results": [
            {
                "code": 0,
                "task_id": "827e1d0a0a68771e",
                "type": "image-translation-google",
            }
        ]
    }
}

The Task Object

code integer
状态码，非 0 表示错误，具体含义见响应状态码说明

message string
错误信息

task_id string
任务 id

type string
任务类型

查询图片翻译结果

POST https://api.piclaza.com/task/v1/image/translate/result

Parameters

Content-Type: application/json

task_ids string required
任务 id 列表

verbose boolean
是否返回详细的 OCR 数据，默认 false

Example

{
    "task_ids": ["863ab3836328f4ec"],
    "verbose": true
}

Responses

Content-Type: application/json

code integer
状态码，非 0 表示错误，具体含义见响应状态码说明

message string
错误信息

data object
返回数据

results array of Image Translatioin Result object

Example

{
    "code": 0,
    "data": {
        "results": [
            {
                "code": 0,
                "task_id": "863ab3836328f4ec",
                "request_id": "863ab3836328f4ec",
                "source_language": "ENG",
                "target_language": "KOR",
                "original_image": "https://i.tosoiot.com/1cbb77123add49a2.jpg",
                "translated_image": "https://i.tosoiot.com/1cbb77123add49a2-f.jpg",
                "text_removed_image": "https://i.tosoiot.com/1cbb77123add49a2-i.jpg",
                "ocr": [
                    {
                        "id": 1,
                        "source": "External function",
                        "target": "외부 기능",
                        "ori_bounding_box": "[[173,133], [617,133], [617,177], [173,177]]",
                        "bounding_box": "[[173,133], [617,133], [617,177], [173,177]]",
                        "font_size": 35,
                        "direction": "h",
                        "color": "255,255,255",
                        "stroke_color": "255,255,255",
                        "line_count": 1,
                        "align": "left"
                    },
                    {
                        "id": 5,
                        "source": "The watch comes with an external speaker, which can play the recording directly without other equipment.",
                        "target": "시계에는 외부 스피커가 있어서 다른 장비 없이도 녹음 내용을 직접 재생할 수 있습니다.",
                        "ori_bounding_box": "[[ 93,208], [697,208], [697,297], [ 93,297]]",
                        "bounding_box": "[[ 93,208], [697,208], [697,297], [ 93,297]]",
                        "font_size": 24,
                        "direction": "h",
                        "color": "255,255,255",
                        "stroke_color": "255,255,255",
                        "line_count": 2,
                        "align": "center"
                    }
                ]
            }
        ]
    }
}

The Image Translation Result Object

code integer
状态码，非 0 表示错误，具体含义见响应状态码说明

message string
错误信息

task_id string
任务 id

user_id integer
用户 id

type string
任务类型

status string
任务状态 (ok/running/failed)

original_image string
原图链接

translated_image string
翻译结果图片链接

text_removed_image string
去除文字的图片链接

ocr list of Image OCR object
识别到的文本信息列表

The Image OCR Object

数据中涉及坐标表示: 图片左上角为 (0, 0) 点; x 轴从左向右; y 轴从上向下

(0,0)---x--->
  |
  |
  y
  |
  |
  v

id integer
编号

source string
识别到的原文

target string
译文

ori_bounding_box string
原文文本框边界

bounding_box string
译文文本框边界

font_size integer
文字大小

direction integer
文字书写方向 (h: 横向, v: 纵向)
部分语言有纵向书写的习惯，比如中文、日文

color string
文字颜色 (RGB)

stroke_color string
文字描边颜色 (RGB)

line_count integer
行数

angle integer
旋转角度 (从x轴正方向顺时针旋转的角度, 默认0)

align string
对齐方式 (left/right/center)

开始

说明