홈 → 가이드 → Cherry Studio에서 커스텀 API 쓰기: 주소, 모델, Claude, 이미지 입력

Cherry Studio에서 커스텀 API 쓰기: 주소, 모델, Claude, 이미지 입력

Cherry Studio에 제공자를 추가하는 데는 1분도 걸리지 않습니다. 자주 틀리는 건 API 주소 하나뿐인데, Cherry가 /v1을 스스로 붙이기 때문입니다. 스크린샷을 첨부하기 시작하면 어떤 모델이 실제로 이미지를 보는지가 중요해집니다. 7개 모델로 시험했습니다.

제공자 추가

설정 → 모델 제공자를 열고 추가를 누릅니다. 이름(예: APICLAN)을 정하고 제공자 유형은 OpenAI를 고릅니다.
콘솔에서 받은 API 키를 붙여 넣습니다.
API 주소에 https://apiclan.us를 입력합니다.
확인을 누르고 아무 모델이나 골라 키가 작동하는지 확인합니다.

입력한 값	Cherry Studio가 호출하는 주소
`https://apiclan.us`	`https://apiclan.us/v1/chat/completions` ✓
`https://apiclan.us/v1/`	`https://apiclan.us/v1/chat/completions` ✓
`https://apiclan.us/v1`	`https://apiclan.us/v1/v1/chat/completions` ✗ 404

주소가 /로 끝나지 않으면 Cherry Studio는 뒤에 /v1/chat/completions를 붙입니다. 그래서 https://apiclan.us와 https://apiclan.us/v1/는 둘 다 되지만, 끝 슬래시 없는 https://apiclan.us/v1은 /v1/v1이 되어 404를 반환합니다.

모델 추가

제공자 아래의 관리를 누릅니다. Cherry Studio는 /v1/models에서 목록을 가져오며, 이 목록에는 키가 속한 그룹의 모델만 나옵니다. 2026년 10월 12일 기준:

GPT 그룹: gpt-5.6-sol, gpt-5.6-terra, gpt-6-astra, gpt-6-sol, gpt-6.1-sol
DeepSeek 그룹: deepseek-v4-flash, deepseek-v4-pro, deepseek-v4.1-flash (날짜가 붙은 버전 포함)

쓰려는 모델 옆의 +를 누르세요. 목록에 모델이 없다면 키가 다른 그룹에 속한 것입니다. 이 게이트웨이의 키는 각각 하나의 그룹에 묶여 있습니다.

Claude 추가

유형을 Anthropic으로 한 제공자를 하나 더 추가하고, 주소는 똑같이 https://apiclan.us, 키는 Claude 그룹에서 만든 것을 씁니다. 그다음 claude-opus-5-5 또는 claude-fable-5-1을 추가합니다. 그룹마다 제공자를 하나씩 두면 키가 섞이지 않습니다. GPT, DeepSeek, Claude를 각각 따로 두세요.

첨부한 이미지를 읽는 모델

Cherry Studio가 쓰는 OpenAI 형식 요청으로 각 모델에 한 가지 색으로 채운 작은 이미지를 보내 무슨 색인지 물었습니다. 우연히 맞히는 경우를 막으려고 다른 색으로 한 번 더 시험했습니다.

모델	이미지 인식	응답 시간
`claude-opus-5-5`	✓	3.1 s
`claude-fable-5-1`	✓	3.3 s
`deepseek-v4.1-flash`	✓	2.3–3.1 s
`gpt-6-astra`	✓	6.6 s
`gpt-5.6-sol`	✓	7.3 s
`gpt-6.1-sol`	✓	24–25 s
`deepseek-v4-pro`	✗	—

deepseek-v4-pro는 이미지를 받지 않습니다. 초록색 이미지에 'white'라고 답했고, 다른 한 번은 아무것도 돌려주지 않았으며 둘 다 오류는 없었습니다. 스크린샷에는 체크된 모델을 쓰세요. gpt-6.1-sol은 이미지를 정확히 읽지만 약 24초가 걸렸고, 텍스트만 보낼 때는 첫 토큰까지 2.6초였습니다. 어떤 모델에 이미지 버튼이 보이지 않으면 해당 모델 설정을 열어 비전을 체크하세요. 2026년 10월 12일 측정.

자주 나오는 오류

401 → 키가 틀렸거나, 키와 제공자가 맞지 않습니다(예: GPT 그룹 키를 Anthropic 제공자에 넣음).
404 → 주소가 슬래시 없이 /v1로 끝납니다. https://apiclan.us로 바꾸세요.
model_not_found (is not supported by any configured account in this group) → 그 모델이 키의 그룹에 없습니다. 직접 입력하지 말고 관리에서 추가하세요.
답변이 이미지를 무시함 → 그 모델은 이미지를 읽지 못합니다. 위 표에서 체크된 모델로 바꾸세요.

코딩 도구도 설정하나요? Cline에서 커스텀 API 쓰기 · Codex에서 커스텀 API 쓰기.

사용 시작하기

구독 없음, 월 최소 사용액 없음, 영업 통화 없음. USDT로 충전하고 쓴 만큼만 지불하세요 — 1 USDT는 2 크레딧의 API 잔액이 됩니다.

30초 빠른 시작 읽기

언어: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

이 페이지의 가격은 실제 과금 데이터에서 자동으로 채워집니다. 제3자 조건은 해당 업체의 공개 문서에서 인용했습니다.