에이전트 연동
코딩 에이전트에서 바로 사용하거나 표준 API로 직접 호출하세요.
세 가지 방법
Claude Code, Codex, Cursor 또는 모든 코딩 에이전트에서 Equalang을 사용하세요. 세 가지 방법 모두 동일한 크레딧 잔액을 공유합니다.
설정이 필요 없습니다.이 문장을 에이전트에 복사하여 붙여넣으면 에이전트가 설치 가이드를 읽고, 스킬을 로드 디렉토리에 클론한 후 키를 요청합니다.
프롬프트
Install the Equalang skill by following the instructions at https://equalang.com/install/skill-install.md
세 가지 방법 모두 API 키가 필요합니다.API 키 발급
개요
한 번의 요청으로 문서를 업로드하고 번역 작업을 만든 뒤, 진행 상황을 조회하고 결과를 다운로드합니다. 이미 업로드한 파일도 재사용할 수 있습니다.
- API 기본 경로
- /v1
- 응답 형식
- 비즈니스 엔드포인트는 통일된 JSON 구조를 반환하며, 파일 엔드포인트는 바이너리를 반환합니다. OpenAPI Schema는 표준 JSON입니다.
- 과금
- 웹사이트와 잔액을 공유하며 원문 token 기준으로 계산합니다. 실제 청구액은 usage.credits_charged에 표시됩니다. 번역 완료 후 결과 전달이 실패한 경우에도 요금이 부과됩니다.
인증
계정에서 API 키를 생성하고, 보호된 모든 요청의 Authorization 헤더에 Bearer Token으로 전송하세요.
HTTP
Authorization: Bearer el_...
첫 번째 작업 만들기
문서를 업로드하고 대상 언어를 선택한 뒤 job_id로 진행 상황을 확인하세요.
curl --fail-with-body "https://equalang.com/v1/jobs/translate" \
-H "Authorization: Bearer $EQ_API_KEY" \
-F "file=@report.pdf" \
-F "target_language=zh-CN"
# -> { "data": { "job_id": "..." } }
# 반환된 job_id를 사용하세요. data.finished가 true가 될 때까지 반복하세요.
curl --fail-with-body "https://equalang.com/v1/jobs/$JOB_ID" \
-H "Authorization: Bearer $EQ_API_KEY"
# SUCCEEDED 상태에서는 data.download_url을 열어 결과를 다운로드하세요.엔드포인트 참조
OpenAPI Schema를 불러오는 중...
참고 자료
OpenAPI는 API의 유일한 구조화된 계약입니다.