빠른 시작
첫 번째 패널을 위한 세 단계
2
SDK 설치
하나의 명령. 요청 외에는 종속성 없음.
pip install kronaxis
3
첫 번째 패널 생성
타겟 인구 통계를 정의하고 첫 번째 질문을 하세요. 몇 분 안에 결과가 나옵니다.
Python SDK
몇 분 안에 프로덕션 준비 완료
Python
from kronaxis import PanelStudio ps = PanelStudio(api_key="your_key") # 패널 생성 panel = ps.panels.create( name="UK Retail Panel", country="GB", size=100, demographics={"age_range": "25-54"} ) # 자극 실행 result = ps.conversations.create( panel_id=panel["id"], stimulus="Your favourite brand just increased prices by 20%. What do you do?", sample_size=50 ) # 결과 내보내기 ps.export.jsonl(panel["id"], path="results.jsonl")
주요 엔드포인트
핵심 API 경로
Panel Studio는 패널, 페르소나, 대화, 내보내기, 설문조사 및 통합 전반에 걸쳐 226개의 경로를 제공합니다. 다음은 가장 일반적으로 사용되는 경로입니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| POST | /api/panels | 새 패널 생성 |
| GET | /api/panels | 패널 목록 보기 |
| POST | /api/panels/{id}/conversations | 대화 시작 |
| POST | /api/panels/{id}/conversations/{cid}/turns | 후속 턴 추가 |
| GET | /api/panels/{id}/personas | 패널 페르소나 목록 보기 |
| POST | /api/panels/{id}/export/jsonl | JSONL로 내보내기 |
| POST | /api/panels/{id}/export/parquet | Parquet으로 내보내기 |
| POST | /api/panels/{id}/export/pptx | PowerPoint로 내보내기 |
| POST | /api/webhooks | 웹훅 구독 생성 |
| GET | /api/integrations | 사용 가능한 통합 목록 보기 |
인증
간단한 API 키 인증
모든 요청에 X-API-Key 헤더에 API 키를 전달하세요. 키는 등록 시 즉시 발급됩니다.
curl -H "X-API-Key: your_key" \
https://panel.kronaxis.co.uk/api/panels
무료 티어
월 10개의 페르소나, 10개의 질문. 전체 API 접근. 신용 카드 불필요.
유료 티어
무제한 페르소나 및 질문. 인과 추론 추적. 우선 지원. 자세한 내용은 가격을 참조하세요.
웹훅
실시간 이벤트 전달
모든 웹훅은 비밀 키를 사용하여 HMAC SHA-256으로 서명됩니다. X-Kronaxis-Signature 헤더를 서버 측에서 확인하여 진위 여부를 보장하세요. 실패한 전송은 지수 백오프 방식으로 재시도됩니다.
conversation.completed
모든 페르소나 응답이 한 턴에 대해 수집될 때 발생합니다.
panel.created
새 패널 구축이 완료되고 페르소나가 준비될 때 발생합니다.
export.ready
JSONL, Parquet 또는 PPTX 내보내기 파일 다운로드가 준비될 때 발생합니다.