빠른 시작
키 발급부터 첫 응답까지 5분이면 됩니다.
1. API 키 발급
웹앱 설정 > 개발자 도구에서 API 키를 만듭니다. dai_live_… 형태의 키가 발급 시 한 번만 표시되니 안전하게 보관하세요.
키에는 스코프(권한)를 부여합니다. 대화만 하려면 chat 하나면 충분해요. → 인증 & 스코프
워크스페이스 ID(
:id)와 기본 URL도 같은 화면의 "연결 정보"에서 복사할 수 있습니다.
2. 첫 메시지 보내기 (스트리밍)
curl -N -X POST https://daiops.com/api/v1/workspaces/$WS/messages \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"command": "이번 주 할 일 정리해줘"}'
응답은 Server-Sent Events로 흐릅니다:
event: open
data: {"session_id":"…"}
event: text
id: 12
data: {"v":1,"text":"이번"}
event: text
id: 13
data: {"v":1,"text":" 주"}
event: done
data: {"v":1,"session_id":"…"}
open→ 세션 시작(세션 ID 통지)text→ 토큰 단위 응답(델타, 누적 아님)done→ 스트림 종료(항상 마지막 1회)
3. 최종 결과만 받고 싶다면 (블로킹)
stream: false를 주면 SSE 대신 완성된 JSON을 한 번에 받습니다.
curl -X POST https://daiops.com/api/v1/workspaces/$WS/messages \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"command": "이번 주 할 일 정리해줘", "stream": false}'
# → { "success": true, "output": "…", "session_id": "…" }
4. 대화 이어가기
caller_id를 매번 같은 값으로 주면 이전 대화 맥락이 이어집니다.
-d '{"command": "아까 그거 더 자세히", "caller_id": "user-42"}'
→ 세션·이어쓰기·과거 조회는 세션 & 대화 이어쓰기