# 채팅 앱으로 쓰기 (개발 없이)

> 코드를 안 써도 돼요. 앱에 주소와 키만 넣으면 돼요.

> 원문: https://oneport.kr/docs/guides/chat-app

발급받은 키는 그 자체로는 화면이 없어요. 대화창이 있는 앱에 주소와 키를 넣으면, 그 앱에서 Claude·GPT·Gemini·Grok·DeepSeek 를 한 키로 골라 쓸 수 있어요.

## 앱에 넣을 값 세 가지

| 넣는 곳 | 값 |
| --- | --- |
| API 제공자 / Provider | OpenAI (또는 OpenAI 호환 · Custom) |
| Base URL / API Host | https://oneport.kr/v1 |
| API Key | sk-so- 로 시작하는 발급받은 키 |
| Model | 목록에서 고르거나 /v1/models 의 id 를 그대로 |

> **모델 목록은 앱이 알아서 불러와요**
>
> 주소와 키를 넣으면 앱의 모델 선택 칸에 부를 수 있는 모델이 채워져요. 목록이 안 뜨는 앱이면 model 칸에 id 를 직접 적으셔도 돼요.

## 어떤 앱을 쓰나요

「OpenAI 호환 주소를 직접 넣을 수 있는」 데스크톱 채팅 앱이면 됩니다. Chatbox · Cherry Studio · Jan 같은 앱이 그런 설정을 제공해요. 학교에서 여러 분이 함께 쓰신다면 아래 두 번째 방법이 더 편해요.

- 혼자 또는 소수 — 앱을 하나 설치하고 위 세 값을 넣으면 바로 시작돼요.
- 학교·기관에서 여러 명 — Open WebUI·LibreChat 같은 오픈소스 웹 화면을 기관이 한 번 올려 두면, 구성원은 설치 없이 브라우저로 들어와 쓰게 돼요. 계정 관리와 이용 기록도 그 화면에서 한 번에 봐요.

> **⚠️ 저희가 확인한 것과 아닌 것**
>
> 저희가 확인한 것은 이 게이트웨이가 OpenAI 규격을 지킨다는 사실이에요 — 모델 목록·스트리밍 응답·도구 호출·사용량 표시·한 키로 여러 벤더까지 실제로 주고받아 확인했어요. 개별 앱의 화면과 설정 이름은 앱마다 다르고 저희가 전부 시험해 보지는 않았어요. 붙이시다 막히면 알려 주세요.

> **⚠️ 웹페이지 안에서 직접 부르는 방식은 막혀 있어요**
>
> 브라우저 자바스크립트로 이 주소를 바로 부르면 차단돼요(CORS 미허용). 키가 웹페이지에 그대로 실리는 걸 막기 위한 것이고, 원래 AI 회사들의 API 도 같은 방식이에요. 위의 데스크톱 앱이나 기관이 올린 서버 화면은 서버에서 부르므로 영향이 없어요.

## 처음 고를 모델

가벼운 모델로 시작하시고 결과가 아쉬울 때만 무거운 모델로 바꾸세요. 같은 질문이라도 모델에 따라 비용이 수십 배 차이 나요. 모델별 실제 비용은 모델과 단가 문서에 있어요.

