PandaNpc에서는 자신만의 프로바이더 연결과 모델 항목을 관리할 수 있습니다. BYOK( Bring Your Own Key)는 선택한 서비스에 필요한 자격 증명을 직접 제공한다는 의미입니다. 저장된 모델 항목은 구성을 설명할 뿐이며, 해당 모델을 구매하거나 호스팅하거나 사용을 승인하지 않습니다.
이 페이지에서 목록을 이해한 후 API 키 및 Base URL 구성을 진행하세요.
프로바이더와 모델 항목
프로바이더와 모델은 별개의 레코드입니다:
| 레코드 | 설명 | 예시 |
|---|---|---|
| 프로바이더 | 연결 주소, 프로토콜 및 인증 설정 | 회사 API 게이트웨이 |
| 모델 | 표시 이름, 업스트림 모델 ID, 프로바이더 및 선택적 제한 | 해당 게이트웨이에서 사용 가능한 모델 |
하나의 프로바이더는 여러 모델 항목을 가질 수 있습니다. 표시 이름은 항목을 인식하는 데 도움이 됩니다. Model Value는 업스트림 API가 인식하는 식별자와 일치해야 합니다. 표시 이름을 변경해도 실제 모델은 변경되지 않습니다.
사전 설정 항목의 의미
구성 화면에는 Official로 표시된 프로바이더 또는 모델 항목이 포함될 수 있습니다. 이러한 항목은 연결 구성을 돕기 위한 사전 설정일 뿐, 무료 액세스나 포함된 크레딧을 약속하지 않습니다.
사전 설정 프로바이더에 자격 증명을 구성하거나, 프로바이더나 모델을 복사하여 직접 편집 가능한 항목을 만들 수 있습니다. 프로바이더를 복사하면 자격 증명은 직접 입력해야 합니다. 목록에 모델이 있다고 해서 해당 모델을 호출할 권한이 계정에 있다는 의미는 아닙니다.
모델 목록 관리
Model Configuration을 열고 프로바이더를 선택하면 해당 모델이 표시됩니다. 표시 이름, Model Value, 유형 및 프로바이더를 사용하여 모델을 추가하세요. 사용자 지정 항목은 제공되는 작업을 통해 편집, 복사, 활성화/비활성화 및 삭제할 수 있습니다.
같은 모델에 대해 여러 계정이나 엔드포인트를 사용하는 경우에는 레이블을 구분해 두세요. 예를 들어 업무 게이트웨이와 개인 프로바이더가 동일한 모델 ID를 노출하더라도 서로 다른 자격 증명과 제한을 사용할 수 있습니다. 각 항목을 올바른 프로바이더에 연결하세요.
기본 모델은 해당 모델을 사용하는 기능에 대한 구성 선호도입니다. 기존의 모든 원격 Agent 세션을 자동으로 변경하지는 않습니다.
컨텍스트 창과 출력 길이
Context Window는 모델이 지원하는 컨텍스트 용량을 기록합니다. Max Tokens는 출력 제한을 기록합니다. 선택한 정확한 API와 모델에 문서화된 제한을 사용하세요.
빈 필드는 해당 값을 입력하지 않았음을 의미합니다. PandaNpc가 업스트림 용량을 검증했다는 의미는 아닙니다. 기본값과 제한이 적용되는 방식은 이를 사용하는 기능이나 엔진에 따라 다릅니다. 숫자를 크게 설정해도 업스트림 모델이 수용하는 범위가 늘어나지는 않습니다.
마찬가지로 모델 유형을 선택한다고 해서 이미지 입력, 도구 호출 등의 기능이 모델에 추가되지는 않습니다.
해당 기능에서 모델 사용 가능 여부 확인
항목을 저장한 후 이 구성을 사용하는 기능에서 해당 모델을 선택하고 짧은 텍스트 요청을 보내세요. 예상한 프로바이더가 처리했는지 확인하세요. 필요하다면 이미지, 도구 호출, 긴 컨텍스트는 별도로 테스트하세요.
저장에 성공했다는 것은 구성이 저장되었음을 의미합니다. 텍스트 응답에 성공했다는 것은 해당 요청이 작동했음을 의미합니다. 어느 것도 모든 PandaNpc 기능이나 모든 업스트림 기능과의 호환성을 입증하지는 않습니다.
인증, 모델 가용성, 할당량 및 서비스 제한은 구성된 업스트림 서비스에 속합니다. 문서의 고정된 모델 카탈로그에 의존하지 말고 현재 설정을 확인하세요.
원격 Agent 모델은 별도로 구성됩니다
Claude Code와 Codex는 연결된 컴퓨터에서 실행되며 자체 엔진 또는 세션 구성을 사용합니다. 이 목록을 업데이트해도 실행 중인 프로세스의 모델이 자동으로 바뀌지는 않습니다. PandaNpc 모델 항목을 허용하는 엔진이나 작업의 경우 해당 엔진의 구성을 통해 모델을 선택하고 결과 세션을 검증하세요.
원격 실행에 대해서는 PandaPaw 호스트 가이드를, PandaNpc 멤버십과 모델 프로바이더 사용의 구분에 대해서는 계정 및 모델 비용을 참조하세요.