API 문서

이미지 속 텍스트를 번역하고 원본 레이아웃을 그대로 유지한 채 이미지에 다시 렌더링하여 반환합니다.

빠른 시작

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

인증

모든 요청의 Authorization 헤더에 API key 를 Bearer 토큰 형식으로 포함해야 합니다.

Authorization: Bearer YOUR_KEY

API key 는 sk_imagetranslate_ 접두사가 붙은 32 바이트 랜덤 문자열입니다. 비밀번호와 동일하게 취급하여 서버 측 시크릿 매니저에 보관하고, 코드 저장소에 커밋하거나 프론트엔드 코드에 노출해서는 안 됩니다.

멱등성

네트워크 타임아웃 후 요청을 재시도할 때 동일한 Idempotency-Key 헤더를 함께 전송하면 크레딧이 중복 차감되지 않습니다.

Idempotency-Key: <your-uuid>

• 특정 키로 보낸 첫 호출: 정상적으로 처리됩니다.
• 동일한 키로 보낸 이후 호출(API key 단위): 409 Conflict 와 함께 최초의 recordId 를 반환합니다. 재시도 시 크레딧이 차감되지 않습니다.
• 키가 다르면 별개의 호출로 처리됩니다.

키는 클라이언트에서 생성하며 UUIDv4 면 충분합니다. 키를 보내지 않으면 재시도마다 크레딧이 새로 차감되고 Torii 가 다시 실행됩니다.

이미지 번역

동기식 엔드포인트입니다. base64 로 인코딩된 번역 이미지를 반환하며, data:image/png;base64, 접두사가 포함됩니다.

Base URL

https://api.imagetranslate.ai

요청 본문

응답

예제

curl -X POST https://api.imagetranslate.ai/translate/image \
  -H "Authorization: Bearer $IMAGETRANSLATE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "imageBase64": "YOUR_BASE64_IMAGE",
    "sourceLanguage": "ja",
    "targetLanguage": "en",
    "mode": "general",
    "translator": "Grok"
  }'

응답 예시

{
  "success": true,
  "recordId": "Z3l4abc...",
  "resultImage": "data:image/png;base64,iVBORw0KGgoAAAANSU...",
  "remainingCredit": 9990
}

오류 코드

오류 응답 형식

• 4xx / 500: { "detail": "<message>" }
• 422: { "detail": [{ "loc": [...], "msg": "...", "type": "..." }] }
• 409: { "error": "idempotency_replay", "recordId": "<id>", "message": "..." }

속도 제한

API key 단위로 분당 요청 수가 제한되며, 한도는 플랜에 따라 다릅니다.

더 높은 한도가 필요하다면 [email protected] 로 문의해 주십시오.

요금

호출당 advanced credit 10 포인트가 차감됩니다. 플랜과 크레딧 패키지에 대한 자세한 내용은 요금 페이지를 참고하십시오.

부록

언어 코드

sourceLanguage 에는 ISO 639-1 / BCP-47 코드 또는 auto(자동 감지)를 사용할 수 있습니다. targetLanguage 는 동일한 코드 셋을 따르되, auto 는 사용할 수 없습니다.

자주 사용되는 코드:

mode 값

mode 는 렌더링 스타일을 결정합니다. 이미지 내용에 가장 적합한 값을 선택합니다.

translator 모델

translator 는 번역을 수행할 AI 모델을 지정합니다. 모든 모델은 호출당 10 포인트가 차감됩니다.

• Grok (기본)
• Gemini
• Deepseek
• ChatGPT
• Claude

시작하기

연동할 준비가 되었다면 첫 API key 발급하기 →