문서

문서

Msty Studio

Msty Studio 문서에는 OpenAI 호환 엔드포인트를 공급자로 추가할 수 있다고만 나와 있습니다. 앱 자체에는 더 구체적인 내용이 있습니다. 공급자 유형과 두 필드, /v1 규칙을 확인할 수 있습니다. 여기서는 해당 양식에 Kunavo 설정을 입력하는 방법을 안내합니다.

Model Hub > Model Providers > Add Provider > Open AI Compatible: API Key와 https://api.kunavo.com/v1의 Inference Endpoint를 입력합니다 — 앱 자체 안내에 따르면 대부분의 OpenAI 호환 엔드포인트에는 /v1이 필요합니다

Msty Studio 2.9.11 — Add Provider
Model Hub  >  Model Providers  >  Add Provider

Provider             Open AI Compatible     (under "OpenAI Compatible")
Name                 Kunavo                 "Give it a name (optional)"
API Key              sk-kn-...
Inference Endpoint   https://api.kunavo.com/v1      <- keep the /v1

Models               Fetch Models, then tick the ids you want
                     (or Add Custom Model: Model ID + Model Name)
                                                     → Save Provider
/v1을 유지하세요. Msty 자체 안내입니다. 배포된 앱의 Inference Endpoint 필드 아래에는 다음 문구가 표시됩니다. “대부분의 OpenAI 호환 공급자 엔드포인트에는 /v1 경로가 필요합니다. 예: https://example.com/v1.” Msty Studio는 입력한 주소에 /models와 /chat/completions만 추가합니다. /v1가 없으면 Fetch Models는 https://api.kunavo.com/models로 요청하고 채팅 요청은 https://api.kunavo.com/chat/completions로 전송됩니다. 2026년 10월 1일부터 두 요청 모두 /v1를 추가하라는 메시지가 포함된 JSON 404를 반환합니다. 그전에는 모델 가져오기 요청이 웹 페이지를 읽었습니다.
이러한 항목명이 어디서 왔는지 Msty 온라인 문서에는 필드 이름이 나와 있지 않습니다. 위 항목명은 Msty Studio 2.9.11 데스크톱 빌드에 포함된 문자열입니다. 2026년 10월 1일 Msty 자체 서버에서 다운로드해 실행하지 않고 확인했으므로 앱에 표시되는 영어 문구와 일치합니다. 이후 릴리스에서 문구가 바뀔 수 있으니 사용자 화면에 표시되는 앱을 기준으로 삼으세요.
처음부터 끝까지 실행해 본 것은 아닙니다. 여기서는 누구도 Msty Studio에서 Kunavo로 메시지를 보내지 않았습니다. 공급자 양식과 /v1 안내, 요청 경로는 릴리스된 빌드에서 확인했고 Kunavo 측은 일반 HTTP 요청으로 확인했습니다. 이 공급자 유형을 통한 스트리밍, 도구 호출, 이미지 입력 및 사고 제어 기능은 테스트되지 않았습니다. 실제 확인은 첫 채팅에서 이루어집니다.
아직 키가 없나요? Kunavo 계정을 만들고, 키를 생성한 다음(키는 sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 Msty Studio 설정 화면에서 열립니다.

단계별 안내

  1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
  2. Msty Studio에서 Model Hub > Model Providers를 열고 Add Provider를 선택하세요. 공급자 목록에서 OpenAI Compatible 제목 아래의 Open AI Compatible을 선택하세요. 고정된 OpenAI 공급자인 OpenAI와 혼동하지 마세요.
  3. 이름을 지정하고 키를 API Key에 붙여 넣은 뒤 Inference Endpoint에 https://api.kunavo.com/v1를 입력하세요. 앱은 이 주소가 https://로 시작해야 한다고 요구합니다.
  4. Fetch Models를 클릭하고 사용할 모델을 선택하세요. Kunavo는 전체 카탈로그를 GET /v1/models에서 제공하므로 일부 모델만 선택하는 편이 좋습니다. 원한다면 Add Custom Model을 열고 카탈로그 표기와 정확히 일치하는 Model ID를 입력할 수도 있습니다. 예: claude-sonnet-5.
  5. Save Provider를 클릭한 다음 대화를 열고 해당 모델 중 하나를 선택하세요. Msty 자체 문서에 나온 테스트 단계입니다. 응답이 도착하면 엔드포인트, 키, 모델 ID가 모두 올바른 것입니다.

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

이것이 요약본입니다. 전체 안내—모델 선택, 실제 세션 비용, 실패 유형—는 Msty Studio 가격 및 API 비용에 있습니다.

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

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

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

모델 IDKunavo 입력/출력Msty Studio에서의 위치
claude-sonnet-5$1.40 / $7.00긴 문서와 Knowledge Stack 채팅에서 대부분의 대화에 기본 모델로 사용할 모델
gpt-5-6-terra$0.70 / $4.20분할 채팅 비교 창에서 사용할 두 번째 모델 계열
claude-haiku-4-5$0.70 / $3.50간단한 질문과 제목, 여러 번 실행하는 작업
월정액 없이 선불 잔액에서 토큰별로 청구됩니다. billing을 참고하세요. 반복되는 컨텍스트(에디터나 채팅 클라이언트가 보내는 데이터의 대부분)에서는 모델 선택보다 프롬프트 캐싱이 청구액에 더 큰 영향을 줍니다.

여기서 다루는 Msty 제품

  • Msty Studio — 이 페이지에서 다루는 데스크톱 및 웹 작업 공간입니다. 공급자 설정은 Model Hub > Model Providers에 있습니다.
  • Msty Go — Settings 아래에 별도의 공급자 화면이 있는 에이전트 앱입니다. 설정 방법은 전용 페이지에 있습니다.
  • Msty 1.x — 지원이 종료된 앱입니다. 동결된 문서는 여전히 docs.msty.app에서 검색 결과 상위에 표시됩니다. 해당 화면은 Studio와 다릅니다.

앱 오류 메시지의 의미

아래는 2.9.11에 포함된 메시지와 이 엔드포인트에서 각 메시지가 뜻하는 내용입니다.

  • “공급자 엔드포인트를 찾을 수 없습니다. 엔드포인트 URL을 확인하고 /v1과 같은 올바른 API 경로가 포함되어 있는지 확인하세요.” — Inference Endpoint에 /v1가 빠져 있습니다.
  • “공급자 엔드포인트에 연결할 수 없습니다…” — 호스트를 잘못 입력했거나, https://여야 할 자리에 http://를 입력했습니다.
  • Fetch Models가 실패하지만 URL은 올바른 경우 — 키를 확인하세요. Kunavo 모델 목록을 가져오려면 유효한 키가 필요하며 키가 없으면 401을 반환합니다.
  • 모델은 목록에 있지만 채팅에서 오류가 나는 경우 — Msty 자체 양식에는 “모든 모델이 Msty에서 테스트된 것은 아닙니다”라는 경고가 있습니다. Kunavo 목록에는 채팅 창에서 사용할 수 없는 이미지, 비디오, 오디오 모델이 포함되어 있습니다. 채팅 모델을 선택하세요.

사용자 컴퓨터에서 전송되는 데이터

Msty는 온라인 공급자를 “기기에서 모델 추론을 실행하지 않고 API 키로 호스팅 모델을 사용하는” 방법이라고 설명합니다. 따라서 Kunavo 모델을 사용하는 대화의 프롬프트와 첨부된 컨텍스트는 Kunavo로 전송된 다음 모델 제공업체로 전달됩니다. 로컬 모델을 사용하는 대화는 그렇지 않습니다. 이 데이터 경계가 중요하다면 민감한 자료에는 로컬 모델을 사용하세요.

이 공급자 유형의 사고 강도

Msty 문서에 따르면 “OpenAI Compatible Models”의 사고 강도 지원은 None과 Default뿐이며, 자체 Anthropic 공급자는 Think Lightly, Moderately, Deeply를 제공합니다. Open AI Compatible 유형을 통해 Claude 모델을 사용하면 세분화된 단계가 아니라 기본 추론 수준으로 실행될 것으로 예상하세요.

자주 묻는 질문

Msty Studio에 사용자 지정 OpenAI 호환 공급자를 어떻게 추가하나요?

Model Hub > Model Providers를 열고 Add Provider를 선택하세요. OpenAI Compatible 제목 아래에서 Open AI Compatible을 선택하고, 이름을 지정하고, 키를 API Key에 붙여 넣은 다음 버전 경로를 포함해 Inference Endpoint를 입력하세요. Kunavo의 경우 https://api.kunavo.com/v1입니다. Fetch Models를 클릭해 목록을 불러오거나 Add Custom Model을 사용해 Model ID를 입력한 다음 Save Provider를 선택하세요. 이 항목명은 Msty Studio 2.9.11 빌드에 포함된 문자열입니다. Msty 온라인 문서에는 같은 절차가 설명되어 있지만 필드 이름은 나오지 않습니다.

Msty Studio 엔드포인트에는 /v1이 필요한가요?

대부분의 OpenAI 호환 공급자에서는 그렇습니다. 앱 자체 안내에 따르면 Inference Endpoint 필드 아래에 “대부분의 OpenAI 호환 공급자 엔드포인트에는 /v1 경로가 필요합니다. 예: https://example.com/v1. 문제가 발생하면 엔드포인트에 /v1을 추가해 보세요.”라고 표시됩니다. Msty Studio는 /models와 /chat/completions만 추가하므로 Kunavo 엔드포인트는 https://api.kunavo.com/v1입니다. /v1이 없으면 모델 가져오기와 채팅 모두 /v1을 추가하라는 메시지가 포함된 404 오류가 발생합니다.

Msty Studio의 사용자 지정 공급자는 Msty Go의 사용자 지정 공급자와 동일한가요?

아니요. 두 앱은 서로 다른 공급자 화면을 사용합니다. Msty Studio에서는 여기서 설명하는 Open AI Compatible 유형을 선택해 Model Hub > Model Providers에서 공급자를 추가합니다. 이전에 Msty Claw라고 불렸던 에이전트 앱인 Msty Go에서는 Settings > Model Providers에서 별도의 필드 구성을 사용해 공급자를 설정합니다. 한쪽의 설정 안내를 다른 쪽에 적용할 수 없으며, 검색 결과에 예전 문서가 여전히 표시되는 단종된 Msty 1.x 앱과도 둘 다 다릅니다.

Msty Studio에서 사용자 지정 공급자를 사용하면 누가 요금을 청구하나요?

각각 별도로 두 곳에서 청구합니다. 해당하는 경우, Msty는 사용 중인 앱 요금제를 청구합니다. 모델 호출 요금은 공급자의 API Key 필드에 입력한 키를 발급한 곳에서 청구합니다. Kunavo 키를 사용하면 선불 Kunavo 잔액에서 토큰당 차감됩니다. Msty에서 실행하는 로컬 모델은 요청당 비용이 없습니다. 위에 링크된 Msty Studio 요금 페이지에서 요금제와 일반적인 장문 문서 대화의 카탈로그 요금 기준 비용을 자세히 확인할 수 있습니다.

Kunavo에서 Msty Studio를 테스트했나요?

처음부터 끝까지 테스트하지는 않았습니다. 2026년 10월 1일, 공식 Msty Studio 2.9.11 데스크톱 빌드를 Msty 서버에서 다운로드해 실행하지 않고 살펴봤습니다. 이 페이지의 공급자 유형, 필드 레이블, /v1 안내, 오류 메시지와 요청 경로는 해당 빌드에서 가져왔습니다. Kunavo 측은 직접 HTTP 요청으로 확인했습니다. Msty Studio에서 Kunavo로 채팅을 실행하지 않았으므로 이 공급자를 통한 스트리밍, 도구 사용, 이미지 입력은 검증되지 않았습니다.