Skip to main content
시크릿 키를 발급받은 뒤 실제 애플리케이션에서 API를 호출하는 방법을 안내합니다. Air API는 OpenAI 호환 인터페이스를 제공하므로, OpenAI SDK를 사용하는 기존 코드에서 base_url과 API 키만 교체하면 바로 연동할 수 있습니다.

OpenAI에서 AirCloud로 전환하기

기존에 OpenAI SDK를 사용하고 있다면 두 가지만 교체하면 됩니다. 전체 Quick Start와 코드 예시는 OpenAI 호환 API 페이지를 참고하세요.

전환 체크리스트

  • base_url / baseURL을 콘솔에서 확인한 AirCloud 엔드포인트로 교체
  • API 키를 AirCloud 시크릿 키로 교체
  • model 파라미터를 AirCloud 모델 ID로 확인 및 교체

엔드포인트와 시크릿 키 확인

콘솔에서 API 워크로드를 선택한 뒤 코드 보기 버튼을 클릭하면 해당 모델의 엔드포인트 URL과 코드 샘플을 확인할 수 있습니다. Air Api Code 이 페이지의 예시 코드에서 YOUR_ENDPOINTYOUR_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 상세 스펙을 확인합니다.