Available in Classic and VPC
Papago Image Translation is a NAVER Cloud Platform service that provides translation results by recognizing text included in various images such as product images, financial documents, and receipts. It provides APIs for providing OCR information, translated text, and translated images in RESTful form. It is categorized into Image Translation (Text) and Image Translation (Image) depending on the type of translation result.
- The Papago Image Translation API does not store users' source data or utilize it as training data.
- The supported specifications for the Papago Image Translation API are as follows:
- File format: *.jpg, *.jpeg, *.png, *.tiff
- File size: up to 20 MB
- Image size: up to 1960 x 1960
Common Papago Image Translation settings
The following describes commonly used request and response formats in Papago Image Translation APIs.
Request
The following describes the common request format.
API URL
The request API URL is as follows:
Image Translation(Text):
https://papago.apigw.ntruss.com/image-to-text
Image Transaltion(Image):
https://papago.apigw.ntruss.com/image-to-image
Request headers
The following describes the headers.
| Field | Required | Description |
|---|---|---|
x-ncp-apigw-api-key-id |
Required | Client ID issued after application registration in NAVER Cloud Platform console |
x-ncp-apigw-api-key |
Required | Client secret issued after application registration in NAVER Cloud Platform console |
Content-Type |
Required | Data types the client can handle
|
For information on how to register an application in the NAVER Cloud Platform console to obtain authentication information (client ID, client secret) required to use the API, see Getting started with Papago Image Translation in the Papago Image Translation user guide.
If you do not select Papago Image Translation API after registering the application in the console, you will receive a 429 (Quota Exceed) error.
Response
The following describes the common response format.
Response status codes
The following describes the response status codes.
For response status codes common to NAVER Cloud Platform, see Ncloud API response status codes.
| HTTP status code | Code | Message | Description |
|---|---|---|---|
| 404 | 00000 | API call failed | Failed to call API |
| 400 | 00001 | Request is invalid | Invalid API call |
| 404 | 00003 | Not Found | Resource does not exist. |
| 400 | 26000 | No Image | Image does not exist. |
| 400 | 26001 | Unsupported language | source and target language not supported |
| 413 | 26002 | Exceed max file size | Exceeded allowed file size (up to 20 MB). |
| 400 | 26003 | Unknown image type | Image format not supported |
| 413 | 26004 | Exceed max image size | Image exceeds width or height limits. |
| 500 | 26005 | Image serving error | Error when serving image |
| 500 | 26007 | Image no text | Text doesn't exist. |
| 500 | 26099 | Unknown error | Internal server errors |
Papago Image Translation API
The following describes the APIs provided by the Papago Image Translation service.
| API | Description |
|---|---|
| Image Translation(Text) | Recognize text in images, provide translated result text after OCR. |
| Image Translation(Image) | Recognize text in images, provide text and images with translation results after OCR. |
Papago Image Translation related resources
NAVER Cloud Platform provides a variety of related resources to help users better understand Papago Image Translation APIs.
- Papago Image Translation API guides
- Create signature: how to create a signature to add to the request header
- Common Ncloud response status codes: information on common response status codes of NAVER Cloud Platform used by the Papago Image Translation service
- Cloud Insight User Guide: introduction to how to request subscription to Cloud Insight required to set the application usage limits notifications and how to add notification recipients
- Sub Account User Guide: introduction to how to use Sub Account that helps the management of 'Papago Image Translations administration permissions
- How to use the Papago Image Translation service
- Papago Image Translation User Guide: how to use the Papago Image Translation service, check usage, and set up notifications in NAVER Cloud Platform console
- Prerequisites for using Papago Image Translation: introduction to environment specifications supported in Papago Image Translation, cautions for use, and pricing information
- Ncloud use environment guide: guide on VPC and Classic environments and supported features
- Introduction to pricing, characteristics, and detailed features: summary of Papago Image Translation pricing system, characteristics, and detailed features of Papago Image Translation
- Latest service news: the latest news on Papago Image Translation
- FAQ: frequently asked questions from Papago Image Translation users
- Contact us: Send direct inquiries in case of any unresolved questions that aren't answered by the user guides.