# 기타 OpenAI 호환 앱

대부분의 AI 앱은 OpenAI 호환 공급자를 지원합니다. 아래 세 항목만 제대로 넣으면 NezhaGate의 모든 채팅 모델을 쓸 수 있습니다.

> https://nezhagate.com/ko/docs/integrations/openai-compatible

## 이 세 항목을 입력하세요

| 설정 항목 | 입력할 내용 |
| --- | --- |
| **기본 URL / API 호스트** | `https://nezhagate.com/v1` |
| **API 키** | 콘솔의 「API Keys」 페이지에서 만든 키(`sk-`로 시작). |
| **모델** | 모델 ID(예: `gpt-5.5`). 전체 목록은 [API 레퍼런스](https://nezhagate.com/ko/docs/api)에 있고 `/v1/models`로도 받을 수 있습니다. |

## 주소는 정확히 무엇을 넣나요?

앱마다 요구하는 형식이 다릅니다. 앱의 안내와 오류 메시지를 보고 맞추세요:

- 앱이 기본 URL, API Base, 프록시 주소를 물으면: `https://nezhagate.com/v1`

- 앱이 스스로 /v1을 붙이면(오류에 /v1/v1/이 보임): `https://nezhagate.com`

- 앱이 전체 엔드포인트(API URL, Endpoint)를 물으면: `https://nezhagate.com/v1/chat/completions`

## 먼저 터미널에서 키 확인하기

아래 명령이 모델 목록을 돌려주면 주소와 키는 문제가 없고, 앱 설정을 다시 확인하면 됩니다.

```
curl https://nezhagate.com/v1/models -H "Authorization: Bearer YOUR_API_KEY"
```

### 자주 나오는 오류

- **401**: 키를 잘못 입력했거나 공백이 섞였거나 키가 정지되었습니다.

- **404**: 주소가 틀렸습니다. 위 세 가지 방식 중 다른 것으로 바꿔 보세요.

- **400 model_not_found**: 모델 이름 철자가 틀렸거나 판매가 끝난 모델입니다.

- **402**: 잔액이 부족하거나 키가 예산 한도에 도달했습니다.

## 이미지와 영상

채팅 앱의 그림 그리기 기능은 보통 OpenAI 형식의 동기 응답을 기다리지만, NezhaGate의 이미지·영상 엔드포인트는 작업 ID부터 돌려주는 비동기 작업이라 이런 기능은 대개 동작하지 않습니다. 이미지와 영상은 API를 직접 호출하거나 웹사이트의 Playground에서 만드세요.

## 단계별 가이드가 있는 앱

아래 앱들은 단계별로 직접 확인했습니다. 그대로 따라 하면 됩니다:

- [Cline](https://nezhagate.com/ko/docs/integrations/cline): VS Code에서 DeepSeek, Kimi, GLM, Qwen, Claude로 코드를 작성합니다.

- [Cherry Studio](https://nezhagate.com/ko/docs/integrations/cherry-studio): 데스크톱 AI 클라이언트: 공급자를 추가하고 모델을 골라 대화합니다.

- [SillyTavern](https://nezhagate.com/ko/docs/integrations/sillytavern): 롤플레이 채팅 프런트엔드를 단계별로 NezhaGate에 연결합니다.

### Claude 전용 도구

Claude Code처럼 Anthropic API만 쓰는 도구는 [Claude Code](https://nezhagate.com/ko/docs/integrations/claude-code)를 보세요.