Quickstart · 5분이면 충분합니다
Hello, Cheez!
고객응대, 심리상담, 교육, 영어회화, 취미토킹—
어떤 서비스든 실제 인물 같은 페르소나를 얹을 수 있습니다.
# 컨셉 한 줄 → 말투·배경·성격까지 갖춘 실제 인물로
curl -X POST https://api.cheez.im/api/v1/characters/generate \
-H "X-API-Key: ck_live_••••••••••••••••" \
-d '{"concept": "10년 경력 입시 강사. 칭찬 없이 팩트만 말하지만 결국 합격시킨다."}'
# → speechPattern, background, secret, forbiddenBehaviors ... 자동 설계
# 캐릭터와 첫 대화
curl -X POST https://api.cheez.im/api/v1/chat/send \
-H "X-API-Key: ck_live_••••••••••••••••" \
-d '{"characterId":"char_xK9m2vLp","userId":"user_001","content":"공부 어떻게 시작하면 돼요?"}'
# → "오늘 뭘 공부했어? '열심히'는 답 아니야. 구체적으로 말해봐."
3단계로 시작하기
세계관을 가진 캐릭터를 만들고, 첫 번째 대화를 시작하세요.
1
API 키 발급
도입 문의 후 API 키를 발급받습니다. ck_live_ 형식의 키 하나로 테넌트 식별까지 자동 처리됩니다.
# 모든 요청에 포함 — 키 하나로 테넌트 자동 식별
X-API-Key: ck_live_••••••••••••••••
Content-Type: application/json
2
실제 인물 같은 페르소나 생성
POST /api/v1/characters/generate에 컨셉 한 줄을 보내면 이름·말투·배경·비밀·금지행동까지 자동 설계됩니다. AI 말투가 아닌, 실제 인물처럼 대화합니다.
// Request — 컨셉만 넘기면 됩니다
{
"concept": "10년 경력 입시 강사. 칭찬 없이 팩트만 말하지만 결국 합격시킨다."
}
// Response — 페르소나가 자동 설계됩니다
{
"success": true,
"data": {
"name": "강민준",
"speechPattern": "짧고 직설적. 완성되지 않은 문장은 잘라낸다.",
"motivation": "학생이 포기하지 않으면 나도 포기하지 않는다.",
"introMessage": "오늘 뭐 공부했어. 바로 말해봐."
// ... personality, background, forbiddenBehaviors 등
}
}
3
캐릭터와 첫 대화
POST /api/v1/chat/send에 캐릭터 ID와 메시지를 보내면 됩니다. DNM 엔진이 페르소나·말투·세계관을 유지하며 응답합니다.
// Request
{
"characterId": "char_xK9m2vLp",
"userId": "user_001",
"content": "오늘 운세 봐줘"
}
대화 흐름 — 수업 시작 → 감정 코칭
강민준
오늘 뭐 공부했어. 시간이랑 과목, 바로 말해봐.
유저
요즘 좀 힘들어서... 공부가 잘 안 돼요.
강민준
*펜을 내려놓는다*
힘들다는 게, 공부가 힘든 건지 다른 게 힘든 건지. 구분해봐.
유저
그냥... 다 힘든 것 같아요.
강민준
*조용히 앉아서*
그래. 다 힘들 때 있어. 오늘은 교재 덮어. 뭐가 제일 무거워?
어떤 서비스에든 붙일 수 있습니다
캐릭터의 컨셉만 바꾸면 됩니다. 엔진은 동일합니다.