Pi

~/.pi/agent/models.json의 사용자 지정 제공자 블록 — baseUrl, api, 모델 ID — 하나의 키로 Earendil의 Pi 터미널 코딩 에이전트를 Claude와 GPT에 연결합니다

{
  "providers": {
    "kunavo": {
      "baseUrl": "https://api.kunavo.com/v1",
      "api": "openai-completions",
      "apiKey": "$KUNAVO_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-5",
          "name": "Claude Sonnet 5",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000
        },
        {
          "id": "claude-haiku-4-5",
          "name": "Claude Haiku 4.5",
          "input": ["text", "image"],
          "contextWindow": 200000,
          "maxTokens": 64000
        }
      ]
    }
  }
}

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. 환경 변수로 KUNAVO_API_KEY를 설정합니다. Pi는 apiKey 필드에서 "$NAME" 또는 "${NAME}"를 해석하며, 리터럴 값이나 앞에 !command가 붙은 값도 사용할 수 있습니다. 변수 이름 뒤에 리터럴 텍스트가 이어지면 중괄호 형식을 사용합니다.
3. ~/.pi/agent/models.json를 만들거나 편집하고 위 블록을 붙여 넣습니다. 기본 제공되지 않는 공급자에는 baseUrl와 api 값이 필요하며, 공급자 또는 모델 수준에서 설정할 수 있습니다. Pi 소스 코드는 이 값이 없으면 모델을 불러오지 않습니다. 나머지 항목은 모두 선택 사항입니다. /model를 열면 파일을 다시 불러옵니다.
4. pi를 시작하고 /model를 실행한 다음 선언한 ID 중 하나를 선택합니다. 목록에 표시되지 않으면 JSON 앞의 키를 확인하세요. 위의 확인 순서 설명을 참고하세요.
5. 실제 파일을 읽고 수정하는 작업을 맡겨 보세요. Pi는 거의 모든 작업에서 도구 호출에 의존하므로, 파일 시스템을 다루는 첫 실행이 단순한 인사보다 훨씬 많은 정보를 알려 줍니다. 이 실행에서 스트리밍 또는 도구 스키마 불일치도 드러날 수 있습니다. 바로 이런 유형의 문제를 Kunavo가 대신 테스트하지 않았습니다.

Pi의 모델 선택 문서에서 확인했습니다(2026년 10월 1일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Pi에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

다른 경로: anthropic-messages

2026년 9월 22일 문서가 갱신되기 전까지 Pi는 사용자 지정 공급자의 api에 대해 openai-completions, openai-responses, anthropic-messages, google-generative-ai의 네 가지 값을 문서화했습니다. 갱신된 모델 페이지에는 이 값들이 하나도 나와 있지 않습니다. 한 예시에서 openai-completions를 보여 주고, 해당 사례를 “OpenAI, Anthropic 또는 Google 호환 엔드포인트”라고 설명합니다. v0.99.2의 Pi 소스 코드에서 이 필드는 자유 형식 문자열로 선언되어 있으며, 값에 따라 기본 제공 구현 열 가지 중 하나로 요청을 전달합니다. 앞서 언급한 네 가지와 openai-codex-responses, azure-openai-responses, google-vertex, mistral-conversations, bedrock-converse-stream, pi-messages입니다. 사용자 지정 공급자용으로 문서화된 것은 네 가지뿐이며, 나머지 여섯 가지는 여기서 테스트하지 않았습니다. 이 페이지 어디에도 나머지 값이 타사 엔드포인트에서 작동한다고 명시되어 있지 않습니다.

anthropic-messages는 문서화된 네 가지 중 하나이며, Kunavo는 OpenAI 호환 API뿐 아니라 Anthropic Messages API도 지원합니다. 따라서 이 경로를 설정할 수는 있습니다. 다만 이 페이지에서는 그대로 붙여 넣을 수 있는 블록에 base URL을 기입하지 않습니다. Pi 문서는 이 api의 필드 값을 한 번도 확정하지 않았기 때문입니다. 9월 22일 이전 문서에는 두 가지 방식이 나왔습니다. 한 예시에는 https://proxy.example.com/v1가, 다른 예시에는 단독으로 https://proxy.example.com가 표시됐습니다. 그날 문서가 갱신되면서 둘 중 하나를 선택하는 대신 두 예시가 모두 삭제됐습니다. 이 경로를 선택했다면 한 가지 방식을 시도해 보세요. 첫 호출에서 401 대신 404가 반환되면 해당 줄을 바꾸면 됩니다.

이 api에 관한 Pi의 compat 스키마에는 미리 알아둘 만한 필드가 세 가지 있습니다(소스 코드 v0.99.2). 먼저 이 세 필드 모두에 적용되는 문서의 규칙을 인용할 필요가 있습니다. 호환성 설정은 “엔드포인트의 요청 또는 응답 동작에서 확인된 차이를 설명해야 합니다. 엔드포인트가 OpenAI 또는 Anthropic 호환성을 광고한다는 이유만으로 이 설정을 활성화하지 마세요.”

1. compat.supportsEagerToolInputStreaming — 도구별 입력을 미리 스트리밍하는 방식을 거부하는 백엔드용입니다.
2. compat.supportsStrictTools — 엔드포인트가 엄격한 JSON 스키마 도구 정의를 허용하는지 나타냅니다. 사용자 지정 모델은 기본 제공 Anthropic 모델에 선언된 설정을 상속하지 않습니다.
3. compat.supportsMidConvoEffort — 대화 도중 추론 강도를 변경합니다. 이 엔드포인트가 해당하는지는 런타임에서 확인해야 하며, Kunavo는 실행 테스트를 통해 확인하지 않았습니다.

페이지 맨 위의 openai-completions 블록은 이 세 가지 설정을 모두 사용하지 않습니다. 성능이 더 좋다는 뜻이 아니라, 여기서 시작하는 것이 정직한 이유입니다.