Playground

Playground는 콘솔에 내장된 모델 테스트 도구입니다. 코드를 작성하지 않고 채팅, 이미지 생성, 텍스트 음성 변환 모델을 사용해 볼 수 있습니다. 연동하기 전에 모델을 비교하고 매개변수와 프롬프트를 조정하는 데 사용합니다.

#시작하기 전에

• LLM API 서비스가 활성화되어 있고 계정에 할당량이 있어야 합니다.
• 활성화된 API 키가 하나 이상 있어야 합니다. Playground는 활성화된 키 중 하나를 사용하여 요청을 자동으로 전송하며 기본 그룹의 키를 우선 사용합니다. 사용 가능한 키가 없으면 페이지에 먼저 API 키를 생성해 주세요가 표시됩니다. LLM API → 토큰 관리에서 키를 생성합니다.

#Playground 열기

왼쪽 메뉴에서 LLM API → Playground (/llm/playground)를 선택합니다. 왼쪽에 설정 패널이 있으며, 모드 탭으로 대화, 이미지 생성, 음성 간에 전환할 수 있습니다. 오른쪽에는 선택한 모드에 해당하는 작업 공간이 표시됩니다.

#채팅

1. 모드에서 대화를 선택합니다.
2. 모델 드롭다운에서 모델을 선택합니다. 텍스트를 입력하여 검색할 수 있습니다.
3. 선택 사항: 시스템 프롬프트에서 어시스턴트의 역할과 동작을 설정합니다. 기본값은 "당신은 도움을 주는 어시스턴트입니다."입니다.
4. 선택 사항: 스트리밍 출력은 기본적으로 활성화되어 응답이 생성되는 대로 표시됩니다. 전체 응답을 한 번에 받으려면 비활성화합니다.
5. 오른쪽 입력란에 메시지를 입력합니다. Enter를 누르면 전송하고 Shift+Enter를 누르면 줄을 바꿉니다.

고급 매개변수를 펼치면 다음 항목을 조정할 수 있습니다.

개별 메시지를 복사, 재생성 또는 삭제할 수 있습니다. 대화를 지우려면 비우기를 클릭합니다.

#이미지

1. 모드에서 이미지 생성을 선택합니다.
2. 이미지 모델을 선택하고 원하는 이미지를 설명합니다.
3. 모델이 지원하는 경우 크기 (1024x1024, 1024x1792, 1792x1024, 512x512 또는 256x256), 품질 (표준 또는 HD), 스타일 (생동감 또는 자연스러움)을 설정합니다.
4. 전송하고 결과를 기다립니다. 생성된 이미지는 다운로드할 수 있습니다.

#오디오(텍스트 음성 변환)

1. 모드에서 음성을 선택한 다음 **텍스트 음성 변환(TTS)**을 선택합니다.
2. tts-1 또는 tts-1-hd와 같은 모델과 음색을 선택합니다. 음성은 Alloy, Echo, Fable, Nova, Onyx, Shimmer 중에서 선택할 수 있습니다.
3. 슬라이더로 속도를 0.25x부터 4x까지 설정합니다. 기본값은 1x입니다.
4. 텍스트를 입력하고 전송합니다. 생성된 오디오는 브라우저에서 재생하거나 다운로드할 수 있습니다.

#Playground에서 코드로 전환

원하는 설정을 찾으면 API를 통해 동일한 매개변수를 전송합니다. 예를 들어 위의 채팅 설정은 다음 요청에 대응합니다.

curl https://llm.yeap.cloud/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YEAP_LLM_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello"}
    ],
    "temperature": 0.7,
    "max_tokens": 2000,
    "top_p": 1
  }'

텍스트 음성 변환은 POST /v1/audio/speech에 대응하며 매개변수는 model, input, voice, speed입니다. 이미지 생성은 POST /v1/images/generations에 대응합니다.

#문제 해결

• 드롭다운의 모델 호출 실패: Playground에는 플랫폼의 모델이 나열되지만 모든 모델이 키의 그룹에 허용되는 것은 아닙니다. 다른 모델을 사용하거나 모델 페이지를 확인하고 키의 그룹을 변경합니다.
• 할당량 부족: 계정으로 할당량을 이전하거나 Playground에서 사용하는 키의 할당량 상한을 확인합니다.
• 특정 키로 테스트: Playground가 키를 자동으로 선택합니다. 특정 그룹이나 제한이 적용된 키를 테스트하려면 curl 또는 SDK로 API를 직접 호출합니다. 빠른 시작을 참조하십시오.