NezhaGate

NezhaGate 자주 묻는 질문

연동, 과금, 모델, 보안에 대해 자주 묻는 질문.

기본 개념

NezhaGate는 무엇인가요?
NezhaGate는 OpenAI 호환 AI 모델 게이트웨이로, 하나의 API와 하나의 키로 GPT, Claude, Gemini와 이미지 생성 모델에 연결해 줍니다. 공급사마다 따로 연동하는 대신 Base URL을 NezhaGate로 돌리면, 이미 쓰고 있는 OpenAI SDK로 여러 플래그십 모델을 호출할 수 있습니다. 플랫폼에는 API 키 관리, 잔액과 사용량 추적, 모델 마켓, 개발자 문서가 들어 있으며 사용한 만큼 과금하고 실패한 요청에는 과금하지 않습니다.
"채팅, 이미지, 영상 — 하나의 API"는 구체적으로 무슨 뜻인가요?
Base URL 하나와 API 키 하나로 세 가지 일을 모두 처리한다는 뜻입니다. 채팅은 /v1/chat/completions, 이미지는 /v1/images/generations(이미지-투-이미지는 /v1/images/edits), 영상은 /v1/videos/generations를 씁니다. 뒤에 있는 업스트림은 OpenAI(GPT), Anthropic(Claude), Google(Gemini), 바이트댄스(Seedance), 알리바바(Wan), xAI(Grok), MiniMax이며, 공급사마다 SDK를 연동하고 계정을 만들고 정산을 따로 할 필요가 없습니다. 모델을 바꾸거나 비교할 때는 model 파라미터 하나만 바꾸면 됩니다.

지원 모델

어떤 모델을 지원하나요?
현재 OpenAI 계열은 GPT-6 Astra, GPT-5.6 제품군(Sol / Terra / Luna), GPT-5.5와 이미지 모델 GPT Image 2 및 GPT Image 2.5(Flare / Sunburst)를, Anthropic 계열은 Claude Opus 5, Claude Fable 5, Claude Sonnet 4.6을, Google 계열은 Gemini 3.1 Pro와 Gemini 3.8 / 3.7 / 3.6 / 3.5 / 3 / 2.5 Flash 및 이미지 모델 Nano Banana 2와 Nano Banana Pro를 제공합니다. 영상 모델로는 Veo 3.1, Seedance 2.5와 2.0 계열, Wan 3.0, MiniMax H3, Grok Imagine Video 1.5가 있습니다. 새 모델은 계속 추가됩니다. 항상 최신인 전체 모델 목록과 성능 설명은 모델 마켓 페이지에 있으며, 모든 모델을 같은 엔드포인트와 같은 키로 호출합니다.
GPT, Claude, Gemini를 모두 지원하나요?
지원합니다. GPT(OpenAI), Claude(Anthropic), Gemini(Google)의 주요 모델을 하나의 OpenAI 호환 인터페이스로 모두 쓸 수 있습니다. 모델을 바꿀 때는 요청의 model 필드만 바꾸면 되고 새 SDK나 재연동이 필요 없습니다.
이미지 생성 모델도 지원하나요?
지원합니다. gpt-image-2를 비롯한 이미지 생성 모델을 /v1/images/generations 엔드포인트로 호출할 수 있고 텍스트-투-이미지와 이미지-투-이미지를 모두 지원합니다. 결과는 직접 링크로 돌려주므로 앱에서 그대로 참조할 수 있습니다. 사용 가능한 이미지 모델과 파라미터는 모델 마켓과 문서에 정리되어 있습니다.
모델 마켓의 가격과 성능 설명은 얼마나 자주 갱신되나요?
모델 마켓의 가격과 성능 설명은 백엔드 설정을 실시간으로 따라가므로 가격이 바뀌면 페이지에 곧바로 반영됩니다. 새 모델이 출시되거나 과금이 바뀌면 해당 항목을 갱신합니다. 모델 마켓과 요금 페이지에 실시간으로 표시되는 값을 기준으로 삼아 주세요.

요금과 과금

NezhaGate는 어떻게 과금하나요?
NezhaGate는 선불 크레딧과 사용한 만큼 과금하는 방식을 씁니다. 채팅 모델은 입력 / 출력 토큰으로, 이미지 모델은 장수와 해상도로 과금하며 단가는 요금 페이지와 모델 마켓에 표시됩니다. 월 정액제는 없고 쓴 만큼만 내며 실제 사용량대로 잔액이 차감됩니다. 호출마다의 사용량과 비용은 콘솔에서 모두 확인할 수 있습니다.
왜 가격이 더 경쟁력 있나요?
NezhaGate는 통합 게이트웨이, 투명한 종량제 과금, 원가 최적화를 통해 더 경쟁력 있는 모델 이용 가격을 제공합니다. 실제 가격은 요금 페이지와 모델 마켓에 표시된 값을 따릅니다.
크레딧에 유효 기간이 있나요?
충전한 크레딧에는 현재 단기 유효 기간이 없으며 최신 규정은 플랫폼 공지를 따릅니다. 실패한 요청에는 과금하지 않고 잔액은 실제 사용량만큼만 차감됩니다.
실패한 요청에도 과금되나요?
실패한 요청에는 과금하지 않습니다. 정상적으로 응답한 호출만 실제 사용량으로 과금하며 업스트림 오류나 타임아웃은 잔액을 쓰지 않습니다. 콘솔에서 실패 기록이 보이더라도 그에 대한 비용은 차감되지 않습니다.
잔액과 사용량은 어떻게 확인하나요?
로그인하면 콘솔에서 실시간 잔액, 키별 사용량, 모든 호출 기록을 볼 수 있습니다. 호출 로그에는 모델, 시각, 토큰 / 이미지 수, 비용이 담겨 있어 대사와 디버깅이 쉽습니다. 잔액 조회 엔드포인트로 프로그램에서 현재 잔액을 읽을 수도 있습니다.

연동과 개발

NezhaGate를 빠르게 시작하려면 어떻게 하나요?
세 단계면 됩니다. 계정을 만들고, 콘솔에서 API 키를 발급하고, Base URL을 NezhaGate로 돌린 뒤 키를 넣으면 됩니다. OpenAI와 완전히 호환되므로 기존 OpenAI SDK 코드는 거의 고칠 필요가 없고 base_url과 api_key만 바꾸면 됩니다. 자세한 내용은 개발자 문서를 참고하세요.
Base URL은 어떻게 설정하나요?
Base URL을 https://nezhagate.com/v1 로 설정하세요. OpenAI SDK에서는 base_url(또는 OPENAI_BASE_URL 환경 변수)을 이 주소로 두고 콘솔에서 만든 키를 쓰면 됩니다. 채팅은 /v1/chat/completions, 이미지는 /v1/images/generations를 쓰며 경로는 OpenAI와 같습니다.
OpenAI SDK와 호환되나요?
호환됩니다. NezhaGate는 OpenAI 호환 인터페이스를 구현하므로 공식 openai SDK에서 base_url과 api_key만 바꾸면 동작합니다. 요청과 응답 형태가 OpenAI와 같고 스트리밍 출력과 멀티모달 입력도 지원합니다.
Python, Node.js, curl을 지원하나요?
지원합니다. HTTP 요청을 보낼 수 있거나 OpenAI SDK를 쓸 수 있는 언어라면 무엇이든 되며 Python, Node.js, Go, Java, 순수 curl 모두 포함됩니다. 문서에 바로 실행할 수 있는 Python, Node.js, curl 예제가 있습니다.
n8n, Dify, LangChain, Open WebUI, LobeChat, Cherry Studio, ChatBox를 지원하나요?
지원합니다. 이들 도구는 대부분 OpenAI 호환 Base URL과 API 키를 직접 지정할 수 있으므로, NezhaGate로 돌리면 플랫폼의 모델을 그대로 쓸 수 있습니다. OpenAI 호환이나 사용자 지정 엔드포인트를 지원하는 도구라면 별도 플러그인 없이 연결됩니다.
API 키가 유출되면 어떻게 하나요?
API 키가 유출된 것 같으면 콘솔에서 즉시 삭제하거나 교체하세요. 폐기한 키는 더 이상 사용할 수 없습니다. 프로젝트마다 키를 따로 만들고 프런트엔드 코드나 공개 저장소에 키를 넣지 않기를 권합니다. 콘솔에서 키별 사용량을 언제든 확인해 이상 징후를 잡을 수 있습니다.

무엇이 다른가

NezhaGate는 OpenAI / Claude / Gemini 공식 API와 무엇이 다른가요?
공식 API는 모델 공급사가 직접 제공하며 공식 계정과 자체 과금 체계를 갖춘 팀에 맞습니다. NezhaGate는 통합 모델 게이트웨이에 가까우며 여러 모델에 대한 접근, OpenAI 호환 호출, 과금 관리, 개발 효율에 초점을 둡니다.
NezhaGate의 모델 성능은 공식과 같나요?
NezhaGate는 주요 모델의 성능에 접근하는 통합된 방법을 제공합니다. 구체적인 성능, 컨텍스트, 속도, 사용 가능한 기능은 모델 마켓과 문서에 적힌 내용을 따릅니다.
NezhaGate는 어떤 상황에 가장 잘 맞나요?
한 프로젝트에서 여러 모델 공급사를 호출해야 하거나, 과금과 사용량을 한곳에서 관리하고 싶거나, 여러 모델을 빠르게 검증하고 싶을 때 잘 맞습니다. AI 도구 사이트, SaaS 제품, 자동화 워크플로, 에이전트, 다중 모델 비교에 많이 쓰입니다. 모델 사이를 유연하게 오가야 할 때 특히 편합니다.
상업용 프로젝트나 AI 도구 사이트에 써도 되나요?
됩니다. NezhaGate는 OpenAI 호환 인터페이스, API 키 관리, 종량제 과금, 호출 로그를 제공하므로 상업용 제품과 도구 사이트에 넣기에 적합합니다. 플랫폼 약관과 업스트림 공급사의 이용 정책을 지켜 주세요. 프로덕션에 올리기 전에 용도에 맞는 라인과 할당량을 먼저 확인해 보시길 권합니다.

보안과 규정

제 계정과 API 키는 안전한가요?
API 키는 생성할 때 딱 한 번만 전체가 표시되고, 그 뒤로 콘솔에는 접두어만 보이며 언제든 비활성화하거나 삭제할 수 있습니다. 키마다 지출 한도, 분당 요청 수 제한, 모델 허용 목록, IP 허용 목록을 따로 걸 수 있어 키 하나가 유출되어도 다른 프로젝트에는 닿지 않습니다. 모든 호출과 모든 잔액 변동이 항목별로 기록되므로 청구서와 사용량이 언제나 맞아떨어집니다. 요청 내용은 그 호출을 처리하고 과금하는 데에만 쓰이며 모델 학습에는 절대 쓰지 않습니다.
NezhaGate를 쓸 때 무엇을 유의해야 하나요?
API 키를 안전하게 보관하고 필요한 만큼 충전하며 플랫폼 약관과 업스트림 공급사의 이용 정책을 지켜 주세요. 호출 전에 요금 페이지를 확인해 과금 방식을 파악하면 의도치 않게 큰 사용량이 발생하는 것을 막을 수 있습니다. 구체적인 기능, 가격, 사용 가능한 모델은 최신 페이지에 표시된 내용을 따릅니다.
금지되는 사용에는 어떤 것이 있나요?
법령이나 업스트림 공급사 정책을 위반하는 용도로는 NezhaGate를 쓸 수 없습니다. 불법 · 침해 · 사기 · 악성코드 콘텐츠를 만들거나 퍼뜨리는 행위, 자동화된 남용, 할당량이나 안전 장치를 우회하는 행위가 여기에 포함됩니다. 위반하면 계정이 제한되거나 해지될 수 있습니다. 전체 규정은 서비스 약관에 있습니다.
기업 협업이나 대량 호출도 가능한가요?
가능합니다. NezhaGate는 더 큰 규모의 배치 호출을 처리할 수 있으며 기업 문의를 환영합니다. 더 높은 동시성, 전용 할당량, 연동 관련 요구가 있으시면 strandbergwickstrom@gmail.com 으로 메일을 보내시거나 사이트의 문의하기로 연락해 주세요. 사용량과 상황에 맞춰 안을 제안해 드립니다.
모델 마켓 둘러보기 요금 보기