BYOK 베타 안내 · 내 API 키 연결과 사용법

유저분들이 자유롭게 더 재밌는 작품을 만들고, 더 자유롭고 저렴한 채팅 경험을 위해 출시한 기능을 공개합니다.

BYOK가 뭐예요?

내가 발급받은 AI API 키를 아스텔챗에 연결해 대화하는 기능이에요. BYOK는 Bring Your Own Key, ‘내 키를 가져와 사용한다’는 뜻이에요.

지원하는 제공사에서 키를 발급받아 연결하고, 내 작품의 채팅방에서 사용할 모델을 선택하면 돼요.

API 키 없이 기존 채팅도 스타를 소모해 그대로 이용할 수 있어요.

이용료 안내

BYOK 서비스 이용료는 한시적으로 0%로 운영합니다.

AI 제공사의 API 사용 요금은 별도예요. 유료 모델은 해당 제공사의 결제 설정이나 크레딧이 필요할 수 있어요.

1. 내 API 키 연결하기

1. 마이페이지 → 내 API 연결을 열어요.
2. 사용할 제공사를 선택해요.
3. 키 발급받기에서 제공사의 API 키를 발급받아요. 이미 키가 있다면 그대로 사용할 수 있어요.
4. 발급받은 키를 붙여 넣고 연결 확인을 눌러요.
5. 연결됨 표시가 나오면 준비 완료예요.

지원하는 제공사

• Google Gemini · AI Studio: 키 발급받기. AI Studio에서 발급한 키를 사용해요. Vertex AI 연결은 지원하지 않아요.
• OpenRouter: 키 발급받기.
• Claude: 키 발급받기.
• OpenAI: 키 발급받기.

ChatGPT 구독과 OpenAI API 결제는 별개예요.

2. 채팅방에서 사용하기

1. 본인 소유 작품의 채팅방에서 모델 설정을 열어요.
2. 내 API 키 사용 탭을 선택해요.
3. 연결한 제공사와 사용할 모델을 선택해요. 이름이나 모델 ID로 검색할 수 있어요.
4. 하단의 이 방에서 사용을 눌러 적용해요.

키를 연결하는 것만으로 모든 채팅방에 적용되지는 않아요. 사용할 모델까지 선택하고 적용해 주세요. 이용 가능한 모델은 제공사와 계정에 따라 달라질 수 있어요.

다른 방에서도 기본으로 사용하고 싶어요

채팅방에서 연결과 기본 모델을 먼저 선택한 뒤, 마이페이지의 내 작품에서 기본으로 사용을 켜 주세요. 사용 조건을 충족하는 방에 기본 설정이 적용되며, 개별 방에서 직접 켜거나 끈 설정은 유지돼요.

사용할 수 있는 작품과 자료

BYOK는 API 제공사의 로그 등을 통해 요청에 포함된 프롬프트를 API 키 소유자가 확인할 수 있어요. 타인의 프롬프트를 보호하기 위해 본인 소유 작품에서만 사용하도록 제한합니다.

• 본인 소유의 캐릭터·비주얼 노벨 작품은 공개·링크 공유·비공개 여부와 관계없이 사용할 수 있어요.
• 다른 사람이 만든 작품에서는 사용할 수 없어요.
• 연결된 세계관도 본인 소유여야 해요.
• 타인의 비공개 자료가 포함되거나, 연결된 자료의 이용 조건을 충족하지 않는 방에서는 사용할 수 없어요.
• 공유받거나 분기해서 만든 대화 등 일부 채팅방에서는 사용할 수 없어요. 성인 작품·세계관은 성인 이용 조건도 충족해야 해요.

연결 자료나 소유 관계가 바뀌어 사용 조건을 충족하지 못하게 되면, 해당 방의 BYOK 이용이 중단될 수 있어요.

기억 요약도 내 API 키로 쓸 수 있나요?

네. 답변 모델과 기억 요약 모델은 따로 설정할 수 있어요.

기억 요약 설정에서 기억 요약에 내 API 키 사용을 켜고, 사용할 모델을 선택해 주세요. 기억 요약 조건을 충족하는 모델만 선택할 수 있어요.

대화에 BYOK를 사용해도 기억 요약을 따로 설정하지 않으면, 서비스 기억 모델을 사용하며 스타로 결제돼요. 설정 변경은 새로 예약되는 기억 요약부터 적용되고, 이미 예약된 작업은 예약 당시 설정을 사용해요.

보안 및 키 관리 안내

개인 API 키는 암호화된 상태로 데이터베이스에 저장됩니다. 암호화·복호화에 사용하는 키는 Google Cloud KMS에서 관리합니다.

API 키는 비밀번호처럼 관리하고, 채팅이나 공개 게시글에 올리지 마세요. 연결한 키는 내 API 연결 화면에서 교체하거나 휴지통 버튼으로 삭제할 수 있어요.

아스텔챗에서 연결을 삭제하는 것과 제공사에서 키를 폐기하는 것은 별개예요. 키가 외부에 노출됐다면 발급한 제공사에서도 폐기해 주세요.

BYOK를 사용하면 답변·요약 생성에 필요한 내용이 선택한 AI 제공사로 전달돼요. 제공사의 데이터 처리 정책을 확인하고, 보내고 싶지 않은 개인정보는 대화에 입력하지 마세요.

연결이 안 되거나 대화가 멈췄나요?

• 키가 유효하지 않아요: 만료·삭제 여부를 확인하고 내 API 연결에서 키를 교체해 주세요.
• 제공사 잔액이 부족해요: 제공사의 크레딧과 결제 설정을 확인해 주세요.
• 모델을 사용할 수 없어요: 계정의 모델 사용 권한을 확인하거나 다른 모델을 선택해 주세요.
• 사용 한도에 도달했어요: 제공사 한도를 확인하고 잠시 후 다시 시도해 주세요.
• 이 작품에서 사용할 수 없어요: 본인 소유 작품인지, 세계관이 본인 소유인지, 타인의 자료가 포함되어 있지 않은지 확인해 주세요.

일반 방식으로 대화를 이어가려면 모델 설정 → 내 API 키 사용을 꺼 주세요. 다음 답변부터 일반 스타 요금이 적용돼요. 기억 요약에 내 API 키를 설정했다면 그 설정도 별도로 확인해 주세요.