플레이그라운드

이미 API Key를 생성했지만 바로 코드를 작성할 준비는 되지 않았다면, 가장 간단한 검증 방법은 먼저 사이트 내 플레이그라운드를 사용하는 것입니다.

플레이그라운드의 가치는 단순히 “몇 마디 대화해 보는 것”에 그치지 않고, 다음 사항을 빠르게 확인할 수 있게 해준다는 데 있습니다.

• 현재 계정으로 모델을 정상 호출할 수 있는지
• 현재 Group에서 사용 가능한 모델이 정상 동작하는지
• 특정 모델의 대략적인 응답 경험이 어떤지
• 기본 설정이 정상적으로 동작하는지

플레이그라운드는 어디에 있나요

콘솔에서 진입:

• 플레이그라운드
• 바로가기 주소: https://home.moleapi.com/console/playground

페이지의 실제 화면은 대략 다음과 같습니다:

이 페이지는 어떻게 이해하면 되나요

페이지는 크게 두 부분으로 나눌 수 있습니다.

왼쪽: 모델 설정 영역

여기서는 주로 다음 항목을 선택하고 조정합니다.

• Group
• 모델
• 이미지 입력 활성화 여부
• Temperature / Top P / Frequency Penalty 등의 파라미터
• 스트리밍 출력 여부

초보자에게 가장 중요한 것은 처음부터 모든 파라미터를 완전히 이해하는 것이 아니라, 우선 다음 두 가지를 완료하는 것입니다.

1. 현재 사용할 수 있는 모델 하나를 선택하기
2. 정상적으로 응답이 반환되는 첫 메시지를 보내기

오른쪽: 대화 영역

여기는 실제 대화가 이루어지는 영역입니다. 질문을 직접 입력하고 반환 결과를 관찰하면서 다음을 확인할 수 있습니다.

• 응답이 정상적인지
• 응답 속도는 어떤지
• 출력 스타일이 기대에 맞는지

초보자는 플레이그라운드를 어떻게 사용하는 것이 좋나요

다음 순서로 시도하는 것을 권장합니다.

1. 먼저 범용 텍스트 모델 하나를 선택합니다
2. 너무 많은 파라미터를 바로 변경하지 않습니다
3. 먼저 “안녕하세요”처럼 가장 간단한 문장을 보내 봅니다
4. 안정적으로 응답한 뒤에 점차 더 복잡한 질문을 시도합니다

이렇게 하면 다음과 같은 장점이 있습니다.

• “플랫폼 사용 가능 여부”와 “이후 코드 문제”를 먼저 구분할 수 있습니다
• 모델/Group 사용 가능 여부를 빠르게 판단할 수 있습니다
• 외부 클라이언트에 실제로 연동하기 전에 먼저 사용 경험을 검증할 수 있습니다

플레이그라운드가 정상적으로 동작한다면 무엇을 의미하나요

여기서 이미 안정적으로 대화할 수 있다면, 일반적으로 다음을 의미합니다.

• 계정 및 기본 권한에 문제가 없습니다
• 현재 플랫폼에서 해당 모델을 정상 호출할 수 있습니다
• 이후 서드파티 애플리케이션이나 코드에서 실패한다면, 연동 설정 문제일 가능성이 더 높습니다

그래서 많은 초보자에게 다음과 같이 권장합니다.

먼저 사이트 내에서 대화가 정상 동작하는지 확인한 뒤, 서드파티 애플리케이션이나 SDK를 연동하세요.

자주 묻는 문제

플레이그라운드는 되는데 서드파티 클라이언트에서는 안 됩니다

우선 다음 항목을 확인하세요.

• 서드파티 클라이언트의 Base URL이 올바른지
• API Key가 완전하게 복사되었는지
• 모델명이 일치하는지
• 서드파티 도구가 OpenAI 호환 인터페이스를 지원하는지

플레이그라운드에서 모델을 선택할 수 없거나 결과가 이상합니다

우선 다음을 확인하세요.

• 현재 Group이 해당 모델을 지원하는지
• 선택한 모델이 현재 작업에 적합한지
• 너무 많은 파라미터를 실수로 변경하지 않았는지

응답이 매우 느리면 어떻게 하나요

바로 플랫폼 이상으로 판단하지 말고, 먼저 다음을 시도해 보세요.

• 다른 모델로 변경하기
• 다른 Group으로 변경하기
• 더 짧은 질문으로 테스트하기
• 처음부터 너무 긴 컨텍스트를 넣지 않기

다음 단계로 무엇을 보면 좋나요

• 지원 모델 페이지
• 개발자 빠른 연동 가이드
• 자주 발생하는 오류 코드