OpenCat API 프로바이더로 APIsRouter 추가하기.

Updated 2026-07-29

OpenCat은 Mac, iPhone, iPad를 위한 bring-your-own-key 네이티브 클라이언트이며, 커스텀 프로바이더는 내장 기능입니다: API Host를 https://api.apisrouter.com/v1로 설정한 항목 하나가 Claude, GPT, DeepSeek, GLM, Kimi를 키 하나 아래 같은 앱에 넣어줍니다.

빠른 답: Settings 안의 프로바이더 항목 하나.

Settings를 열고 API Providers로 가서 프로바이더를 추가하세요(또는 기존 OpenAI 항목을 편집하세요). 필드 네 개가 이 작업을 해냅니다: 원하는 표시 이름, OpenAI로 설정된 protocol, /v1을 포함한 https://api.apisrouter.com/v1로 설정된 API Host, 그리고 API key. 이것이 통합의 전부입니다; OpenCat은 프로바이더 항목이 지정한 어떤 호스트에도 표준 chat completions로 말합니다. 프로바이더가 저장되면 OpenCat이 엔드포인트가 서빙하는 모델을 나열합니다. 원하는 모델이 자동으로 채워진 목록에 나타나지 않는다면 정확한 id로 수동 추가하세요. 이 앱은 정확히 이런 경우를 위해 직접 입력한 id를 받아들입니다. 그 이후로는 앱 안의 모든 대화와 어시스턴트가 카탈로그의 어떤 id도 네이티브 옵션처럼 선택할 수 있습니다.

Name:      APIsRouter
Protocol:  OpenAI
API Host:  https://api.apisrouter.com/v1
API Key:   sk-APIsRouter-...

models auto-list from the endpoint;
add ids manually if one is missing

OpenCat이 프로바이더와 어시스턴트를 다루는 방식.

OpenCat은 Apple 생태계에서 가장 오래 살아남은 네이티브 AI 클라이언트 중 하나로, 아시아 전역에서 탄탄한 팬층을 가진 Mac, iPhone, iPad 앱이며 bring-your-own-key 아이디어를 중심으로 만들어졌습니다: 앱은 인터페이스이고, 여러분의 키가 접근 수단이며, 메시지당 중간 상인은 없습니다. 이 앱의 개발자는 앱 자체를 판매합니다. 무료 티어에 더해 2026년 7월 기준 opencat.app에 9.99달러로 등재된 일회성 Pro 구매가 있으며, 이는 구독형 채팅 제품과는 다른 경제적 구조이고 정확히 계량형 게이트웨이 키와 잘 맞는 이유입니다. 중요한 메커니즘: 프로바이더와 어시스턴트는 별개의 레이어입니다. 프로바이더는 프로토콜, 호스트, 키입니다. 어시스턴트는 페르소나이자 시스템 프롬프트에 모델 선택이 더해진 것이며, OpenCat은 여러 개를 유지하기를 권장합니다. 게이트웨이 프로바이더 하나만 있으면 이것은 정말로 유용한 패턴이 됩니다: claude-sonnet-4-6의 글쓰기 어시스턴트, claude-haiku-4-5-20251001의 빠른 답변 어시스턴트, glm-5.2나 kimi-k2.6의 이중 언어 어시스턴트가 모두 하나의 앱 안에서 대화별로 전환 가능하며 키 하나로 청구됩니다. 이 앱은 또한 채팅, 번역, 음성 대화, 이미지 논의를 같은 인터페이스로 묶으며, 그 모든 기능은 현재 어시스턴트가 선택한 모델을 탑니다. 프로바이더를 멀티벤더 엔드포인트로 지정하면 각 기능도 조용히 모델 선택권을 얻습니다.

전체 설정: 프로바이더, 모델, 어시스턴트.

편한 아무 기기에서나 프로바이더를 추가하세요; OpenCat은 유료 티어에서 iCloud를 통해 기기 간 대화와 설정을 동기화하므로, Mac에서 설정한 프로바이더는 보통 다시 입력할 필요 없이 iPhone으로 따라옵니다. 기기별로 무료 티어를 쓴다면 각 기기에 같은 필드 네 개를 입력하세요. 그런 다음 모델 선택기를 뒷전에 두지 말고 모델을 중심으로 어시스턴트를 만드세요. 어시스턴트를 만들고, 시스템 프롬프트를 부여하고, 카탈로그 id에 바인딩하세요. 실용적인 업무 분담: 하루 종일 대화하는 어시스턴트에는 빠른 id를, 중요한 것의 초안을 쓰는 어시스턴트에는 프론티어 id를, 중국어, 일본어, 한국어 텍스트를 다루는 어시스턴트에는 이중 언어 id를. OpenCat이 여러 어시스턴트를 공존시켜 주므로 대화 중간에 생각할 필요 없이 작업별 모델 라우팅을 얻습니다. 번역과 음성 기능의 경우 현재 어시스턴트 뒤의 모델이 언어 작업을 수행하므로, 여기서는 빠른 티어가 올바른 기본값이 됩니다: 번역 턴은 짧고, 빈번하고, 지연 시간에 민감하며, 정확히 deepseek-v4-flash와 claude-haiku-4-5-20251001이 가격 매겨진 프로필입니다.

Writer     -> claude-sonnet-4-6        (drafts, long answers)
Quick      -> claude-haiku-4-5-20251001 (default chatter)
Bilingual  -> glm-5.2                   (zh/en mixed threads)
Translate  -> deepseek-v4-flash         (short, frequent turns)

all four assistants -> one provider -> one key

네이티브 클라이언트를 위한 모델 선택.

어시스턴트별 바인딩은 비교를 수월하게 만듭니다: 어시스턴트를 복제하고 모델만 바꾼 다음, 하루 동안 실제 질문으로 둘 다 돌려보세요. 사용량 로그가 id별로 비교 가격을 매기는 동안 대화가 어느 쪽을 계속 열게 됐는지 알려줍니다.

  • 폰 우선 사용은 지연 시간 우선 사용입니다. claude-haiku-4-5-20251001과 deepseek-v4-flash는 앱이 네트워크가 아니라 네이티브처럼 느껴질 만큼 충분히 빠르게 답합니다.
  • 일회성 구매 경제는 계량형 키에 유리합니다: 좌석료가 없으므로 유일한 반복 비용은 토큰뿐이며, 일상적인 트래픽을 빠른 id에 두면 무거운 달도 작게 유지됩니다.
  • claude-sonnet-4-6은 여러분을 대신해 글을 쓰는 어시스턴트 자리를 받을 자격이 있으며, 메시지당 가격이 눈에 보이는 품질을 사줍니다.
  • glm-5.2와 kimi-k2.6은 OpenCat 사용자 기반의 상당 부분이 실제로 다루는 중국어-영어 트래픽을 위한 일급 픽입니다; 게이트웨이를 통하면 별도 벤더 계정 없이 Claude와 같은 선택기에 앉습니다.
  • 번역과 음성 턴은 짧고 끊임없습니다; 빠른 티어에 두면 이 기능들이 무료처럼 느껴집니다.

사용한 만큼 지불 · 공식 요금보다 저렴

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

모델공식 요금저희 요금
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
Claude Haiku 4.5 20251001$1.00 / $5.00 per M$0.80 / $4.00 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
GLM-5.2$1.14 / $4.00 per M$1.10 / $4.00 per M
Kimi K2.6$0.95 / $4.00 per M$1.00 / $4.00 per M

OpenCat 특유의 실패 패턴.

설정 이후에도 요청이 계속 api.openai.com으로 간다면 대화가 새 프로바이더를 쓰지 않는다는 뜻입니다. OpenCat에서는 프로바이더들이 공존하며, 이전에 만든 어시스턴트나 대화는 원래의 프로바이더 바인딩을 유지합니다; 새 항목이 전역적으로 대체됐다고 가정하지 말고 그 어시스턴트의 프로바이더와 모델을 바꾸세요. /v1이 없는 API Host는 앱이 요청 경로를 덧붙이면 실패합니다; OpenCat을 위한 게이트웨이 가이드가 일관되게 보여주듯 작동하는 형태는 /v1이 포함된 base, 즉 https://api.apisrouter.com/v1입니다. 비거나 부분적인 모델 목록은 막다른 길이 아닙니다. 자동 목록은 엔드포인트의 모델 목록에 의존하며, OpenCat은 빠진 것에 대해 수동으로 입력한 id를 받아들입니다; 여러분의 키로 조회한 /v1/models 출력이 무엇을 입력할지에 대한 정답 표기입니다. 키는 프로바이더 항목별이므로, 게이트웨이에서 로테이션한 키는 프로바이더 설정에서도 업데이트해야 합니다; 몇 달간 조용하다가 갑자기 실패하는 앱은 보통 앱 문제가 아니라 만료되거나 로테이션된 키 문제입니다. 그리고 한 기기는 작동하고 다른 기기는 실패한다면 설정 동기화 경계가 첫 번째 용의자입니다: 실패하는 기기에 실제로 프로바이더 항목과 키가 있는지 확인하세요.

어떤 사람들이 게이트웨이를 통해 OpenCat을 쓰는가.

  • 구독에서 벗어나려고 앱을 샀고 키 쪽도 똑같이 단순하기를 원하는 BYOK 사용자: 잔액 하나, 모든 모델, 카드 등록 없음.
  • 중국어와 영어를 오가는 이중 언어 사용자 — GLM과 Kimi가 Claude 옆 하나의 선택기에 있는 것이 참신함이 아니라 실제 일상 워크플로우인 사람들.
  • 책상의 Mac과 이동 중 iPhone을 오가며, 벤더별 앱과 로그인 대신 하나의 프로바이더 항목이 둘 다를 서빙하기를 원하는 여러 기기 사용자.
  • OpenCat의 번역 기능을 많이 쓰는 헤비 번역가 — 짧고 빈번한 턴을 빠른 카탈로그 id에 두면 습관이 저렴하게 유지됩니다.
  • 특정 벤더의 결제 수단에 접근할 수 없는 개발자. 카드 없이 충전만으로 사용할 수 있어 프로바이더별 가입 의존성이 사라집니다.

엔드포인트 검증 및 첫 채팅 디버깅.

터미널이 편하다면 먼저 그곳에서 엔드포인트를 확인하세요: 여러분의 키로 모델을 나열하고 쓰려는 id를 확인하세요. iPhone 전용 설정이라면 바로 앱 내 경로로 넘어가세요: 프로바이더를 저장하고, 모델 목록이 채워지는지 지켜보고, 짧은 메시지를 하나 보내세요. 실패 분류는 짧습니다. 인증 오류는 키 필드 문제입니다. 연결이나 not-found 오류는 API Host 문제이며, 거의 항상 /v1이 빠진 것입니다. 모델 오류는 id가 엔드포인트의 목록과 다르게 입력됐다는 뜻입니다. 그리고 예전 프로바이더처럼 동작하는 대화는 예전 프로바이더에 바인딩된 것입니다; 프로바이더 목록이 아니라 어시스턴트 설정을 확인하세요. 메시지가 흐르기 시작하면 APIsRouter 콘솔에서 요청별 모델, 토큰 수, 지출을 볼 수 있습니다. bring-your-own-key 앱에게 이 로그는 재정 전체 그림입니다. 모든 기기와 모든 어시스턴트가 한 페이지에, 구독형 채팅 앱이 절대 주지 않는 바로 그 가시성으로.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

자주 묻는 질문

OpenCat에서 커스텀 OpenAI 호환 프로바이더를 어디에 추가하나요?

Settings, API Providers, Add Provider(또는 기존 OpenAI 항목 편집)에서 추가하세요. protocol을 OpenAI로, API Host를 https://api.apisrouter.com/v1로 설정하고 키를 붙여넣으세요. 모델은 자동으로 목록화되며, 빠진 것은 수동 id 입력이 가능합니다.

API Host에 /v1을 포함해야 하나요?

네. OpenCat을 위한 게이트웨이 설정 가이드에 나오는 작동하는 형태는 /v1을 포함합니다: https://api.apisrouter.com/v1. 없으면 앱이 chat-completions 경로를 덧붙이는 순간 요청이 실패합니다.

OpenCat이 하나의 프로바이더로 Claude, GLM, Kimi를 실행할 수 있나요?

네. OpenCat은 선택된 모델 id를 프로바이더의 호스트로 순수 문자열로 전달하므로, 엔드포인트가 서빙하는 어떤 id도 작동합니다: claude-sonnet-4-6, glm-5.2, kimi-k2.6, deepseek-v4-flash 모두 키 하나 아래 같은 선택기에 앉습니다.

원하는 모델이 OpenCat의 목록에 없습니다. 막힌 건가요?

아니요. 자동 목록은 엔드포인트의 모델 목록에서 오며, OpenCat은 수동으로 추가된 모델 id를 받아들입니다. /v1/models 출력에 나타난 그대로 정확히 id를 입력하면 나열된 다른 모델처럼 선택 가능해집니다.

커스텀 프로바이더를 쓰려면 OpenCat Pro가 필요한가요?

OpenCat은 무료 티어와 일회성 Pro 구매(2026년 7월 기준 opencat.app에 9.99달러로 등재)를 제공하며, Pro는 iCloud 동기화 같은 편의 기능을 더합니다. Bring-your-own-key 사용은 이 앱의 핵심 설계입니다; 티어는 계속 바뀌므로 opencat.app에서 현재 기능 구분을 확인하세요.

왜 제 기기 중 하나는 작동하고 다른 하나는 실패하나요?

프로바이더 항목과 키는 설정 동기화를 통해 다른 기기에 도달하며, 이는 여러분의 티어와 iCloud 상태에 달려 있습니다. 실패하는 기기의 프로바이더 설정을 열어 항목과 키가 실제로 존재하는지 확인하고, 없다면 다시 입력하세요.