HALO에서는 프로젝트 범위 키 하나로 공급자 네이티브 모델 API, 장기 메모리, 인증, 서비스 ID, 사용량 제어 기능을 이용할 수 있습니다. 이 빠른 시작 가이드에서는 첫 번째 OpenAI 호환 모델 요청을 전송합니다.
#시작하기 전에
HALO 계정과 활성 프로젝트가 필요합니다. 모델 호출 비용은 프로젝트 소유자의 계정 잔액에서 차감됩니다.
#1. 프로젝트 생성
HALO 대시보드에서 프로젝트를 선택한 다음, 연동할 애플리케이션 또는 환경용 프로젝트를 생성하세요.
- 1경계 이름 지정
프로덕션, 스테이징 및 서로 관련 없는 OEM 제품에는 별도의 프로젝트를 사용하세요. 메모리와 인증 데이터는 프로젝트별로 격리됩니다.
- 2프로젝트 열기
선택한 프로젝트가 키, 모델, 메모리, 기록 및 인증을 관리하는 대시보드 컨텍스트가 됩니다.
#2. API 키 생성
API 키를 선택하고 클라이언트 키를 생성한 뒤 한 번만 복사하세요. 서버의 비밀 관리 도구에 HALO_API_KEY라는 이름으로 저장하세요.
HALO_API_KEY=sk-your-project-client-key#3. 요청하기
HALO는 각 공급자의 기존 통신 프로토콜을 그대로 유지합니다. 기존 OpenAI 클라이언트의 기본 URL을 HALO 기본 URL로 지정하면 나머지 요청 구조는 그대로 사용할 수 있습니다.
curl https://api.agihalo.com/openai/v1/chat/completions \
-H "Authorization: Bearer $HALO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5-mini",
"messages": [
{ "role": "user", "content": "Reply with one word: ready" }
]
}'