에이전트 연동
코딩 에이전트에서 바로 사용하거나 표준 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://test.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://test.equalang.com/v1/jobs/$JOB_ID" \
-H "Authorization: Bearer $EQ_API_KEY"
# SUCCEEDED 상태에서는 data.download_url을 열어 결과를 다운로드하세요.엔드포인트 참조
아래 엔드포인트 목록은 현재 배포된 서비스의 OpenAPI Schema에서 직접 읽어옵니다. 서비스와 함께 업데이트되므로 구현과 맞지 않는 문서가 되지 않습니다.
OpenAPI Schema를 불러오는 중...
참고 자료
OpenAPI는 API의 유일한 구조화된 계약입니다.