Developers
LOOP API 빠른 시작
REST API로 요약·번역·워크플로우 실행을 우리 제품 안에서. (데모 문서)
인증
모든 요청 헤더에 API 키를 담아 보냅니다. 키는 워크스페이스 설정 → 개발자에서 발급해요.
# API 키는 서버 환경변수로 보관하세요
curl https://api.loop.demo/v1/me \
-H "Authorization: Bearer $LOOP_API_KEY"
curl https://api.loop.demo/v1/me \
-H "Authorization: Bearer $LOOP_API_KEY"
문서 요약
텍스트 또는 파일 URL을 보내면 요약이 반환됩니다.
POST /v1/summarize
{
"input": "긴 계약서 텍스트…",
"style": "bullet", // bullet | paragraph | tldr
"lang": "ko"
}
{
"input": "긴 계약서 텍스트…",
"style": "bullet", // bullet | paragraph | tldr
"lang": "ko"
}
// 200 OK
{
"summary": "• 계약 기간은 12개월…",
"credits_used": 1
}
{
"summary": "• 계약 기간은 12개월…",
"credits_used": 1
}
워크플로우 실행
빌더에서 만든 워크플로우를 API로 트리거할 수 있어요.
POST /v1/workflows/{workflow_id}/run
{
"inputs": { "file_url": "https://…/report.pdf" }
}
{
"inputs": { "file_url": "https://…/report.pdf" }
}
웹훅
실행 완료 시 지정 URL로 결과를 push합니다. 서명 헤더(X-Loop-Signature)로 위변조를 검증하세요.
{
"event": "workflow.completed",
"run_id": "run_8f2k1",
"output": { … }
}
"event": "workflow.completed",
"run_id": "run_8f2k1",
"output": { … }
}
요청 한도
Starter 10 req/min · Pro 60 req/min · Business 무제한(공정 사용). 초과 시 429와 Retry-After 헤더가 반환됩니다.