Air API로 할 수 있는 일
- 프로젝트 안에서 API 워크로드 생성
- 지원 모델 선택
- API 액세스 엔드포인트 선택
- 시크릿 키 발급
- 코드 샘플 기반 연결 테스트
- Playground 기반 Web UI 테스트
- 동일한 설정을 바탕으로 Air Container 확장 검토
기본 흐름
- 프로젝트 개요에서 Air API 선택
- 필요한 모델 선택
- 시크릿 키 생성
- 코드 샘플로 연결 테스트
- Playground 또는 애플리케이션 연동
Quickstart: Air API로 시작하기
Air API는 프로젝트 안에서 모델 API를 빠르게 테스트하고 연동하려는 경우에 적합합니다.1. 프로젝트 개요에서 Air API 선택
조직과 프로젝트를 생성한 뒤, 프로젝트 개요 화면으로 이동하여 Air API를 선택합니다.2. 사용할 모델 선택
프로젝트 내에서 API 워크로드를 생성하고, 필요한 AI 모델을 선택합니다. 지원 모델은 지속적으로 추가될 예정이며, 필요한 모델이 없는 경우 피드백을 통해 요청할 수 있습니다.3. API 키 발급
API 액세스 엔드포인트를 선택한 뒤 시크릿 키를 생성합니다. 시크릿 키는 생성 이후 다시 확인할 수 없으므로, 반드시 복사해 안전하게 보관해야 합니다. 분실한 경우 재발급이 필요합니다.4. 코드 샘플로 연결 테스트
키를 발급받은 뒤 다시 API 화면으로 돌아가 코드 샘플을 확인합니다. 코드 샘플의 your-api-key 위치에 발급받은 시크릿 키를 입력해 연결 테스트를 진행합니다.5. Playground에서 테스트
Playground를 선택하면 Web UI에서 직접 모델 테스트를 진행할 수 있습니다. 또한 동일한 configuration으로 Air Container 배포를 선택할 수 있으므로, 요구 latency와 GPU 스펙에 맞춰 더 안정적인 서비스 환경으로 확장할 수 있습니다.이런 경우에 적합합니다
- 모델 API를 빠르게 붙이고 싶은 경우
- 초기 PoC나 프로토타입을 빠르게 검증하고 싶은 경우
- 별도 컨테이너 배포 없이 API 중심으로 시작하고 싶은 경우
다음에 읽으면 좋은 문서
모델 및 Playground
지원 모델 확인 및 Playground 기반 테스트 흐름을 안내합니다.
API 사용 가이드
API 호출 방법, 키 사용, 운영 시 주의사항을 정리합니다.
문제 해결
자주 발생하는 오류와 해결 방법을 확인합니다.