Oh My Pi

~/.omp/agent/models.yml의 제공자 블록 — baseUrl, api, apiKey — 으로 Oh My Pi를 Kunavo에 연결하며, 검색 기능이 GET /v1/models에서 가져온 정보로 모델 목록을 채웁니다

providers:
  kunavo:
    baseUrl: https://api.kunavo.com/v1
    api: openai-completions
    apiKey: KUNAVO_API_KEY       # an env-var name; literal text also works
    discovery:
      type: openai-models-list   # reads GET /v1/models

# Prefer a fixed list to a discovered one? Drop the discovery block and
# declare ids instead. Omitted metadata defaults to a 128,000-token context
# window and a 16,384-token output limit, so set the real numbers from
# /models when they differ.
#
#     models:
#       - id: claude-sonnet-5
#         name: Claude Sonnet 5
#         contextWindow: ...
#         maxTokens: ...

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. omp를 시작하는 셸에서 KUNAVO_API_KEY로 내보내세요. omp는 먼저 apiKey를 환경 변수 이름으로 확인하고, 해당 변수가 없으면 텍스트 자체를 키로 취급합니다. 따라서 변수 이름을 잘못 입력해도 조용히 넘어가다가 첫 요청에서 실패합니다. !로 시작하는 값은 대신 셸 명령으로 실행됩니다. 이는 1Password 방식입니다.
3. 위 블록을 ~/.omp/agent/models.yml에 넣으세요. 여기서는 kunavo인 제공업체 ID를 직접 선택하면 되며, 이 ID가 모든 선택자에서 첫 부분이 됩니다.
4. omp models kunavo을 실행해 파일을 불러오고 이 제공업체만 표시하세요. YAML 또는 스키마 문제가 있으면 models.yml validation failed와 실패한 필드가 출력됩니다. omp models refresh kunavo는 캐시된 목록을 사용하지 않고 새로 검색하도록 강제합니다.
5. 정확한 선택자를 사용해 테스트하세요. omp -p --model kunavo/claude-sonnet-5 "Reply with only OK" 그런 다음 omp을 시작하고 /model를 입력한 뒤, 원하는 ID를 Default에 지정하세요. 모델 허브는 열릴 때 models.yml를 다시 불러옵니다. /switch는 현재 세션에만 적용됩니다.

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

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

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Oh My 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 기준이며 입력 / 출력 순서입니다.

검색 설정: 유형과 선택기에 표시되는 항목

omp는 discovery.type 값을 여섯 가지 제공하며, 그중 두 가지가 게이트웨이에 맞아 보입니다. 실제로 맞는 것은 하나뿐입니다. proxy는 "모델 행에 supported_endpoint_types를 표시하는 혼합형 OpenAI/Anthropic 프록시"용으로 설명되며, 각 모델의 와이어 형식을 이 필드에서 가져옵니다. Kunavo의 GET /v1/models에는 이 필드가 없으므로 proxy에서는 모든 행이 제공업체 수준의 api로 대체되거나, 해당 값도 없으면 제외됩니다. "일반적인 OpenAI 호환 GET /v1/models 엔드포인트"로 설명된 openai-models-list를 사용하세요. 따라서 위 설정 블록에는 api: openai-completions이 포함되어 있습니다. omp 규칙에 따르면 "proxy를 제외하면 검색에는 제공업체 수준의 api가 필요합니다."

선택기를 열기 전에 알아둘 점이 하나 있습니다. Kunavo의 모델 목록에는 사용 가능한 카탈로그 전체가 포함되므로 검색된 제공업체에는 채팅 모델뿐 아니라 이미지, 동영상, 음악 ID도 표시되며, 채팅 전송 방식으로는 해당 ID를 호출할 수 없습니다. Kunavo는 채팅 모델 행에 context_length를 게시합니다. omp의 모델 문서에 따르면 일반 검색은 max_model_len 다음에 이 필드를 읽습니다. 반면 미디어 행에는 이 필드가 없으므로 omp의 기본값인 128,000 토큰으로 표시되며 실제 토큰 수가 아닙니다. 짧고 정확한 선택기를 원한다면 검색 블록을 제거하고 실제로 사용하는 모델 ID를 서너 개 직접 지정하세요.

omp는 anthropic-messages와도 통신할 수 있고 Kunavo는 /v1/messages에 응답합니다. 이 페이지에서는 해당 조합의 설정 블록을 제공하지 않습니다. 여기서 인용한 두 페이지는 OpenAI 호환 경로의 기본 URL 형식만 명시하고, Anthropic 경로에서 끝의 /v1를 어떻게 처리하는지는 설명하지 않습니다. 설정 블록은 독자가 그대로 붙여 넣을 수 있어야 하기 때문입니다. 이 경로를 사용할 경우 Anthropic 호환 엔드포인트에서 도구 호출이 400 오류로 실패하는 문제에 대해 문서가 제시하는 해결책은 disableStrictTools: true입니다.