NezhaGate 자주 묻는 질문
연동, 과금, 모델, 보안에 대해 자주 묻는 질문.
최종 업데이트:
기본 개념
NezhaGate는 무엇인가요?
NezhaGate는 OpenAI 호환 AI API 플랫폼입니다. 키 하나로 채팅, 이미지, 영상 모델을 모두 쓸 수 있습니다. 기존 OpenAI SDK 코드는 기본 URL을 https://nezhagate.com/v1로 바꾸고 NezhaGate 키를 넣기만 하면 연결되며, Claude 모델은 Anthropic 네이티브 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 파라미터 하나만 바꾸면 됩니다.
NezhaGate는 공식 OpenAI / Claude / Gemini API와 무엇이 다른가요?
NezhaGate가 제공하는 것은 각 벤더의 원본 모델이고, 달라지는 것은 이용 방식입니다. 키 하나로 모든 벤더의 모델을 호출하고, API는 모두 OpenAI와 호환되며(Claude는 Anthropic 네이티브 API도 지원), 과금·로그·잔액은 콘솔 하나에서 관리됩니다. 주력 모델은 여러 공급사에 연결되어 장애 시 자동으로 전환되고, 공식가 대비 최대 85%를 절약할 수 있습니다.
모델과 품질
어떤 모델을 지원하나요?
NezhaGate는 현재 OpenAI의 GPT-6 패밀리(Astra / 6.1 Sol / Sol / Luna), GPT-5.6 패밀리(Sol / Luna)와 이미지 모델 GPT Image 2, GPT Image 2.5(Flare / Sunburst), Anthropic의 Claude Opus 5.5, Claude Sonnet 5.5, Claude Opus 5, Claude Sonnet 4.6, Claude Fable 5, Google의 Gemini 3.1 Pro, Gemini 3.8 Flash와 이미지 모델 Nano Banana 2.1, Nano Banana 2, Nano Banana Pro, DeepSeek V4.1 Flash와 V4 Flash 0731, Z.ai의 GLM-5.3, Alibaba의 Qwen3.8 패밀리(Max / Flash), xAI의 Grok 4.7과 이미지 모델 Grok Imagine Image(표준 / 고품질), 그리고 영상 모델로 Seedance 2.5와 Seedance 2.0 패밀리, Wan 3.0, MiniMax H3, Grok Imagine Video 1.5를 제공합니다. 모든 모델은 같은 엔드포인트와 키로 호출하며, 실시간 전체 목록은 모델 마켓에서 확인할 수 있습니다.
NezhaGate의 모델은 각 벤더의 오리지널 모델인가요?
네. 요청한 모델이 그대로 답변하며, 출력을 고쳐 쓰지도 않습니다. 유일한 예외는 중국 모델인 GLM, Qwen입니다. 해당 모델의 모든 회선이 동시에 장애를 일으키면 같은 수준 이상의 모델이 대신 답변하고, 요금은 두 모델 중 더 낮은 가격으로 청구되며, 호출 로그에 어떤 모델이 답변했고 어떤 가격이 적용됐는지 표시됩니다. 모든 호출은 로그에서 모델, 사용량, 과금액, 소요 시간을 확인할 수 있고, 모델별 실시간 상태는 상태 페이지에 공개됩니다. 또한 매주 고정된 질문 세트로 주력 모델을 테스트해 성공률, 첫 토큰까지의 시간, 출력 속도를 측정합니다.
GPT, Claude, Gemini를 모두 지원하나요?
지원합니다. GPT(OpenAI), Claude(Anthropic), Gemini(Google)의 주요 모델을 하나의 OpenAI 호환 인터페이스로 모두 쓸 수 있습니다. 모델을 바꿀 때는 요청의 model 필드만 바꾸면 되고 새 SDK나 재연동이 필요 없습니다.
이미지와 영상 생성을 지원하나요?
네. 이미지는 GPT Image 2, GPT Image 2.5(Flare / Sunburst), Nano Banana 2.1, Nano Banana 2, Nano Banana Pro를 지원하며, 텍스트→이미지는 /v1/images/generations, 이미지→이미지는 /v1/images/edits로 최대 4K까지 생성합니다. 영상은 Seedance, Wan 3.0, MiniMax H3, Grok Imagine Video를 /v1/videos/generations로 호출합니다. 결과는 바로 쓸 수 있는 직접 링크로 반환됩니다.
가격과 모델 정보는 얼마나 자주 업데이트되나요?
요금 페이지와 모델 마켓은 과금 시스템과 실시간으로 연동되어, 화면에 보이는 가격이 곧 실제 과금 가격입니다. 새 모델과 가격 변경은 적용되는 즉시 페이지에 반영되며, 가격 변경은 하루 전에 사이트에서 공지합니다.
요금과 과금
NezhaGate의 가격은 어떻게 정해지나요? 숨은 비용이 있나요?
NezhaGate는 실제 사용량으로 과금합니다. 채팅은 토큰 단위, 이미지는 장 단위, 영상은 대부분 초 단위입니다(일부 모델은 건당 과금하며 요금 페이지에 표시됩니다). 공식가 대비 최대 85%를 절약할 수 있고, 모든 모델의 가격은 요금 페이지에 공식가와 나란히 공개됩니다. 숨은 배율도, 충전 후에야 보이는 가격도 없습니다. 가격 변경은 하루 전에 사이트에서 공지합니다.
NezhaGate는 왜 공식보다 저렴한가요?
NezhaGate는 여러 공급사로부터 모델 사용량을 소매가보다 낮은 가격에 대량으로 구매하기 때문에, 대부분의 모델이 공식 API보다 저렴합니다. 모델별로 얼마나 절약되는지는 요금 페이지에서 하나하나 확인할 수 있습니다. 수익은 구매가와 판매가의 차액에서 나오며, 충전 수수료는 받지 않습니다.
실패한 호출은 어떻게 과금되나요?
NezhaGate는 실패한 호출에 요금을 부과하지 않습니다. 이미지·영상 같은 비동기 작업은 제출할 때 크레딧을 미리 예약하고, 작업이 실패하면 자동으로 전액 환불하며 실패 사유를 로그에 남깁니다. 스트리밍 답변이 중간에 끊기면 업스트림이 실제로 반환한 사용량만큼만 과금됩니다.
NezhaGate 크레딧은 만료되나요? 환불할 수 있나요?
NezhaGate 크레딧은 만료되지 않습니다. 충전은 WeChat Pay는 ¥10(260 크레딧)부터, USDT와 카드는 $5부터 가능하며, 새 계정에는 가입 즉시 30 크레딧을, 첫 충전 시 50 크레딧을 추가로 무료로 드립니다. 충전 내역과 최근 60일간 모든 호출의 과금 내역은 콘솔에서 확인할 수 있습니다. 충전 후 7일 이내라면 사용하지 않은 구매 크레딧을 고객지원을 통해 환불받을 수 있으며, 환불 1건당 수수료(2026년 10월 29일 이후 충전은 $1.40, 그 이전 충전은 $0.40)가 차감됩니다. 보너스 크레딧은 환불되지 않으며, USDT 결제도 환불할 수 있습니다.
잔액과 사용량은 어떻게 확인하나요?
로그인하면 콘솔에서 실시간 잔액, API 키별 사용량, 최근 60일간의 모든 호출(모델, 시간, 토큰 수 또는 이미지 수, 응답 시간, 과금액)을 확인할 수 있고, 실패한 호출에는 사유가 표시됩니다. 잔액 조회 엔드포인트로 프로그램에서 잔액을 읽을 수도 있습니다.
안정성과 한도
NezhaGate는 안정적인가요?
NezhaGate는 GPT, Gemini, DeepSeek, GLM, Kimi, GPT Image, Nano Banana, Seedance 2.0 등 주력 모델을 여러 공급사에 연결해 두었습니다. 한 곳에서 오류가 나거나 시간이 초과되거나 용량이 가득 차면, 요청은 같은 모델의 다음 공급사로 자동 전환됩니다. 스트리밍 답변은 출력이 시작되기 전에 전환되며, 출력이 시작된 뒤에는 옮겨지지 않습니다. 게이트웨이는 24시간 2분마다 자동으로 점검하며, 모델별 운영 상태와 게이트웨이 가용성은 상태 페이지에 실시간으로 공개되고, 성공률은 실제 고객 트래픽만으로 계산합니다. 실패한 호출에는 과금하지 않으며, 실패한 이미지·영상 작업은 전액 환불됩니다.
NezhaGate에 호출 빈도 제한이 있나요?
NezhaGate는 계정별 기본 빈도 제한을 두지 않습니다. API 키 페이지에서 키마다 분당 요청 수 상한, 일일 예산, 총 사용 한도, 모델 허용 목록, IP 허용 목록을 직접 설정할 수 있습니다. 어떤 모델의 모든 회선이 동시에 가득 차면 Retry-After 헤더와 함께 429가 반환되니, 그 시간이 지난 뒤 다시 시도하세요. 지속적으로 높은 동시 처리량이 필요하면 미리 고객지원에 연락해 주세요. 사용량에 맞춰 용량을 늘려 드립니다. 무료 프로모션 모델에는 일일 호출 횟수 제한이 있습니다.
상용 프로젝트나 AI 툴 사이트에 적합한가요?
네. NezhaGate는 OpenAI 호환 API, 프로젝트별로 나눌 수 있는 API 키(키마다 사용 한도·빈도·모델·IP 제한 설정 가능), 건별로 확인 가능한 호출 로그, 실패 시 과금하지 않는 정산 방식을 갖추고 있어 상용 제품과 툴 사이트에 바로 연동할 수 있습니다. 이용 시 서비스 약관과 각 모델 벤더의 이용 정책을 지켜 주세요.
기업 협업이나 대량 호출도 가능한가요?
가능합니다. NezhaGate는 더 큰 규모의 배치 호출을 처리할 수 있으며 기업 문의를 환영합니다. 더 높은 동시성, 전용 할당량, 연동 관련 요구가 있으시면 support@nezhagate.com 으로 메일을 보내시거나 사이트의 문의하기로 연락해 주세요. 사용량과 상황에 맞춰 안을 제안해 드립니다.
NezhaGate는 어떤 상황에 가장 잘 맞나요?
한 프로젝트에서 여러 모델 공급사를 호출해야 하거나, 과금과 사용량을 한곳에서 관리하고 싶거나, 여러 모델을 빠르게 검증하고 싶을 때 잘 맞습니다. AI 도구 사이트, SaaS 제품, 자동화 워크플로, 에이전트, 다중 모델 비교에 많이 쓰입니다. 모델 사이를 유연하게 오가야 할 때 특히 편합니다.
연동과 개발
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는 제 데이터를 저장하거나 들여다보나요?
NezhaGate는 호출 내용을 해당 호출을 처리하고, 로그에서 보여 드리고, 장애를 조사하는 데에만 사용합니다. 어떤 모델의 학습에도 쓰지 않으며, 판매하거나 광고주에게 제공하지도 않습니다. 호출 처리에 꼭 필요한 모델 공급사와 인프라 서비스(CDN, 클라우드 스토리지, 웹 검색을 켰을 때의 검색 서비스)를 제외하고는 제3자에게 제공하지 않습니다. 호출 로그는 콘솔에 60일간 보관되며, 그중 텍스트 내용은 30일 후 삭제되고 과금에 필요한 사용 기록만 남습니다. 생성한 이미지와 영상은 15일 후, 업로드한 참조 파일은 7일 후 삭제됩니다. 데이터베이스 백업은 최대 30일간 추가로 보관됩니다.
계정과 API 키는 안전한가요?
API 키마다 사용 한도, 분당 요청 수 상한, 모델 허용 목록, IP 허용 목록을 따로 설정할 수 있고 언제든 비활성화하거나 삭제할 수 있어, 키 하나가 유출돼도 다른 프로젝트에는 영향이 없습니다. 키는 서버에 암호화해 저장되며, 로그인한 상태에서는 언제든 확인하고 복사할 수 있습니다. 모든 호출과 잔액 변동은 건별로 확인할 수 있습니다.
문제가 생기면 어디에 문의하나요?
NezhaGate 고객지원은 사이트 상단 내비게이션과 콘솔의 「문의」에 있습니다. WeChat, Telegram 그룹, 이메일(support@nezhagate.com)로 문의할 수 있습니다. 지원 시간은 베이징 시간 10:00–19:00(UTC+8)이며, 메시지를 확인한 뒤 1시간 이내에 답변합니다.
금지되는 사용에는 어떤 것이 있나요?
법령이나 각 모델 벤더의 이용 정책을 위반하는 용도로는 NezhaGate를 쓸 수 없습니다. 불법 · 침해 · 사기 · 악성코드 콘텐츠를 만들거나 퍼뜨리는 행위, 자동화된 남용, 할당량이나 안전 장치를 우회하는 행위가 여기에 포함됩니다. 위반하면 계정이 제한되거나 해지될 수 있습니다. 전체 규정은 서비스 약관에 있습니다.
NezhaGate를 사용할 때 주의할 점은 무엇인가요?
API 키를 안전하게 보관하고 필요한 만큼 충전하며, 서비스 약관과 각 모델 벤더의 이용 정책을 지켜 주세요. 호출 전에 요금 페이지에서 단가를 확인하고, 키에 일일 예산과 총 사용 한도를 설정해 두면 예상치 못한 지출을 막을 수 있습니다.
