시작하기

빠른 시작

자체 AXHUBNET 키로 래퍼 API를 호출하고, 업스트림 AI 게이트웨이를 서버 뒤에서 연결하는 구성을 60초 안에 시작하세요.

from axhubnet import AxHub

client = AxHub(
    api_key="ax_live_prod_demo_001",
    base_url="https://your-domain.com/api/gateway",
)
resp = client.chat.completions.create(
    model="gpt-5",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

cURL

curl -X POST "https://your-domain.com/api/gateway/chat/completions" \
  -H "Authorization: Bearer ax_live_prod_demo_001" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [{"role": "user", "content": "Summarize yesterday\u2019s support tickets."}]
  }'

서버 .env 구성

업스트림 게이트웨이 키는 서버 환경 변수에만 두고, Supabase에는 사용자 정보, 논리 API 키, 사용량 이벤트를 저장합니다.

AXHUB_UPSTREAM_API_KEY=upstream_provider_key
AXHUB_UPSTREAM_BASE_URL=https://your-upstream-gateway.example/v1
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
AXHUB_ADMIN_TOKEN=ax_admin_change_me

Supabase 스키마

-- Apply from supabase/schema.sql
gateway_users
gateway_api_keys
gateway_usage_events

인증

클라이언트는 AXHUBNET이 발급한 내부 키만 사용합니다. 업스트림 게이트웨이 키는 프록시 서버에서만 사용됩니다.

Authorization: Bearer ax_live_••••••••••••a92f

키 관리 API

관리자는 별도의 관리자 토큰으로 Supabase 사용자 레코드에 연결된 내부 키를 생성, 조회, 폐기하고 사용량 스냅샷을 확인할 수 있습니다.

POST /api/admin/gateway/keys
x-admin-token: $AXHUB_ADMIN_TOKEN

{
  "name": "Production Web",
  "project": "web-app",
  "monthlyTokenLimit": 5000000,
  "user": {
    "email": "owner@acme.ai",
    "name": "Acme Platform",
    "organization": "Acme AI",
    "externalUserId": "acct_123"
  }
}

GET    /api/admin/gateway/keys
DELETE /api/admin/gateway/keys
GET    /api/admin/gateway/usage

Chat completions

래퍼의 OpenAI 호환 엔드포인트는 /api/gateway/chat/completions 입니다. model 필드를 바꾸면 업스트림 게이트웨이의 공급자 라우팅을 전환할 수 있습니다.

Embeddings

다음 경로에 POST 하세요: /v1/embeddings 엔드포인트에 입력 텍스트를 POST 하세요.

별도 관측 필드

래퍼 계층은 사용자 식별 정보, 논리 키 메타데이터, 프롬프트 미리보기, 프롬프트/완료 토큰, 지연 시간, 상태 코드를 Supabase에 기록합니다.

{
  "keyName": "Production Web",
  "user": {
    "email": "owner@acme.ai",
    "name": "Acme Platform"
  },
  "project": "web-app",
  "model": "openai/gpt-5",
  "promptPreview": "Summarize [redacted-email] support backlog...",
  "promptTokens": 124,
  "completionTokens": 312,
  "totalTokens": 436,
  "latencyMs": 842,
  "status": 200
}

이미지 생성

DALL·E, Imagen, SDXL을 하나의 API로 생성하세요.

파인 튜닝

지원 공급자에서 커스텀 모델을 학습하고 기본 모델과 동일하게 라우팅합니다.

로컬 LLM 연동

VPC 내부의 Ollama, vLLM, LM Studio를 AXHUBNET을 통해 연합하세요.

SDK

Python과 JavaScript / TypeScript용 SDK 패키지를 제공합니다.

JavaScript / TypeScript
packages/sdk-js

Python
packages/sdk-python