NezhaGate

OpenAI 호환 AI 게이트웨이 — 하나의 엔드포인트로 전체 카탈로그를 씁니다: GPT-5.5, Gemini 채팅 제품군, gpt-image 이미지 생성. 사람이 읽기 좋고, AI 코딩 어시스턴트에는 한 번의 클릭으로 통째로 복사할 수 있습니다.

빠른 시작

Base URL과 API 키만 바꿔 끼우면 기존 OpenAI SDK가 그대로 동작합니다.

Base URL
https://nezhagate.com/v1
curl · 채팅 API: Chat Completions
curl https://nezhagate.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "gpt-5.5", "messages": [{"role": "user", "content": "AI API 제품 소개를 짧게 써 줘"}], "stream": false}'

모델별 전체 요청 파라미터, 예제, 비동기 사용법은 각 모델의 전용 문서에 있습니다 — 아래 「모델 및 요금」 표에서 열어 보세요.

바로 실행할 수 있는 예제 더 보기 (Python / Node / curl, 비동기 이미지·영상 흐름 포함): github.com/gaoorange/nezhagate-api-examples

인증

모든 API 호출에는 Bearer 토큰이 필요합니다.

Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

모델 및 요금

모델별 전체 요청 파라미터, 예제, 비동기 사용법은 각 모델의 전용 문서에 있습니다 — 아래 「모델 및 요금」 표에서 열어 보세요.

모델기능엔드포인트요금
gpt-5.6-sol프런티어 추론, 에이전트 코딩, 장기 과제, 구조화 출력/chat/completions 입력 $2.0/1M · 출력 $12.0/1M API 문서 →
gpt-5.6-terra일상 채팅, 에이전트 코딩, 추론, 구조화 출력/chat/completions 입력 $1.2/1M · 출력 $7.0/1M API 문서 →
gpt-5.6-luna고속 채팅, 에이전트 코딩, 대량 · 저지연 처리, 구조화 출력/chat/completions 입력 $0.8/1M · 출력 $4.8/1M API 문서 →
gpt-5.5채팅, 추론, 에이전트, 구조화 출력/chat/completions 입력 $0.7/1M · 출력 $4.2/1M API 문서 →
gpt-6-astra심층 추론, 에이전트 코딩, 초장문 컨텍스트, 이미지 입력, 구조화 출력/chat/completions 입력 $2.8/1M · 출력 $14.0/1M API 문서 →
gpt-image-2텍스트-투-이미지, 이미지-투-이미지, 표지, 포스터, 일러스트/images/generations 1K $0.015 · 2K $0.025 · 4K $0.04 API 문서 →
gpt-image-2.5-flare텍스트-투-이미지, 이미지-투-이미지, 표지, 포스터, 일러스트, 타이포그래피/images/generations 1K $0.015 · 2K $0.025 · 4K $0.04 API 문서 →
gpt-image-2.5-sunburst텍스트-투-이미지, 이미지-투-이미지, 표지, 포스터, 일러스트, 타이포그래피/images/generations 1K $0.015 · 2K $0.025 · 4K $0.04 API 문서 →
nano-banana-2텍스트-투-이미지, 이미지-투-이미지, 표지, 포스터, 일러스트/images/generations 1K $0.025 · 2K $0.0375 · 4K $0.0625 API 문서 →
nano-banana-pro텍스트-투-이미지, 이미지-투-이미지, 표지, 포스터, 일러스트, 인포그래픽/images/generations 1K $0.04 · 2K $0.06 · 4K $0.1 API 문서 →
claude-sonnet-4-6채팅, 코드, 추론, 긴 컨텍스트/chat/completions 입력 $1.5/1M · 출력 $7.5/1M API 문서 →
claude-opus-5심층 추론, 코드, 에이전트, 긴 컨텍스트, 이미지 이해/chat/completions 입력 $4.0/1M · 출력 $20.0/1M API 문서 →
claude-fable-5중국어 글쓰기, 서사 창작, 장문 생성, 채팅, 코드, 이미지 이해/chat/completions 입력 $8.0/1M · 출력 $40.0/1M API 문서 →
gemini-3.1-pro채팅, 추론, 초장문 컨텍스트, 멀티모달/chat/completions 입력 $0.5/1M · 출력 $3.0/1M API 문서 →
gemini-3.8-flash채팅, 추론, 적응형 사고, 이미지 입력, 초장문 컨텍스트/chat/completions 입력 $0.6/1M · 출력 $3.6/1M API 문서 →
gemini-3.7-flash채팅, 추론, 적응형 사고, 이미지 입력, 초장문 컨텍스트/chat/completions 입력 $0.6/1M · 출력 $3.6/1M API 문서 →
gemini-3.6-flash채팅, 추론, 사고, 이미지 입력, 초장문 컨텍스트/chat/completions 입력 $0.6/1M · 출력 $3.6/1M API 문서 →
gemini-3.6-flash-high심층 추론, 복잡한 과제, 사고, 이미지 입력, 초장문 컨텍스트/chat/completions 입력 $0.6/1M · 출력 $3.6/1M API 문서 →
gemini-3.6-flash-low고속 채팅, 대량 처리, 낮은 지연, 이미지 입력/chat/completions 입력 $0.6/1M · 출력 $3.6/1M API 문서 →
gemini-3.6-flash-tiered적응형 사고, 채팅, 추론, 이미지 입력/chat/completions 입력 $0.6/1M · 출력 $3.6/1M API 문서 →
gemini-3-flash-preview채팅, 추론, 높은 동시성, 낮은 지연/chat/completions 입력 $0.3/1M · 출력 $1.2/1M API 문서 →
gemini-3.5-flash채팅, 추론, 높은 동시성, 낮은 지연, 사고/chat/completions 입력 $0.45/1M · 출력 $2.7/1M API 문서 →
gemini-2.5-flash채팅, 높은 동시성, 낮은 지연, 멀티모달/chat/completions 입력 $0.3/1M · 출력 $1.2/1M API 문서 →
veo-3.1텍스트-투-비디오, 이미지-투-비디오, 숏 클립, 상업용 영상/videos/generations $0.075 /건부터 API 문서 →
seedance-2.5롱테이크 단편, 다중 참조 입력, 상업용 영상/videos/generations $0.158 /초 API 문서 →
seedance-2.0숏 클립, 상업용 소재/videos/generations $0.15 /초 API 문서 →
seedance-2.0-fast대량 소재 제작, 빠른 콘셉트 확인/videos/generations $0.1 /초 API 문서 →
seedance-2.0-mini대량 초안, 저비용 반복 작업/videos/generations $0.066 /초 API 문서 →
wan3.0-video롱테이크 스토리텔링, 다중 소재 합성, 영상 리라이팅/videos/generations $0.12 /초 API 문서 →
wan3.0-video-prime마감이 급한 영상, 대량 테스트 촬영/videos/generations $0.16 /초 API 문서 →
minimax-h3HD 영상, 소리가 있는 숏 클립/videos/generations $0.036 /초 API 문서 →
grok-imagine-video-1.5대량 숏폼, 빠른 콘셉트 확인/videos/generations $0.3 /건부터 API 문서 →

앱에서 사용하기 (코드 없이)

OpenAI API를 지원하는 앱이라면 아래 세 가지만 입력하면 됩니다 — 코딩이 필요 없습니다:

API base URLhttps://nezhagate.com/v1
API 키콘솔에서 만든 키 (콘솔 → API 키 → 복사)
모델 이름gpt-5.6-sol gpt-5.6-terra gpt-5.6-luna gpt-5.5 gpt-6-astra gpt-image-2 gpt-image-2.5-flare gpt-image-2.5-sunburst nano-banana-2 nano-banana-pro claude-sonnet-4-6 claude-opus-5 claude-fable-5 gemini-3.1-pro gemini-3.8-flash gemini-3.7-flash gemini-3.6-flash gemini-3.6-flash-high gemini-3.6-flash-low gemini-3.6-flash-tiered gemini-3-flash-preview gemini-3.5-flash gemini-2.5-flash veo-3.1 seedance-2.5 seedance-2.0 seedance-2.0-fast seedance-2.0-mini wan3.0-video wan3.0-video-prime minimax-h3 grok-imagine-video-1.5

ChatBox, Cherry Studio, NextChat, LobeChat, Immersive Translate, Open WebUI 등에서 동작을 확인했습니다.

네이티브 Anthropic API (Claude Code)

OpenAI 호환 경로 외에, Claude 모델은 네이티브 Anthropic Messages API로도 제공됩니다. Claude Code(또는 모든 Anthropic SDK)의 base URL을 아래 주소로 지정하고 게이트웨이 키를 x-api-key로 쓰면 됩니다 — thinking, 도구 사용, 프롬프트 캐싱이 모두 네이티브로 유지됩니다.

Claude Code · env
export ANTHROPIC_BASE_URL=https://nezhagate.com/anthropic
export ANTHROPIC_API_KEY=YOUR_API_KEY
# claude-sonnet-4-6 / claude-opus-5 / claude-fable-5
curl · /anthropic/v1/messages
curl https://nezhagate.com/anthropic/v1/messages -H "x-api-key: YOUR_API_KEY" -H "anthropic-version: 2023-06-01" -H "Content-Type: application/json" -d '{"model": "claude-sonnet-4-6", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'

모델: claude-opus-5, claude-fable-5, claude-sonnet-4-6. 과금은 /v1과 완전히 동일한 토큰 단위입니다.

프롬프트 캐시 과금: 캐시 적중(캐시 읽기)은 입력 단가의 1/10(0.1×), 캐시 쓰기는 1.25×로 과금합니다(모델별 단가는 요금 페이지). 캐시에 적중하려면 충분히 길고 안정적인 접두부(Claude Opus 4096 토큰 이상, Sonnet 2048 이상)를 짧은 시간 안에 반복해서 보내야 합니다 — 큰 CLAUDE.md / 시스템 프롬프트를 들고 실제 코드베이스를 도는 Claude Code는 매 턴 적중해 입력 비용이 약 1/10로 떨어집니다. 플레이그라운드의 짧은 대화는 접두부가 너무 짧아 캐시에 걸리지 않습니다.

영상 생성 (비동기)

텍스트-투-비디오 / 이미지-투-비디오는 비동기 작업입니다. 호출하면 즉시 HTTP 202와 작업 ID가 돌아옵니다({"id":"img_...","object":"video.generation.job","status":"queued"}). GET /v1/videos/jobs/{id}를 status=succeeded가 될 때까지 폴링하면 결과가 data[0].url에 담깁니다(재호스팅된 mp4). 한 편에 1~12분 걸립니다. 과금 방식은 두 가지입니다: Veo 3.1은 건당, Seedance 2.x와 MiniMax H3는 초당(초당 단가 × 길이)입니다. 둘 다 예치 금액과 정산 금액이 정확히 일치하며 실패 시 전액 환불합니다. 화면 비율은 size로 지정하고(기본값은 16:9 가로), 이미지-투-비디오는 image에 첫 프레임 참조를 넣으세요.

curl · 제출
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "veo-3.1", "prompt": "노을 속에서 서핑하는 고양이", "tier": "quality", "resolution": "1080p", "size": "16:9", "duration": "8s"}'
curl · 폴링
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

영상 모델: veo-3.1 seedance-2.5 seedance-2.0 seedance-2.0-fast seedance-2.0-mini wan3.0-video wan3.0-video-prime minimax-h3 grok-imagine-video-1.5

AI에 붙여 넣을 연동 노트

아래 블록 전체를 Codex / Claude Code / Cursor에 그대로 붙여 넣으면 연동 방법을 알아서 파악합니다. 오른쪽 위의 「페이지 복사」로 문서 전체를 복사할 수도 있습니다.

AI Integration Prompt
Integrate NezhaGate through its OpenAI-compatible API.
Base URL: https://nezhagate.com/v1
API Key: read it from the environment variable NEZHAAPI_KEY.
Claude models can also use the native Anthropic protocol (for Claude Code / the Anthropic SDK): ANTHROPIC_BASE_URL=https://nezhagate.com/anthropic, headers x-api-key=API Key and anthropic-version: 2023-06-01, POST /anthropic/v1/messages (max_tokens is required), models claude-sonnet-4-6 / claude-opus-5 / claude-fable-5.
Chat models (/chat/completions): gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna / gpt-5.5 / gpt-6-astra / claude-sonnet-4-6 / claude-opus-5 / claude-fable-5 / gemini-3.1-pro / gemini-3.8-flash / gemini-3.7-flash / gemini-3.6-flash / gemini-3.6-flash-high / gemini-3.6-flash-low / gemini-3.6-flash-tiered / gemini-3-flash-preview / gemini-3.5-flash / gemini-2.5-flash
Image models (text-to-image /images/generations; image-to-image /images/edits or add an image parameter): gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst / nano-banana-2 / nano-banana-pro
Video models (text-to-video /videos/generations, async jobs; add an image parameter for image-to-video, the image becomes the first frame): veo-3.1 / seedance-2.5 / seedance-2.0 / seedance-2.0-fast / seedance-2.0-mini / wan3.0-video / wan3.0-video-prime / minimax-h3 / grok-imagine-video-1.5
Auth: Authorization: Bearer YOUR_API_KEY
Requirements (chat): return choices[0].message.content; on 401 check the key, 402 means insufficient balance, 429/5xx can be retried.
Requirements (images, async): POST /images/generations or /images/edits returns HTTP 202 with a job id right away ({"id":"img_...","object":"image.generation.job","status":"queued"}); then poll GET /v1/images/jobs/{id} until status=succeeded and read data[0].url (a stable link on img.nezhagate.com). Do not read data right after submitting.
Requirements (video, async): POST /videos/generations returns HTTP 202 with a job id (object=video.generation.job); then poll GET /v1/videos/jobs/{id} until status=succeeded and read data[0].url (a stable re-hosted mp4 link). About 1-2 minutes per clip; failed jobs are refunded in full.

잔액 및 사용량 조회

아무 API 키로나 계정의 남은 잔액과 사용액을 조회할 수 있습니다 — 대시보드 로그인이 필요 없습니다. 가장 간단한 방법은 GET /v1/usage입니다. OpenAI 호환 경로도 있습니다: /v1/dashboard/billing/credit_grants (잔액 = total_available).

curl · /v1/usage
curl https://nezhagate.com/v1/usage -H "Authorization: Bearer YOUR_API_KEY"
curl · /v1/dashboard/billing/credit_grants
curl https://nezhagate.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_API_KEY"

오류 코드

상태 코드의미대처 방법
401API 키가 없거나 유효하지 않음Authorization 헤더를 확인하세요
402잔액 부족 또는 키 한도 초과관리자에게 충전을 문의하세요
400지원하지 않는 모델 또는 파라미터gpt-5.5 / gpt-image-2 만 사용하세요
429업스트림 요청 한도 초과잠시 후 다시 시도하세요
502모든 업스트림 경로가 실패복구를 기다리거나 관리자에게 문의하세요