파이 코딩 에이전트 API 설정

pi의 공식 Custom Models 메커니즘은 ~/.pi/agent/models.json에서 게이트웨이와 사용자 정의 모델을 로드합니다. TokenHub는 openai-completions API 유형을 사용합니다. 여기에는 일반적인 "공급자 추가" 양식이 없습니다. 이 구성 파일은 지원되는 진입점입니다.

1단계: models.json에 대한 자격 증명 준비

pi를 실행하는 동일한 터미널에서 다음을 설정합니다.

export TOKENHUB_API_KEY="sk-..."

models.json에서 환경 변수를 읽으려면 값이 "$TOKENHUB_API_KEY"여야 합니다. pi의 문서에서는 ``models.json에서 환경 변수를 읽으려면 값이 "$TOKENHUB_API_KEY"`여야 합니다. pi의 문서에서는 가 없는 대문자 문자열은 환경 변수 이름이 아닌 리터럴 키로 처리된다는 점을 명시하고 있습니다.

2단계: ~/.pi/agent/models.json 편집

{
  "providers": {
    "tokenhub": {
      "baseUrl": "__API_BASE_URL__/v1",
      "api": "openai-completions",
      "apiKey": "$TOKENHUB_API_KEY",
      "models": [
        {
          "id": "YOUR_TOKENHUB_MODEL_ID",
          "name": "TokenHub / YOUR_TOKENHUB_MODEL_ID",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 128000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

TokenHub 모델 페이지에서 각 필드를 수정합니다.

• id는 API로 전송되는 모델 ID이며 필수입니다.
• 확장 추론을 지원하는 모델에 대해서만 reasoning를 true로 설정하십시오.
• input의 기본값은 텍스트입니다. 이미지 입력이 있는 모델에만 ["text", "image"]를 사용하세요.
• contextWindow에는 기본값이 있지만 모델의 실제 컨텍스트 창을 선언합니다.
• maxTokens는 컨텍스트 창이 아닌 최대 출력입니다.

TokenHub는 Bearer 토큰을 사용합니다. pi 버전이 Authorization 헤더를 자동으로 추가하지 않는 경우 공급자 수준에서 "authHeader": true를 추가하세요.

3단계: /model을 열어 파일을 다시 로드합니다.

pi 세션 내에서 /model를 실행합니다. pi는 /model가 열릴 때마다 models.json를 다시 로드하므로 다시 시작할 필요가 없습니다. tokenhub/YOUR_TOKENHUB_MODEL_ID를 선택하고 파일 하나에 대한 설명을 요청한 후 성공한 후에만 도구 호출을 테스트합니다.

공급자와 모델이 표시되지만 선택할 수 없는 경우 파일이 로드되었지만 자격 증명이 확인되지 않은 것입니다. 환경 변수를 확인하거나 /login / auth.json를 사용하여 공급자 키를 저장하세요.

필요한 경우에만 pi 특정 호환성 재정의 적용

일부 OpenAI-compatible 서비스는 developer 역할 또는 reasoning_effort를 거부합니다. 해당 400 오류가 발생한 후에만 다음 플래그를 추가하세요.

"compat": {
  "supportsDeveloperRole": false,
  "supportsReasoningEffort": false
}

기능을 사전에 비활성화하지 마십시오. 기본 요청이 성공하면 정확한 모델에 대해서만 thinkingLevelMap, 이미지 입력, 샘플링 매개변수 또는 가격 책정을 구성합니다.

pi의 로드 동작에 따른 문제 해결

• /model에 공급자가 전혀 없음: 파일 경로, JSON 구문, baseUrl 및 api를 확인하세요.
• 공급자가 있지만 모델을 선택할 수 없습니다. $TOKENHUB_API_KEY가 확인되지 않았거나 공급자에 저장된 자격 증명이 부족합니다.
• 401: pi 프로세스가 변수를 상속했는지 확인하고 필요한 경우 authHeader: true를 설정합니다.
• 400 또는 초기 잘림: contextWindow, maxTokens 또는 compat를 수정합니다. 단순히 숫자만 늘리지 마세요.
• 변경 사항이 나타나지 않습니다. 현재 세션에 표시된 이전 선택 사항에 의존하는 대신 /model를 다시 엽니다.

공식 참고자료

• pi: 커스텀 모델
• pi: 사용자 정의 공급자 확장 API