Performance Hub 로고Performance Hub
사이트 섹션: 문서

시작하기

이 페이지의 내용

이 가이드는 세 단계를 거쳐 아무것도 설정되지 않은 시설에서 첫 요청이 작동하도록 안내한 다음, 제대로 작동했는지 확인하는 방법을 보여 줍니다.

시작하기 전에

  • Organisation Administrator여야 합니다. Model Router는 Technology Stack 시설의 Organisation Administrator만 사용할 수 있습니다.
  • Performance Hub 메인 도구 모음의 시설 선택기를 사용하여 구성할 시설을 선택하십시오.
  • 시설에 청구 카드를 저장해 두거나 추가할 준비를 하십시오. 충전 시 저장된 청구 카드로 결제됩니다. 등록된 카드가 없으면 Balance & Top-up 페이지에 Add payment details 링크와 함께 *"No card on file."*이 표시됩니다.

1단계 — Model Router 활성화

메인 메뉴(AI Modules & Agents 그룹)에서 Model Router를 엽니다. 이 시설에서 아직 모듈이 활성화되지 않았다면 Welcome to Model Router 페이지가 표시됩니다.

"단일 OpenAI 호환 엔드포인트를 통해 비즈니스에 선불로 주요 AI 모델 카탈로그에 대한 액세스 권한을 부여하세요. Performance Hub AI Agents가 자동으로 연결되며, API 키를 생성하여 동일한 모델을 자체 소프트웨어에 연결할 수 있습니다. 지출 제한 및 완전한 사용량 가시성을 제공합니다."

Welcome to Model Router 페이지Welcome to Model Router 페이지

그림 1: 모듈이 활성화되기 전에 시설에 표시되는 Welcome to Model Router 페이지

페이지에는 Enable Model Router, Read the documentation(이 문서가 열림), Explore first without enabling의 세 버튼이 있습니다. 그 아래에 설정 과정이 세 단계로 안내되어 있습니다.

단계안내 내용버튼
1. Enable & add a billing card"Turn on prepaid AI inference for this facility and store a billing card if you have not already — nothing is charged until you top up."Enable module
2. Top up your balance"Add prepaid credit with your stored billing card (minimum $10). Turn on auto top-up so inference never stops because the balance ran out."Top up
3. Connect an agent or create an API key"Paired AI Agent devices connect automatically. For your own software, create an API key and point any OpenAI-compatible SDK at our endpoint."Create an API key

각 단계에는 Learn more 링크도 있습니다.

Enable Model Router(또는 Enable module)를 클릭하여 모듈을 켭니다.

설정 체크리스트

모듈을 활성화하면 설정이 완료될 때까지 Model Router 상단에 설정 체크리스트 배너가 표시됩니다. 배너의 제목은 Finish setting up Model Router이며, 예상 소요 시간(예: ~3 min left), 완료된 단계 수(예: 2 of 3 complete), 전체 체크리스트를 펼치는 Resume 버튼이 표시됩니다. 각 단계에는 Review(또는 Review again)와 Learn more가 있으며, Collapse를 누르면 다시 접힙니다. 한 단계만 남으면 펼친 화면의 부제목이 *"Just one step to go before AI requests start flowing. Steps can be done in any order."*로 표시됩니다.

설정 체크리스트 배너설정 체크리스트 배너

그림 2: 설정이 완료될 때까지 표시되는 설정 체크리스트 배너

필수 단계는 Add a billing card, Top up your balance, Connect an agent or create an API key입니다. 선택 단계인 Set spend limits, Turn on auto top-up, Verify your first request는 Skip for now로 건너뛸 수 있습니다.

2단계 — 첫 충전

Budgets & Limits → Balance & Top-up으로 이동합니다.

Top up balance 및 Auto top-up 카드Top up balance 및 Auto top-up 카드

그림 3: Top up balance 카드(사전 설정, 금액, 저장된 카드)와 Auto top-up 카드

  1. Top up balance 카드에서 사전 설정 금액($25, $50, $100, $250, $500, $1000)을 선택하거나 금액을 입력합니다. "Minimum top-up is $10."
  2. 금액 아래에 표시된 저장된 카드(예: "Amex ending 0005 · exp 06/29")를 확인합니다. 업데이트가 필요하면 Edit payment details를 사용합니다.
  3. **Top up $–.––**를 클릭합니다. 성공하면 *"Top-up successful. Your balance has been credited."*가 표시됩니다. 충전 금액은 잔액에 즉시 반영됩니다.

권장: Auto top-up 카드에서 Enable auto top-up을 켜고, When balance is below와 Top up by(역시 최소 $10)를 설정한 다음 Save changes를 클릭하십시오. 그러면 잔액이 기준값 아래로 떨어질 때마다 카드로 자동 결제되므로 추론이 예기치 않게 중단되지 않습니다. 자세한 내용은 예산 및 충전을 참조하십시오.

3단계 — 첫 요청 보내기

해당하는 방법을 선택하십시오.

AI 에이전트나 Workflows를 사용하는 경우

구성할 것이 없습니다. 이 시설과 페어링된 AI 에이전트 기기는 자동으로 연결되며, Workflows도 연결할 수 있습니다. Settings(톱니바퀴) → Service Access & API Keys를 열고 에이전트가 Connected Services에 온라인 상태로 표시되는지 확인하십시오. Connected Services를 참조하십시오.

자체 소프트웨어를 연결하는 경우

  1. Settings(톱니바퀴) → Service Access & API Keys를 열고 Create key를 클릭합니다. "Copy your API key" 대화 상자에서 비밀 키를 복사합니다. "This is the only time the full key is shown. Store it somewhere safe."
  2. 같은 페이지의 Connecting to the API 카드에 표시된 Base URL과 예제 요청을 사용합니다. 최소 테스트:
curl https://app.performancehub.co/ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "Hello"}]}'

Python 및 TypeScript 예제는 애플리케이션 연결을 참조하십시오.

4단계 — 확인

Logs 탭을 엽니다. 테스트 요청이 곧바로 모델, 토큰 수, 비용, 속도 및 success 상태와 함께 표시되어야 합니다. 표시되지 않으면 문제 해결을 참조하십시오.

  • 지출 한도 설정 — Budgets & Limits → Spend Limits. 월별 한도는 합리적인 안전장치입니다. 예산 및 충전을 참조하십시오.
  • 모델 카탈로그 검토 — Settings → Models. 모든 모델은 기본적으로 활성화되어 있습니다. 공급자나 예산에 대한 선호가 있다면 빠른 사전 설정을 사용하여 범위를 좁히십시오. Models를 참조하십시오.
  • Guardrails 고려 — Settings → Guardrails에서 PII 마스킹, 비밀 정보 삭제, 프롬프트 인젝션 차단을 설정할 수 있습니다. 기본적으로 활성화된 항목은 없습니다. Guardrails를 참조하십시오.