연동Pi

Pi

Pi 코딩 에이전트(npm @earendil-works/pi-coding-agent)는 models.json에서 사용자 지정 제공업체를 읽습니다. 여기서 추가하는 제공업체는 Pi의 openai-completions API를 사용해 https://api.abliteratedllm.dev/v1에 연결합니다.

자리 표시자: $API_BASE는 https://api.abliteratedllm.dev/v1, $API_ORIGIN은 https://api.abliteratedllm.dev, $YOUR_KEY는 발급받은 API 키입니다.

로그인했다면 API 키 페이지에 현재 제공하는 모든 모델용으로 이 파일이 준비되어 있습니다. 실시간 가격, 강조 표시된 제공업체 블록, 다운로드 버튼도 함께 있습니다.

1. models.json에 제공업체 추가하기

파일 위치는 macOS와 Linux에서는 ~/.pi/agent/models.json, Windows에서는 %USERPROFILE%\.pi\agent\models.json입니다. PI_CODING_AGENT_DIR 환경 변수를 설정했다면 그 디렉터리의 models.json입니다.

json
{
  "$schema": "https://pi.dev/schemas/models.schema.json",
  "providers": {
    "abliteratedllm": {
      "name": "AbliteratedLLM",
      "baseUrl": "$API_BASE",
      "api": "openai-completions",
      "apiKey": "$ABLITERATEDLLM_API_KEY",
      "compat": {
        "supportsDeveloperRole": false,
        "supportsStore": false,
        "supportsReasoningEffort": true,
        "maxTokensField": "max_tokens",
        "thinkingFormat": "openai"
      },
      "models": [
        {
          "id": "glm-5.3-flash-abliterated",
          "name": "GLM-5.3 Flash Abliterated",
          "reasoning": true,
          "thinkingLevelMap": {
            "minimal": null
          },
          "input": [
            "text",
            "image"
          ],
          "contextWindow": 1048576,
          "maxTokens": 131072,
          "cost": {
            "input": 0.0977,
            "output": 0.3421,
            "cacheRead": 0.0098,
            "cacheWrite": 0
          }
        }
      ]
    }
  }
}
  • 새 파일: 그대로 저장하세요. 기존 파일: "abliteratedllm" 항목만 "providers" 객체에 복사하고, 바로 앞 제공업체와의 사이에 쉼표를 넣고, 다른 제공업체는 그대로 두세요.
  • api: "openai-completions"를 지정하면 Pi가 /v1/chat/completions를 호출합니다. baseUrl에는 /v1이 포함됩니다.
  • compat은 표준 chat completions 형식을 사용하도록 지정합니다: 시스템 프롬프트는 system 메시지로 보내고, store 필드는 보내지 않으며, 토큰 예산은 max_tokens에, 추론 수준은 reasoning_effort로 지정합니다.
  • models에는 GET /v1/models의 ID마다 항목이 하나씩 필요하며, id는 정확히 일치해야 합니다. 대시보드의 파일에는 이미 모든 ID가 들어 있습니다. contextWindow와 maxTokens에는 모델의 context_length와 max_output_tokens 값을 넣습니다. 체험 계정에서는 이 값과 관계없이 출력이 토큰 4096개로 제한됩니다.
  • thinkingLevelMap은 Pi의 minimal 사고 수준을 숨깁니다. 이 수준에는 대응하는 reasoning_effort 값이 없습니다. low, medium, high는 그대로 전송됩니다.
  • cost는 100만 토큰당 USD 단위(입력, 출력, 캐시 입력)로 지정하며, 그래야 Pi의 비용 표시가 실제 청구 금액과 일치합니다. 캐시 쓰기에는 요금이 부과되지 않습니다.
  • Pi는 /model을 열 때마다 파일을 다시 읽으므로 수정한 뒤 재시작할 필요가 없습니다.

2. 키 연결하기

"apiKey": "$ABLITERATEDLLM_API_KEY"를 지정하면 Pi가 해당 환경 변수에서 키를 읽으므로, 키가 파일에 기록되지 않습니다.

Bash 또는 Zsh(계속 유지하려면 이 줄을 ~/.zshrc 또는 ~/.bashrc에 추가하세요):

bash
export ABLITERATEDLLM_API_KEY="$YOUR_KEY"

Windows(이후에 여는 터미널부터 적용됩니다):

powershell
setx ABLITERATEDLLM_API_KEY "$YOUR_KEY"

한 번만 실행할 때는 3단계의 pi --model … 명령에 --api-key "$YOUR_KEY"를 추가하세요. 이 값이 파일 설정보다 우선합니다. 키를 확인할 수 있어야 /model에 제공 모델이 표시됩니다.

3. 모델을 고르고 인사하기

bash
pi --model abliteratedllm/glm-5.3-flash-abliterated

pi --provider abliteratedllm --model glm-5.3-flash-abliterated도 같은 동작을 합니다. Pi 안에서는 /model로 모델을 전환하고, 거기서 Ctrl+S를 누르면 선택한 모델이 기본값으로 저장됩니다. pi --list-models는 Pi에서 사용할 수 있는 모든 모델을 나열합니다.

참고 사항

  • 이미지: 이미지 입력은 GET /v1/models의 input_modalities에 image가 포함된 모델에서만 작동하며, 대시보드 파일은 이런 모델의 input을 ["text", "image"]로 설정합니다. 이 모델을 이미 설정했다면 models.json을 새로 고치거나 다시 다운로드해 업데이트된 모델 항목을 병합하세요. 그래야 Pi가 이미지 첨부를 허용합니다. 다른 모델에서는 이미지가 400 unsupported_content 오류로 실패합니다.
  • 체험 계정은 동시 요청 1건까지 허용하므로 에이전트 작업에는 빠듯합니다. 속도 제한 및 체험을 참고하세요.

2026년 11월 3일에 Pi 문서와 대조해 확인했습니다: Custom models, CLI, models.json 스키마.