NextHub는 Claude, GPT, Gemini 등 주요 모델에 대한 연결을 하나의 게이트웨이로 통합합니다. Token 단위로 정확히 과금하고 요청 단위로 추적할 수 있으며, Chat Completions, Messages, Responses 세 가지 프로토콜을 같은 엔드포인트에서 호출할 수 있습니다. 사용할 수 있는 모델과 그룹은 계정 권한과 콘솔 설정에 따라 달라집니다.
대표적인 네 가지 사용 방식마다 핵심 문제 하나와 다음 단계 하나를 제시합니다. 개별 도구 설정은 문서에서 순서대로 다룹니다.
Claude Code, Codex, OpenCode, Kilocode, Zed 같은 도구를 쓰는 사용자를 위한 항목입니다.
도구마다 주소, 프로토콜, 모델 이름, 설정 방식이 달라서 도구를 바꿀 때마다 다시 설정해야 합니다.
계정과 API Key, 연결 지점을 하나로 통일하고 개별 설정은 해당 도구의 튜토리얼을 따릅니다. 이 페이지에서는 튜토리얼 본문을 반복하지 않습니다.
이미 OpenAI 또는 Anthropic SDK를 사용하는 개발자를 위한 항목입니다.
여러 공급자의 주소, 인증, 청구가 각각 흩어져 있어 계정과 비용을 모으기 어렵습니다.
공개된 세 가지 프로토콜을 모두 지원하며, Base URL과 키, 모델 설정만 조정하면 연결되고 주요 SDK 사용 방식은 그대로 유지됩니다. 아래 빠른 시작에 세 프로토콜의 최소 예제가 있습니다.
GPT, Claude, Gemini 등 권한이 있는 모델을 골라 쓰려는 개발자를 위한 항목입니다.
모델 ID, 프로토콜, 채널, 비용 기준이 모두 달라 개별 연동의 유지 비용이 큽니다.
하나의 연결 지점, 그룹으로 정의되는 호출 범위, 요청 단위 사용량 기록을 제공합니다. 그룹이 라우팅 채널과 과금 배수를 정하고 부하 분산은 플랫폼 측이 담당합니다.
여러 사람, 여러 프로젝트, 여러 환경이 API를 함께 쓰는 팀을 위한 항목입니다.
마스터 키를 모두가 함께 쓰면 지출 한도가 없고 누가 어디에 썼는지 추적할 수 없습니다.
API Key마다 지출 한도, 만료 시간, IP 허용 / 차단 규칙, 5시간 / 일간 / 주간 속도 제한을 설정합니다.
계정 풀과 그룹 라우팅부터 API Key 관리까지. 아래 여섯 항목은 모두 공개 약관과 문서에 명시된 기능에 대응하며 근거 없는 수치는 쓰지 않았습니다.
Claude, GPT, Gemini 등 모델 패밀리에 대한 연결을 하나의 엔드포인트로 통합합니다. Chat Completions, Messages, Responses 세 프로토콜을 모두 쓸 수 있고 base URL과 키만 바꾸면 연결됩니다.
→상류 연결은 공식 계정 풀로 제공됩니다. 요청은 계정 풀과 그룹에 따라 경로를 선택하고 부하 분산과 스케줄링은 플랫폼 측이 담당합니다.
→Token으로 계량하고 그룹 배수로 정산합니다. 요청마다 Token 사용량과 과금이 기록되어 콘솔에서 한 건씩 확인할 수 있습니다.
→API Key를 만들 때 고른 그룹이 호출할 수 있는 모델 범위와 라우팅 채널을 정합니다. 실제 상류 선택은 플랫폼 라우팅 규칙을 따릅니다.
→API Key마다 지출 한도, 만료 시간, IP 허용 / 차단 규칙, 5시간 / 일간 / 주간 속도 제한을 설정합니다.
→공식 계정 풀로 상류 공식 API에 직접 연결합니다. 플랫폼 측에서 헬스 체크, 오류 분류, 리스크 격리를 수행하고 과금·감사·리스크 기록을 보관합니다.
→앞 절은 무엇을 갖추었는지, 이 절은 그 기능들이 호출 한 번에서 어떻게 함께 동작하는지를 설명합니다.
사용하는 SDK, CLI, IDE 확장이 NextHub 엔드포인트로 요청을 보냅니다.
요청은 Chat Completions, Messages, Responses 중 해당 프로토콜의 엔드포인트로 연결되고 프로토콜 형식은 게이트웨이 측에서 변환합니다.
API Key를 검증하고 해당 키의 지출 한도, 만료 시간, IP 규칙, 속도 제한 주기를 적용합니다.
API Key에 설정한 그룹과 플랫폼 라우팅 규칙에 따라 이 요청이 쓸 상류 경로와 모델이 정해집니다.
결과를 클라이언트로 돌려보내면서 이 요청의 Token 사용량과 과금 내역을 기록합니다.
4단계의 실제 경로는 플랫폼 정책이 결정합니다. 공개된 서비스 특정 약관에 따르면 요청은 모델, 계정 풀, 리전, 잔액, 동시성, 속도 제한, 헬스 상태, 고정 세션, 장애 조치 또는 플랫폼 정책에 따라 다른 상류 리소스로 라우팅될 수 있습니다 —— 즉 어느 단계에서 경로가 바뀌는지는 그 시점의 조건에 달려 있으며 반드시 일어나는 단계가 아닙니다. 자세한 내용은 서비스 특정 약관을 참고하세요.
API Key를 만들 때 고른 그룹이 세 가지를 정합니다. 그 키로 호출할 수 있는 모델, 요청이 지나는 상류 경로, 적용되는 과금 배수입니다.
이미지 생성과 같은 전용 그룹은 콘솔에 로그인하여 해당 권한을 활성화한 후에만 표시되므로 위 표에 포함되지 않으며, 실제 사용 가능한 모델, 권한 및 결제 가격은 콘솔과 모델 플라자를 기준으로 합니다.
Chat Completions, Messages, Responses 세 프로토콜을 모두 지원합니다. 엔드포인트를 바꾸고 키를 넣으면 나머지는 NextHub가 처리합니다.
NextHub 계정을 등록하고 개인 콘솔로 들어갑니다.
콘솔에서 모델 그룹을 고르고 필요에 따라 한도, 만료 시간, 속도 제한을 설정한 뒤 플랫폼 키를 복사합니다.
세 프로토콜 중 하나를 골라 base URL과 키만 바꾸면 됩니다. 주요 클라이언트와 공식 SDK 사용 방식은 그대로입니다.
# OpenAI 호환 · base URL과 키만 바꾸면 호출할 수 있습니다 curl https://api.nexthub.cc/v1/chat/completions \ -H "Authorization: Bearer sk-nx-your-key" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6-astra", "messages": [{"role": "user", "content": "안녕하세요, NextHub!"}] }'
# Anthropic 호환 · base URL과 키만 바꾸면 됩니다 curl https://api.nexthub.cc/v1/messages \ -H "x-api-key: sk-nx-your-key" \ -H "anthropic-version: 2023-06-01" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-fable-5-1", "max_tokens": 1024, "messages": [{"role": "user", "content": "안녕하세요, NextHub!"}] }'
# OpenAI Responses 프로토콜 curl https://api.nexthub.cc/v1/responses \ -H "Authorization: Bearer sk-nx-your-key" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6-astra", "input": "안녕하세요, NextHub!" }'
아래 각 항목은 문서에서 해당 도구 전용 튜토리얼 페이지로 연결됩니다. 설정 절차는 튜토리얼을 따르세요.
위 도구는 모두 각 벤더의 제품이며 NextHub와 공식 제휴 관계가 없습니다 —— 여기서는 그 도구를 NextHub에 연결하는 설정 절차를 튜토리얼로 정리했을 뿐입니다. CC-Switch는 서드파티 설정 보조 도구이며 NextHub 자체 제품이 아닙니다.
실제 사용량에 따라 과금합니다. 아래 세 줄은 개인과 팀의 결제 방식, 충전 기준, 기업 맞춤입니다.
실제 Token 사용량 × 선택한 그룹의 배수로 정산하며 요청마다 사용량과 과금이 기록됩니다. 콘솔에서 한 건씩 확인할 수 있습니다.
1회 최소 충전 5 USD, 수수료 없음, Stripe(Visa / MasterCard / Alipay / AMEX) 및 암호화폐(USDT / USDC) 지원, 실시간 환율로 충전합니다. 콘솔의 실제 결제 페이지가 우선합니다.
전용 채널, 맞춤 할당량, 사람이 직접 응대하는 기술 지원을 제공합니다. 구체적인 범위와 정산은 주문 또는 양측 서면 합의를 따릅니다.
이 페이지는 과금 기준만 설명하며 전체 가격표는 싣지 않습니다. 그룹별 최신 가격과 전체 모델 목록은 모델 플라자에서 확인하세요.
공개적으로 Claude, GPT, Gemini, Grok 모델 계열과 DeepSeek, GLM, Step 등의 중국 오픈소스 모델의 현재 주요 버전을 제공하며, 사용 가능한 모델은 상류 업데이트에 따라 갱신됩니다. 이미지 생성 및 기타 전용 그룹 서비스는 콘솔에 로그인하여 해당 권한을 활성화한 후에만 표시됩니다. 즉, 어떤 모델을 호출할 수 있는지는 계정 권한과 선택한 그룹에 의해 결정되며, 전체 목록은 모델 플라자와 콘솔을 기준으로 합니다.
세 가지 주요 프로토콜을 모두 지원합니다. OpenAI Chat Completions(/v1/chat/completions), Anthropic Messages(/v1/messages), OpenAI Responses(/v1/responses)이며 엔드포인트는 https://api.nexthub.cc로 통일되어 있습니다. 개별 모델을 어떤 프로토콜로 호출할 수 있는지는 해당 그룹이 제공하는 모델과 문서 설명을 기준으로 합니다.
호환됩니다. base URL을 NextHub 주소로 바꾸고 플랫폼 키를 넣으면 주요 SDK와 클라이언트의 호출 방식을 그대로 유지할 수 있습니다. base URL과 키만 바꾸면 되고 애플리케이션 코드를 다시 작성할 필요가 없습니다. base URL 표기법은 아래 Base URL에 버전 경로가 필요한가요? 항목을 참고하세요.
모델별 단가 × 실제 소비한 Token으로 과금하며 실결제 = 공식 가격 × 선택한 그룹의 배수입니다. 요청마다 Token 사용량과 과금이 기록되고 콘솔에서 한 건씩 확인할 수 있습니다. 그룹 배수는 모델 플라자의 그룹 설명을 참고하세요.
인증, 전달, 과금, 리스크 관리, 문제 해결, 규정 준수를 위해 플랫폼은 필요한 요청 메타데이터를 처리합니다. 여기에는 계정 정보, API Key 식별자, IP와 기기 정보, 라우팅 정보, 모델 이름, Token 사용량, 오류 정보, 주문 정보, 로그가 포함됩니다. 요청이 상류로 전달된 뒤에는 관련 입력, 출력, 로그가 상류 사업자의 약관에 따라 해당 사업자에 의해 처리될 수 있습니다. 불필요한 민감 개인정보, 키, 규제 대상 데이터는 제출하지 마세요. 자세한 내용은 개인정보 처리방침과 서비스 특정 약관의 데이터·로그 처리 범위 섹션을 참고하세요.
사용하려는 모델에 따라 달라집니다. Claude는 claude code 그룹(클라이언트 제한 없음)을, 더 안정적인 풀을 원하면 Claude Max 그룹을, Amazon Bedrock 라인이 필요하면 Claude-AWSB 그룹을, GPT / Codex 시리즈는 GPT-Azure 그룹을 선택합니다. 더 낮은 가격이 필요하면 GPT-Pro 그룹을 선택할 수 있습니다. 프로모션 가격을 원하시면 GPT-offers 그룹을 선택할 수 있습니다 (coding 주력으로는 권장하지 않음). Gemini는 예산에 따라 Gemini-aistudio(경제 라인)와 Gemini-Vertex(공식 안정 라인) 중에서 선택합니다. Grok 시리즈는 Grok 그룹을, DeepSeek, GLM, Step 등의 오픈소스 모델은 开源模型组 그룹을 선택합니다. 이 페이지 위의 ‘모델과 그룹 선택 방법’ 섹션에서 각 그룹의 용도, 현재 배수, 각각의 제한 사항을 확인할 수 있으며, 그룹 이름과 배수는 이 페이지의 스냅샷에서 가져옵니다. 그룹 및 배수 가이드에서 직접 확인할 수도 있습니다.
프로토콜과 도구에 따라 다르며 모든 경우에 맞는 주소는 없습니다. OpenAI 형식 인터페이스(Chat Completions, Responses)의 base URL은 https://api.nexthub.cc/v1로 /v1을 붙입니다. Anthropic 형식(Messages 프로토콜, Claude Code와 Anthropic SDK)의 base URL은 /v1 없이 https://api.nexthub.cc를 넣습니다 — SDK가 경로를 자동으로 완성하며, 직접 요청할 때의 전체 엔드포인트는 https://api.nexthub.cc/v1/messages입니다. Zed, Kilocode 같은 OpenAI 호환 클라이언트에는 https://api.nexthub.cc/v1을 넣습니다. 해당 도구의 튜토리얼을 따르세요.
429는 원인이 하나가 아니므로 차례로 확인하세요. 먼저 계정 한도와 잔액이 충분한지 보세요. 부족하면 즉시 거부됩니다. 한도와 잔액이 충분한데도 자주 발생한다면 API Key 또는 소속 그룹의 속도 제한(5시간 / 일간 / 주간 주기)에 걸렸을 가능성이 크므로 잠시 후 다시 시도하거나 해당 키의 속도 설정을 조정하세요. 아울러 호출하는 모델이 그 키에서 선택한 그룹에 속하는지도 확인하세요.
모델 플라자는 플랫폼 백엔드에서 직접 관리되며, 그룹과 가격은 백엔드 설정과 상류 공식 가격 조정을 따라 자동으로 동기화되어 페이지를 열 때 항상 최신 데이터가 표시됩니다. 실제 과금은 여전히 요청 정산 시점의 콘솔 기록을 기준으로 합니다. 청구 내역에 의문이 있으면 요청 ID를 붙여 관리자에게 문의하세요.