base_url과 API 키만 교체하면 바로 연동할 수 있습니다.
OpenAI에서 AirCloud로 전환하기
기존에 OpenAI SDK를 사용하고 있다면 두 가지만 교체하면 됩니다. 전체 Quick Start와 코드 예시는 OpenAI 호환 API 페이지를 참고하세요.전환 체크리스트
base_url/baseURL을 콘솔에서 확인한 AirCloud 엔드포인트로 교체- API 키를 AirCloud 시크릿 키로 교체
model파라미터를 AirCloud 모델 ID로 확인 및 교체
엔드포인트와 시크릿 키 확인
콘솔에서 API 워크로드를 선택한 뒤 코드 보기 버튼을 클릭하면 해당 모델의 엔드포인트 URL과 코드 샘플을 확인할 수 있습니다.
YOUR_ENDPOINT와 YOUR_API_KEY는 콘솔에서 확인한 값으로 교체하세요.
인증
모든 API 요청에는Authorization 헤더에 시크릿 키를 포함해야 합니다.
코드 예시
Chat 및 Embedding 코드 예시는 OpenAI 호환 API 페이지를 참고하세요. Air API는 OpenAI SDK의 audio 엔드포인트를 통한 TTS(Text-to-Speech) 호출도 지원하며, 예시는 아래와 같습니다.TTS 모델
운영 시 주의사항
- 키 보안: 시크릿 키는 환경 변수로 관리하고, 코드 저장소에 커밋하지 마세요.
- 사용량 확인: 콘솔의 사용량 탭에서 모델별 호출량과 비용을 정기적으로 확인하세요.
- 크레딧 부족: 크레딧이 소진되면 API 호출이 중단됩니다. 자동 충전을 설정해두는 것을 권장합니다.
관련 문서
모델 및 Playground
지원 모델 선택과 Playground 기반 테스트 흐름을 확인합니다.
OpenAI 호환 API
OpenAI SDK 코드 그대로 두 줄만 바꿔서 Air API에 연결합니다.
문제 해결
자주 발생하는 오류와 해결 방법을 확인합니다.
API 레퍼런스
엔드포인트와 파라미터 등 API 상세 스펙을 확인합니다.

