edgepedia 번역

번역 API

스크립트에서 Edgepedia 번역으로 문서를 보내고 번역 결과를 받아 보세요. 번역 페이지와 동일한 서비스로, 요금도 같으며 같은 크레딧 잔액에서 차감됩니다.

API 키 발급

번역 페이지에서 키를 생성하세요. 로그인한 뒤 오른쪽 위의 계정 메뉴를 열고 API 키 아래에서 생성을 선택하면 됩니다.

모든 요청에 Authorization: Bearer ept_… 형식으로 키를 전송하세요. 키를 가진 사람은 누구나 여러분의 크레딧을 사용할 수 있으니 외부에 노출하지 마세요.

요금

번역에 실패하면 크레딧이 환불됩니다.

엔드포인트

기본 URL: https://translate.edgepedia.ai. 요청과 응답은 JSON 형식이며, 오류 형식은 {"error": "…"}입니다.

GET /api/v1/languages

언어 목록과 각 언어의 Pro 지원 여부를 반환합니다.

curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages

GET /api/v1/balance

남은 크레딧을 반환합니다.

curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance

POST /api/v1/quote

번역을 시작하지 않고 요금과 예상 소요 시간을 반환합니다. mode는 standard 또는 pro입니다.

견적 요청에는 "source": "auto"도 사용할 수 있습니다. 응답의 "source"에 감지된 언어가 "detected": true와 함께 표시되며, 번역은 그 언어 코드로 시작하면 됩니다.

curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard"}' \
  https://translate.edgepedia.ai/api/v1/quote

POST /api/v1/translations

텍스트 또는 최대 10 MB의 .txt, .md, .docx, .pdf 파일 번역을 시작합니다. 요금이 예상과 다를 때 요청을 거부하도록(409) 하려면 "expect_credits"를 추가하세요. 같은 응답으로 완료된 번역을 받으려면 "wait"를 추가하세요(최대 120초).

curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard", "wait": 60}' \
  https://translate.edgepedia.ai/api/v1/translations

curl -H "Authorization: Bearer $KEY" -F file=@report.docx -F source=en -F target=ar -F mode=standard \
  https://translate.edgepedia.ai/api/v1/translations

GET /api/v1/translations/{id}

번역 상태(queued, running, done, failed)와 완료된 경우 번역문을 반환합니다. 실패한 경우에는 사유를 알려 줍니다. 완료된 번역은 30일 동안 조회할 수 있습니다.

curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID

GET /api/v1/translations/{id}/download

파일 번역 결과를 반환합니다. .docx 및 .pdf 파일은 .docx로, .txt 및 .md 파일은 텍스트로 반환합니다.

curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download

GET /api/v1/translations

최근 번역부터 최대 50개의 번역 목록을 반환합니다.

curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations

상태 코드

코드의미
200OK. wait를 사용한 번역 시작 요청이라면 번역이 완료되었거나 실패한 상태입니다.
202번역이 시작되었거나, wait에 지정한 시간이 지나도 진행 중입니다.
400전송된 요청대로 번역할 수 없습니다. 오류에 사유가 표시됩니다.
401키가 누락되었거나, 알 수 없거나, 폐기되었습니다.
402크레딧이 부족합니다.
404계정에 해당 번역이 없습니다.
409요금이 expect_credits와 일치하지 않습니다. 요금은 청구되지 않았습니다.
413파일이 10 MB를 초과합니다.
4291분 동안 요청이 60회를 초과했습니다. Retry-After 헤더에 표시된 초만큼 기다린 후 다시 시도해 주세요.