AI MediaKit 图像翻译工具能够自动识别图像中的文字内容，并将其翻译为指定的目标语言，最终生成保留原图布局和视觉风格的新图像。该功能适用于跨境电商商品图、漫画、游戏、行业文献、路牌菜单等多语言本地化场景。本篇开发指南将引导您： * 快速体验通过一次 API 调用将图片中的文字翻译成另一种语言。 * 理解不同翻译模型的效果差异与适用场景。 ## 效果示例 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/399f94a3b18e4a0ab793c3d073ab7184) ## 快速体验：一键翻译图片文字图像翻译是一个**同步任务**，您发起的请求会直接在响应中返回处理结果。 ### 准备工作 1. **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **AI MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备图像文件**：准备一张待翻译的图片，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 ### 操作流程您只需调用[提交图像翻译任务 API](https://docs.volcengine.com/docs/6448/2522489)，即可在 API 的响应体中直接获取翻译后的图片地址。 #### 步骤 1：提交任务并获取结果可直接复制以下 cURL 命令，替换其中的参数后执行。该示例将图片中的英文翻译为中文。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools-sync/translate-image-text' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "image_url": "https://example.com/image_in_english.jpg", "target_lang": "zh" }' ```

说明

将 {Your_API_Key} 替换为您的有效 API Key。

将 image_url 替换为您真实的图片地址。

此示例未指定源语言，系统会自动检测。

#### 步骤 2：查看响应由于是同步接口，请求成功后，您会在几秒内收到包含最终结果的响应。您可以直接从` result.image_url` 字段获取翻译后图片的下载地址（有效期为 24 小时）。 ```JSON { "success": true, "task_id": "amk-tool-translate-image-text-1234567", "task_type": "translate-image-text", "request_id": "021778401180935fdbd0ff1ce00652c087", "result": { "image_url": "https://example.volcvideo.com/translated_output_zh.jpg?auth_key=...", "image_size": 150234, "image_format": "jpeg", "image_width": 1920, "image_height": 1080 }, "expires_at": 1778573984 } ``` ## 进阶使用 ### 切换模型版本图像翻译工具提供了多种模型版本以适应不同场景的需求，您可以通过 `tool_version` 参数进行选择。 |模型版本 (tool_version) |描述与适用场景 | |---|---| |seed\-translation (默认) |大模型版擦除模型。使用 [doubao-seed-translation 模型](https://www.volcengine.com/docs/82379/1820188)翻译图片，先擦除翻译区域，再将翻译后的文本放置在翻译区域中。效果最佳。 | |erase |擦除翻译区域模型。在翻译图片时，先擦除翻译区域，再将翻译后的文本放置在翻译区域中。 | |overlay\-translation |直接叠加译文，不擦除原文。适合保留原图布局、强调译文叠加效果的场景。 | |dense\-text\-translation |密集文本非擦除模型。适用于漫画等文字密集型翻译场景。翻译后的文本会直接叠加在原始文本上。 | |logo\-retain\-erase\-translation |带品牌识别的擦除模型。在翻译图片时，能够识别并保持品牌 Logo/名称不被翻译。 | ### 指定源语言与目标语言您可以通过 `source_lang` 和 `target_lang` 参数来指定源语言和目标语言。不同模型版本支持的语种有所不同，详情请参考[附录：支持的语种](https://docs.volcengine.com/docs/6448/2522302#ba73f385)。 #### 示例：将日语图片翻译为英语 ```JSON { "image_url": "https://example.com/source_ja.jpg", "source_lang": "ja", "target_lang": "en" } ``` ## 参考信息 ### 性能与限制 |**限制项** |**说明** | |---|---| |**输入图像限制** |* **图像来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、火山引擎对象存储 (`tos://`) 三种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

* **支持格式**：.png、.jpg、.jpeg 和 .webp。不支持动图。

* **文件大小**：单张图片不得超过 10 MB。

* **图像分辨率**：宽和高均不得小于 10 × 10 像素，宽和高的乘积不得超过 2000 万像素。 | ## 附录：支持的语种 ### seed\-translation 模型当 `tool_version` 为 `seed-translation` 时，源语言和目标语言均支持以下语种： |语种编号 |语种名称 | |---|---| |`ar` |阿拉伯语 | |`cs` |捷克语 | |`da` |丹麦语 | |`de` |德语 | |`en` |英语 | |`es` |西班牙语 | |`fi` |芬兰语 | |`fr` |法语 | |`hr` |克罗地亚语 | |`hu` |匈牙利语 | |`id` |印尼语 | |`it` |意大利语 | |`ja` |日语 | |`ko` |韩语 | |`ms` |马来语 | |`nb` |挪威语 | |`nl` |荷兰语 | |`pl` |波兰语 | |`pt` |葡萄牙语 | |`ro` |罗马尼亚语 | |`ru` |俄语 | |`sv` |瑞典语 | |`th` |泰语 | |`tr` |土耳其语 | |`uk` |乌克兰语 | |`vi` |越南语 | |`zh` |中文 | |`zh_hant` |中文繁体 | ### 其他模型当 `tool_version` 为 `erase`、`overlay-translation`、`dense-text-translation`、`logo-retain-erase-translation` 时，支持的语种如下： #### 支持的源语言 (source_lang) |语种编号 |语种名称 | |---|---| |`ar` |阿拉伯语 | |`az` |阿塞拜疆语 | |`bn` |孟加拉语 | |`ca` |加泰罗尼亚语 | |`cs` |捷克语 | |`da` |丹麦语 | |`de` |德语 | |`en` |英语 | |`es` |西班牙语 | |`fi` |芬兰语 | |`fr` |法语 | |`he` |希伯来语 | |`hu` |匈牙利语 | |`id` |印尼语 | |`it` |意大利语 | |`ja` |日语 | |`ko` |韩语 | |`ms` |马来语 | |`nl` |荷兰语 | |`no` |挪威语 | |`pl` |波兰语 | |`pt` |葡萄牙语 | |`ru` |俄语 | |`sk` |斯洛伐克语 | |`sl` |斯洛文尼亚语 | |`sv` |瑞典语 | |`ta` |泰米尔语 | |`th` |泰语 | |`tr` |土耳其语 | |`vi` |越南语 | |`zh` |中文 | |`zh_hant` |中文繁体 | #### 支持的目标语言 (target_lang) |语种编号 |语种名称 | |---|---| |`ar` |阿拉伯语 | |`de` |德语 | |`en` |英语 | |`es` |西班牙语 | |`fr` |法语 | |`id` |印尼语 | |`it` |意大利语 | |`ja` |日语 | |`ko` |韩语 | |`ms` |马来语 | |`pt` |葡萄牙语 | |`ru` |俄语 | |`th` |泰语 | |`vi` |越南语 | |`zh` |中文 | |`zh_hant` |中文繁体 | ## 相关 API 文档 * [提交图像翻译任务 API](https://docs.volcengine.com/docs/6448/2522489)