OpenAI 호환 AI 게이트웨이 — 하나의 엔드포인트로 전체 카탈로그를 씁니다: GPT-5.5, Gemini 채팅 제품군, gpt-image 이미지 생성. 사람이 읽기 좋고, AI 코딩 어시스턴트에는 한 번의 클릭으로 통째로 복사할 수 있습니다.
빠른 시작
Base URL과 API 키만 바꿔 끼우면 기존 OpenAI SDK가 그대로 동작합니다.
https://nezhagate.com/v1
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 토큰이 필요합니다.
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-h3 | HD 영상, 소리가 있는 숏 클립 | /videos/generations | $0.036 /초 | API 문서 → |
| grok-imagine-video-1.5 | 대량 숏폼, 빠른 콘셉트 확인 | /videos/generations | $0.3 /건부터 | API 문서 → |
앱에서 사용하기 (코드 없이)
OpenAI API를 지원하는 앱이라면 아래 세 가지만 입력하면 됩니다 — 코딩이 필요 없습니다:
| API base URL | https://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, 도구 사용, 프롬프트 캐싱이 모두 네이티브로 유지됩니다.
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 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 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 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에 그대로 붙여 넣으면 연동 방법을 알아서 파악합니다. 오른쪽 위의 「페이지 복사」로 문서 전체를 복사할 수도 있습니다.
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 https://nezhagate.com/v1/usage -H "Authorization: Bearer YOUR_API_KEY"
curl https://nezhagate.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_API_KEY"
오류 코드
| 상태 코드 | 의미 | 대처 방법 |
|---|---|---|
| 401 | API 키가 없거나 유효하지 않음 | Authorization 헤더를 확인하세요 |
| 402 | 잔액 부족 또는 키 한도 초과 | 관리자에게 충전을 문의하세요 |
| 400 | 지원하지 않는 모델 또는 파라미터 | gpt-5.5 / gpt-image-2 만 사용하세요 |
| 429 | 업스트림 요청 한도 초과 | 잠시 후 다시 시도하세요 |
| 502 | 모든 업스트림 경로가 실패 | 복구를 기다리거나 관리자에게 문의하세요 |