logoTranslateManga

API

요청마다 만화 이미지 한 장을 제출하고, 번역된 PNG를 base64로 포함한 JSON payload를 받습니다.

API Keys
Credits--
로딩 중
예제
curl -X POST https://translatemanga.net/api/v1/translate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@page.png" \
  -F "targetLanguage=English" \
  -F "model=default" \
  -o response.json
API Reference

Endpoint

필드
method
타입
enum
의미
번역 endpoint에서 사용하는 HTTP method입니다.
값
POST
필드
url
타입
string
의미
단일 이미지 번역용 프로덕션 endpoint입니다.
값
https://translatemanga.net/api/v1/translate
필드
request body
타입
format
의미
요청 body 형식입니다.
값
multipart/form-data
필드
response body
타입
format
의미
성공 및 오류 응답 모두 JSON을 반환합니다.
값
application/json

Authentication

필드
Authorization
타입
string
필수
예
의미
이 페이지에서 생성한 API key를 Bearer token으로 사용합니다.
값
Bearer YOUR_API_KEY

Request

필드
image
타입
File
필수
예
의미
번역할 원본 만화 이미지입니다. 요청마다 한 장만 지원합니다.
값
image/*

최대 파일 크기: 5MB.

필드
targetLanguage
타입
string
필수
예
의미
번역 텍스트의 대상 언어입니다.
값
English
Japanese
Chinese (simplified)
Chinese (traditional)
Korean
Spanish

필드
model
타입
string
필수
아니요
의미
번역 모델입니다. 기본값은 default입니다.
값

필드
font
타입
string
필수
아니요
의미
번역 텍스트를 렌더링할 때 사용할 글꼴입니다. 기본값은 CCWildWords.otf입니다.
값
CCWildWords.otf
Kalam.ttf
Bangers-Regular.ttf
KomikaJam.ttf
KomikaSlim.ttf
PatrickHand-Regular.ttf
VtcLettererPro.ttf

Response

필드
success
타입
boolean
의미
항상 포함됩니다. 요청 성공 여부를 나타냅니다.
값
false
true
필드
translated_image
타입
string
의미
success가 true일 때 포함됩니다. data URL prefix가 없는 base64 PNG입니다.
값
base64 PNG
필드
mimeType
타입
string
의미
success가 true일 때 포함됩니다. 번역된 이미지의 MIME type입니다.
값
image/png
필드
traceId
타입
string
의미
디버깅용 요청 trace ID입니다. 성공 및 오류 응답 모두에 포함됩니다.
값
-
필드
creditCost
타입
number
의미
success가 true일 때 포함됩니다. 이 요청에서 사용한 유료 credits입니다.
값
-
필드
remainCredit
타입
number
의미
success가 true일 때 포함됩니다. 요청 후 남은 유료 credits입니다.
값
-
필드
error
타입
string
의미
success가 false일 때 포함됩니다. 사람이 읽을 수 있는 오류 메시지입니다.
값
-
필드
errorCode
타입
enum
의미
success가 false일 때 포함됩니다. 안정적인 machine-readable 오류 코드입니다.
값
UNAUTHORIZED
MISSING_IMAGE
INVALID_IMAGE_TYPE
IMAGE_TOO_LARGE
UNSUPPORTED_TARGET_LANGUAGE
UNSUPPORTED_MODEL
UNSUPPORTED_FONT
NO_CREDITS_LEFT
TRANSLATION_FAILED