Page Assist

Settings → OpenAI Compatible API → Add Provider → Custom: Provider Name, /v1을 유지한 Base URL, 키를 입력한 뒤 Page Assist가 자체적으로 가져온 목록에서 모델 ID를 선택합니다

Provider Name   Kunavo
Base URL        https://api.kunavo.com/v1
API Key         sk-kn-...
                [ Save ]

Model List      (appears after Save — fetched from GET /v1/models)
  [x] claude-haiku-4-5
  [x] claude-sonnet-5
  [x] gpt-5-6-terra

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. 브라우저 도구 모음에서 Page Assist 아이콘을 클릭한 다음 Settings 아이콘을 클릭하고 OpenAI Compatible API 탭으로 이동하세요.
3. Add Provider를 클릭하세요. Kunavo는 드롭다운의 사전 설정 목록에 없으므로 Custom를 선택하세요. 제공업체의 5단계 안내에 따르면 목록에 없는 항목은 이 경로를 선택해야 합니다.
4. Provider Name과 Base URL = https://api.kunavo.com/v1, API Key를 입력한 다음 Save를 클릭하세요.
5. 열리는 Model List에서 사용할 ID를 선택하세요. 보통 두 개가 적당합니다. 페이지 요약에는 저렴한 모델을, 이어지는 질문에는 성능이 좋은 모델을 선택하세요.
6. 실제 페이지에서 사이드바를 여세요. Ctrl+Shift+L를 클릭하면 Web UI가 열립니다. 선택기에서 모델을 고르고 해당 탭에 관해 질문하세요. 실제 콘텐츠가 있는 페이지를 사용하면 인사말보다 많은 것을 확인할 수 있습니다. 비용이 드는 부분은 페이지 텍스트이기 때문입니다.

Page Assist의 OpenAI Compatible API 페이지에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

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

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

# 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 기준이며 입력 / 출력 순서입니다.

페이지 이용 비용과 브라우저 밖으로 전송되는 내용

사이드바 클라이언트는 편집기와 다르게 비용을 계산하며, 그 차이는 페이지에서 비롯됩니다. Page Assist가 탭의 내용을 바탕으로 대화할 때마다 탭에서 추출한 텍스트가 입력 토큰으로 전송됩니다. 문서 페이지나 긴 스레드는 토큰이 수만 개에 달할 수 있으며, 같은 대화에서 후속 질문을 할 때마다 다시 전송됩니다. 그래서 위 모델 표는 저렴한 ID부터 소개합니다. 이 클라이언트에서는 일반적으로 입력 토큰이 출력 토큰보다 한 자릿수 배 더 많으며, claude-haiku-4-5 또는 gpt-5-6-terra로 페이지 전체를 읽는 것이 더 강력한 모델로 일부만 읽는 것보다 낫습니다.

명시적으로 요청하지 않은 트래픽을 더하는 설정이 세 가지 있으며, 모두 제공업체의 Settings 페이지에 나와 있습니다.

• Generate Title using AI — “대화 내용을 바탕으로 채팅 제목을 자동 생성합니다.” 대화당 선택된 모델로 추가 요청이 한 번 발생합니다.
• Internet Search는 기본적으로 Internet Search ON으로 설정되어 있으며 Total Search Results 항목도 있습니다. 가져온 페이지가 프롬프트에 포함되므로 토큰 비용은 검색 결과 수에 따라 늘어납니다.
• Page Action은 함께 제공되는 확장 프로그램입니다. 모델은 “먼저 페이지를 읽은 다음 한 번에 한 단계씩 동작을 수행합니다.” 따라서 대화마다 한 번이 아니라 단계마다 DOM을 읽습니다. 자체 설정인 Require approval before each action은 기본으로 켜져 있으며, 켜 둔 채로 사용하는 것이 좋습니다.

개인정보 경계도 같은 기준으로 정해집니다. Page Assist는 채팅, 지식 베이스, 설정을 브라우저 저장소에 로컬로 보관하며, 네트워크를 통해 전송되는 것은 사용자가 보내는 내용입니다. 이 제공업체를 선택하면 페이지 텍스트와 메시지, 지금까지의 대화가 api.kunavo.com로 전송되고, 이어서 모델 ID를 제공하는 업스트림으로 전달됩니다. Kunavo 측에 보관되는 내용은 개인정보 처리방침을 참조하세요. 채팅 창에 붙여 넣지 않을 페이지라면 로컬 Ollama로 전환하세요. 확장 프로그램에서는 두 제공업체를 동시에 설정할 수 있어 드롭다운 한 번으로 전환할 수 있습니다.

OpenRouter 프리셋을 통해 이 페이지에 들어오셨다면

OpenRouter는 Custom 경로를 사용할 필요가 없습니다. OpenRouter는 제공업체의 OpenAI Compatible API 페이지에 Ollama, LM Studio, Groq, Together, Mistral, xAI 및 그 밖의 약 20개 제공업체와 함께 프리셋으로 등록되어 있습니다. 따라서 앞의 네 단계를 똑같이 진행한 뒤, 드롭다운에서 Custom 대신 OpenRouter를 선택하고 API Key에 키를 입력한 다음 Save를 클릭하면 됩니다. 프리셋에는 자체 Base URL이 포함되며, OpenRouter의 모델 ID는 anthropic/claude-sonnet-4.5 형태의 제공업체 접두사가 붙습니다. 위 표의 ID는 접두사 없이 표시되어 있습니다. 여기서 제공업체를 선택한다는 것은 입력할 ID의 네임스페이스를 선택하는 것입니다.

이 클라이언트에서 OpenRouter로 전환할 만한 경우는 Kunavo에 없는 모델에도 접근할 수 있는 한 화면이 필요하거나, 이미 키를 보유해 추가 설정 비용이 없는 경우입니다. Kunavo로 전환할 만한 경우는 표의 ID를 코딩 도구에서도 사용하므로 키 하나로 두 곳을 이용할 수 있고, 재전송되는 페이지 컨텍스트의 프롬프트 캐싱이 실제 사이드바 비용을 좌우하는 경우입니다. 캐싱을 참조하세요. 두 제공업체를 모두 유지해도 됩니다. Page Assist에는 함께 표시되며, 모델 선택기는 모델이 어느 행에 있는지 따지지 않습니다.