Translate

POST /v1/image-translate/translate

이미지는 본문에 원시 바이트로 보내고(JSON도, base64도 아닙니다), 나머지 파라미터는 모두 쿼리 문자열로 보냅니다. 번역된 JPEG를 돌려받거나, render=false이면 텍스트를 지운 이미지와 모든 텍스트 영역을 JSON으로 돌려받습니다.

요청

curl -X POST "https://gateway.apinoa.com/v1/image-translate/translate?source_language=zh-CN&target_language=ko" \
  -H "x-api-key: $APINOA_API_KEY" \
  -H "Content-Type: image/jpeg" \
  --data-binary @product.jpg \
  -o translated.jpg

파라미터

헤더

쿼리 문자열

응답

render=true(기본값): 이미지

본문은 번역된 JPEG(Content-Type: image/jpeg)이며, 다음 헤더가 붙습니다.

텍스트가 없는 이미지는 X-Apinoa-Regions-Count: 0과 함께 그대로 돌아옵니다.

render=false: 영역을 담은 JSON

실제 응답을 첫 번째 영역만 남기고 줄인 것입니다.

{
  "success": true,
  "requestId": "240d4c0348574bd7bc12f8e5d8780a87",
  "data": {
    "inpainted_base64": "/9j/4AAQSkZJRgABAQAA…",
    "regions": [
      {
        "index": 0,
        "polygon": [[83, 68], [352, 68], [352, 145], [83, 145]],
        "bbox": { "x": 83, "y": 68, "w": 269, "h": 77 },
        "text": "限时特价",
        "text_kr": "기간 한정 특가",
        "confidence": 0.999354,
        "text_color": { "r": 255, "g": 253, "b": 252 },
        "bg_color": { "r": 211, "g": 40, "b": 43 },
        "bg_std": 0.418889,
        "font_weight": "Regular",
        "is_badge": false
      }
    ],
    "regions_count": 3
  }
}

에러

모든 코드는 Errors에 있습니다. 실패한 호출은 과금되지 않습니다.

가격

각 호출은 가격 페이지의 이미지 번역 요율로 과금됩니다.

참고

• 한도. JPEG, PNG, WebP 이미지, 최대 8192 × 8192 px, 본문 20 MB까지입니다.
• 타임아웃. 대부분의 호출은 1.5–3초 안에 끝나지만, 부하가 크면 최대 5분까지 걸릴 수 있습니다. 느린 응답이 클라이언트 쪽에서 끊기지 않도록 HTTP 클라이언트의 타임아웃을 300초 이상으로 설정하세요.
• 직접 그리기. render=false이면 inpainted_base64를 디코딩하고, 각 영역의 text_kr을 polygon 안에 text_color, bg_color, font_weight로 그리세요.
• 나만의 폰트. 폰트를 업로드하고 font=user/<id>를 넘기세요. Custom Fonts를 참고하세요.