번역 API
스크립트에서 Edgepedia 번역으로 문서를 보내고 번역 결과를 받아 보세요. 번역 페이지와 동일한 서비스로, 요금도 같으며 같은 크레딧 잔액에서 차감됩니다.
API 키 발급
번역 페이지에서 키를 생성하세요. 로그인한 뒤 오른쪽 위의 계정 메뉴를 열고 API 키 아래에서 생성을 선택하면 됩니다.
모든 요청에 Authorization: Bearer ept_… 형식으로 키를 전송하세요. 키를 가진 사람은 누구나 여러분의 크레딧을 사용할 수 있으니 외부에 노출하지 마세요.
요금
- 일반: 250단어당 1크레딧(최소 1크레딧).
- Pro: 75단어당 1크레딧(최소 2크레딧).
- 원문 언어와 번역 언어가 모두 영어가 아닌 경우 요금은 두 배입니다.
- 100크레딧 = USD 1.
번역에 실패하면 크레딧이 환불됩니다.
엔드포인트
기본 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
상태 코드
| 코드 | 의미 |
|---|---|
| 200 | OK. wait를 사용한 번역 시작 요청이라면 번역이 완료되었거나 실패한 상태입니다. |
| 202 | 번역이 시작되었거나, wait에 지정한 시간이 지나도 진행 중입니다. |
| 400 | 전송된 요청대로 번역할 수 없습니다. 오류에 사유가 표시됩니다. |
| 401 | 키가 누락되었거나, 알 수 없거나, 폐기되었습니다. |
| 402 | 크레딧이 부족합니다. |
| 404 | 계정에 해당 번역이 없습니다. |
| 409 | 요금이 expect_credits와 일치하지 않습니다. 요금은 청구되지 않았습니다. |
| 413 | 파일이 10 MB를 초과합니다. |
| 429 | 1분 동안 요청이 60회를 초과했습니다. Retry-After 헤더에 표시된 초만큼 기다린 후 다시 시도해 주세요. |