무료 API 키로 실리태번에 Hojicha 연결하고 캐릭터 카드 받기

계정에서 API 키 만들기.

Hojicha는 구수하고 따뜻한 대화에 살짝 짓궂은 한 스푼을 더한 Teasa의 대화 스타일입니다.

필요한 설정값

서버 URL은 표에 있는 그대로 입력하세요. 실리태번이 완료 경로를 자동으로 붙이므로 /chat/completions를 따로 붙이지 마세요. 실리태번 공식 연결 가이드(영어)에서 Custom 연결 항목을 확인할 수 있습니다.

1. Teasa API 키 만들기

Teasa 계정에 로그인해 실리태번에서 Teasa 사용하기를 찾으세요. 키에 이름을 붙이고 API 키 생성을 선택합니다. 화면에 표시되는 동안 비밀 값을 복사해 두세요. 한 번만 표시되므로 안전하게 보관하고, 공개 캐릭터 카드나 스크린샷, 공유 프리셋에는 절대 포함하지 마세요.

키를 만든다고 잔액이 늘어나지는 않습니다. 체험용 크레딧은 Teasa 관리자가 계정당 한 번만 지급할 수 있습니다. 모든 키는 같은 잔액을 공유하며, 새 키를 만들어도 잔액이 다시 채워지지 않습니다. API 잔액은 Teasa Pass, 젬, 앱 내 대화와는 별개입니다.

2. 연결하고 Hojicha 선택하기

실리태번에서 API Connections를 열고 Chat Completion, 이어서 **Custom (OpenAI-compatible)**를 선택하세요. 표에 있는 서버 URL과 키를 입력합니다. 연결한 뒤 모델 목록에서 hojicha를 선택하세요. chai로 설정해 둔 기존 연결도 그대로 작동합니다.

먼저 텍스트 대화로 시작하고, 컨텍스트 크기는 32,256, 응답 한도는 1,500으로 두세요. 도구 호출, 이미지 입력, 구조화된 JSON 출력은 꺼두세요. 이 API 체험판에는 Hojicha만 포함됩니다. Matcha는 Teasa 앱 안에서 선택할 수 있는 별도의 대화 스타일로, 이 API 체험판에는 포함되지 않습니다.

3. 무료 시작 캐릭터 불러오기

렌 키사라기는 길모퉁이 헌책방을 운영합니다. 어렴풋이 기억나는 한 문장만으로도 책을 찾아내지만, 누군가에게 차 한잔 더 하고 가라는 말은 유독 어려워하는 사람입니다. 오늘 밤 그는 마지막 진열대를 마무리해야 하는데, 무엇을 놓을지에 대해 서로 다른 두 가지 생각을 품고 있습니다.

이 오리지널 캐릭터는 노골적인 묘사가 없으며, 성인 캐릭터와 성인 플레이어를 위해 쓰였습니다. 조용한 우정으로 시작해도 좋고, 책 취향으로 티격태격해도 좋고, 대화를 통해 로맨스로 발전시켜도 좋습니다.

렌의 영어 캐릭터 카드 V2 다운로드

렌의 일본어 캐릭터 카드 V2 다운로드

실리태번의 Character Management에서 Import character를 선택하고 다운로드한 .json 파일을 고르세요. 렌의 채팅을 열면 바로 시작할 수 있습니다. JSON 파일에는 캐릭터 설정, 오프닝, 대화 예시가 들어 있으며, 초상화는 실리태번에서 직접 추가할 수 있습니다.

첫 메시지로 이런 대사를 시도해 보세요.

"'잠 못 이루게 하는 책들'이라는 진열대에는 끔찍한 사랑 이야기가 최소 한 권은 있어야 하지 않을까요? 당신이 고른다면 어떤 책이에요?"

혹은 그의 제안을 거절해도 괜찮습니다. "5분밖에 못 있어요." 렌의 설정에는 자기만의 취향, 가게 밖의 삶, 거절을 받아들이는 방식까지 담겨 있습니다. 어떤 대답을 하든 그 장면에 무엇을 더할지는 당신의 몫입니다.

이미 마음에 드는 카드가 있다면 그걸 써도 좋습니다. Creator Studio에서 재사용 가능한 캐릭터를 만들고 SillyTavern용으로 내보내기를 열어 JSON이나 카드 정보가 담긴 PNG로 받을 수도 있습니다. 캐릭터 카드 작성 가이드가 목소리, 동기, 답하고 싶어지는 오프닝을 만드는 데 도움이 됩니다.

4. 첫 응답이 잘 왔는지 확인하기

메시지를 하나 보내고 응답을 기다리세요. 그런 다음 Teasa 계정의 최근 요청을 새로고침하면 상태, 토큰 사용량, 차감된 크레딧을 확인할 수 있습니다. 연결 표시만으로는 부족하고, 실제로 응답이 도착하는지까지 확인해야 연결과 생성이 모두 정상임을 알 수 있습니다.

첫 대화를 알차게 쓰려면 렌에게 진열대에 대해 물어보고, 추천 하나에 반박한 뒤, 더 머물지 결정해 보세요. 카드를 수정하고 새 채팅을 시작하면 오프닝을 비교할 수 있습니다. 응답을 생성할 때마다 체험용 크레딧이 차감됩니다.

연결, 모델, 컨텍스트 오류 해결하기

권장 컨텍스트 값은 32,768토큰인 모델 창 안에서 Teasa의 형식 조정 계층이 쓸 여유를 남겨둔 값입니다. 캐릭터 설정, 세계관 정보, 이력이 모두 컨텍스트를 사용하므로, 긴 채팅에서 오류가 나면 설정값을 더 낮추세요. 실리태번의 캐릭터와 컨텍스트 설명(영어)도 참고하세요.

해결되지 않는 오류는 시간, 표시된 오류 문구, 관련 설정값을 적어 Teasa 지원팀(영어)에 문의하세요. 스크린샷을 보낼 때는 API 키와 개인적인 대화 내용을 가려주세요.

체험용 크레딧과 대화 기록

체험판 사용량은 입력 100만 토큰당 0.05달러, 출력 100만 토큰당 0.22달러로 계산됩니다. 이 체험판에는 자동 충전이나 유료 재충전이 없습니다. 남은 잔액으로 감당할 수 없으면 요청이 중단됩니다. 최종 사용량을 받지 못한 취소·중단 요청은 예약된 최대치로 청구되며 추정치로 표시됩니다.

프롬프트와 응답은 추론 제공업체로 전송되며, 계정의 대화 보존 설정에 따라 지원과 품질 검토를 위해 기록됩니다. 계정에서 키를 무효화하거나 API 대화 기록을 삭제할 수 있습니다. 실리태번 자체의 로컬 채팅은 별도로 관리됩니다. 개인정보를 보내기 전에 개인정보 처리방침을 확인하세요.

Teasa에서 이야기도 즐겨보세요

플레이 가능한 이야기, 퀘스트, 관계 마일스톤, 캐릭터와의 직접 채팅을 원한다면 Teasa를 둘러보세요. 이런 경험은 Teasa 안에서 실행되며, 모델 API를 연결한다고 실리태번에 추가되지 않습니다. 실리태번 채팅과 Teasa 이야기 플레이는 서로 별개로 유지됩니다.

계정에서 Hojicha 연결 시작하기. API에 대한 자세한 사양은 공개 어댑터 가이드(영어)에서 확인할 수 있습니다.

FAQ

실리태번에서 무료 API 체험판을 쓸 수 있나요?

Teasa 관리자가 계정에 체험용 크레딧을 지급한 경우에만 가능합니다. 새 계정의 API 크레딧은 0달러이며, 키를 만든다고 무료 체험판이 활성화되지는 않습니다. 관리자는 계정당 한 번, 1달러 잔액을 지급할 수 있습니다. 자동 결제나 무제한 무료 API 이용은 없습니다.

실리태번에 Teasa를 연결하려면 어떤 URL과 모델을 입력해야 하나요?

Chat Completion과 Custom (OpenAI-compatible)을 선택하세요. 서버 URL로 https://teasa.ai/model-api/v1을, 모델 ID로 hojicha를 사용하고, Teasa API 키를 입력하세요.

이 API 키로 Matcha도 사용할 수 있나요?

이 체험판은 Hojicha만 제공합니다. Matcha는 Teasa 앱 안에서 선택할 수 있는 별도의 대화 스타일로, 이 API 키로는 이용할 수 없습니다.

실리태번 시작용 캐릭터 카드는 어디서 받을 수 있나요?

이 문서에서 성인 헌책방 주인 렌 키사라기의 오리지널 캐릭터 카드 V2 JSON을 영어와 일본어 버전으로 다운로드할 수 있습니다. 실리태번의 Character Management에서 원하는 파일을 불러오세요. 이 카드에는 초상화나 API 키가 포함돼 있지 않습니다.

이 API로 Teasa의 메모리와 퀘스트도 실리태번에서 쓸 수 있나요?

이 API는 실리태번이 전달하는 캐릭터 설정과 대화 맥락으로 응답을 생성합니다. Teasa의 이야기 퀘스트, 관계 마일스톤, 저장된 플레이어 메모리, 검색 기능이 있는 직접 채팅은 Teasa 안에서 작동하는 기능으로, 이 연결을 통해서는 동기화되지 않습니다.