PandaNpc는 사용자가 구성한 공급자 연결과 모델 항목을 저장합니다. 서비스에서 제공한 API 키, Base URL, 프로토콜 및 모델 ID로 시작하세요. 항목을 추가한다고 해서 업스트림 계정이 만들어지거나 모델 액세스 권한이 부여되지는 않습니다.
공급자와 모델의 차이에 대한 자세한 내용은 사용자 지정 모델 목록 관리 문서를 참조하세요.
시작하기 전에
공급자 또는 자체 호스팅 서비스에서 다음 사항을 확인하세요.
- API 기본 주소(공급자의 웹사이트 주소가 아님)
- 인증 방법 및 필요한 모든 자격 증명
- 사용하려는 기능 또는 엔진이 지원하는 API 프로토콜
- 계정에서 호출할 수 있는 정확한 모델 ID
- 수동으로 입력하려는 경우 컨텍스트 및 출력 제한
자격 증명은 프롬프트, 스크린샷, 공유 노트가 아닌 공급자 양식에 보관하세요. OpenAI 호환으로 광고되는 서비스라도 스트리밍, 도구 호출 또는 이미지 지원에서 다를 수 있습니다.
1. 공급자 추가 또는 구성
모델 구성을 엽니다. 공급자를 추가하거나 기존 프리셋을 구성하거나, 독립적으로 편집 가능한 연결이 필요할 때 프리셋을 복사하세요.
| 필드 | 입력 내용 |
|---|---|
| 표시 이름 | 이 연결을 식별할 수 있는 이름 |
| 공급자 ID | 공급자 구성의 식별자 |
| API 키 | 서비스에서 요구하는 자격 증명 |
| Base URL | 선택한 통합이 기대하는 API 기본 주소 |
| 프로토콜 | 업스트림 API가 실제로 구현하는 형식 |
| Secret, Organization, Project | 서비스에서 명시적으로 요구하는 값만 입력 |
| 콘텐츠 배열 지원 | 서비스가 구조화된 메시지 콘텐츠를 수락하는지 여부 |
Base URL의 형태는 프로토콜과 요청하는 기능에 따라 달라집니다. 통합에서 이미 경로를 추가한다면 전체 작업 경로를 덧붙이지 마세요. 예를 들어 /chat/completions를 추가하는 통합은 해당 경로로 끝나는 주소가 아니라 그에 해당하는 기본 주소가 필요합니다. 이 예시를 모든 프로토콜에 적용하지는 마세요.
저장된 자격 증명을 편집할 때 API 키 또는 Secret을 비워 두면 구성된 값이 유지됩니다. 목록에 표시되는 마스킹된 값은 원래 키가 아니므로 다시 붙여넣어 교체하면 안 됩니다.
2. 모델 추가
공급자를 저장하고 선택한 후 모델 추가를 선택하세요.
| 필드 | 의미 |
|---|---|
| 표시 이름 | 모델 목록에 표시할 레이블 |
| 모델 값 | 정확한 업스트림 모델 ID |
| 모델 유형 | 구성 양식에서 적용되는 범주 |
| 공급자 | 이 항목이 사용하는 연결 |
| 컨텍스트 창 | 지정된 경우 문서화된 컨텍스트 용량 |
| 최대 토큰 수 | 지정된 경우 출력 제한 |
서비스 문서나 모델 목록에 있는 ID를 사용하세요. 마케팅 이름이 반드시 API 식별자는 아닙니다. 확인할 수 없는 선택적 제한은 설정하지 않은 채 두세요. 설정하지 않았다고 해서 실제 제한이 감지된 것은 아닙니다. 해당 기능이 자체 기본값을 적용할 수 있습니다.
3. 구성 확인
이 설정을 사용하는 기능 또는 엔진에서:
- 새 항목을 선택하고 테스트 대화를 시작합니다.
Reply with: connected같은 짧은 요청을 보냅니다.- 정상적인 응답을 확인하고, 가능하면 공급자의 사용 기록에서 일치하는 요청도 확인합니다.
- 연속 대화가 이어지는지 후속 요청을 보냅니다.
- 작업에 필요하다면 이미지 또는 도구 호출을 별도로 테스트합니다.
기록을 저장하는 것은 연결 테스트가 아닙니다. 텍스트 응답이 모든 기능과의 호환성을 입증하지는 않습니다. 모델 항목을 변경해도 실행 중인 Claude Code 또는 Codex 프로세스가 자동으로 재구성되지는 않습니다. PandaPaw를 참조하세요.
문제 해결
인증 실패
키가 활성 상태인지, 계정이 모델에 액세스할 수 있는지, 서비스에 추가 인증 필드가 필요한지 확인하세요. 만료된 자격 증명은 공급자 양식에서 교체하세요.
엔드포인트 또는 모델을 찾을 수 없음
Base URL과 모델 값을 모두 확인하세요. 중복된 작업 경로, 누락된 API 접두사 또는 계정에서 사용할 수 없는 모델 ID가 있는지 확인하세요. 동일한 오류라도 공급자마다 원인이 다를 수 있습니다.
네트워크 또는 브라우저 오류가 표시됨
실제로 요청을 보내는 기기에서 연결 상태를 확인하세요. 브라우저에서 시작된 요청은 CORS 및 HTTPS 제한을 받습니다. 다른 컴퓨터에서 요청이 작동한다고 해서 브라우저 경로가 작동하는 것은 아닙니다.
로컬 모델 서버에 연결할 수 없음
localhost는 요청을 보내는 컴퓨터를 가리킵니다. 원격 PandaPaw 컴퓨터를 자동으로 가리키지는 않습니다. 로컬 서버 주소를 선택하기 전에 해당 기능이 실행되는 위치를 확인하세요.
텍스트는 작동하지만 이미지, 도구 또는 긴 세션은 실패함
엔진, API 프로토콜, 모델 기능의 정확한 조합을 확인하세요. 공급자가 지원하는 제한을 사용하고 필요한 각 입력 유형을 검증하세요. 컨텍스트 창을 늘리거나 모델 유형을 변경해도 업스트림 기능이 추가되지는 않습니다.
플랫폼 멤버십과 공급자 사용의 차이에 대해서는 계정 및 모델 비용 문서를 참조하세요.