SDK - Avala Documentation

클라이언트 라이브러리

Python

동기 및 비동기 지원. 완전한 타입 힌트. Python 3.9+.

완전한 타입 지원. 의존성 없음. Node.js, Deno, Bun에서 작동.

터미널에서 데이터셋, 내보내기, 스토리지를 관리. curl -fsSL https://avala.ai/install.sh | bash.

HTTP 요청으로 모든 언어에서 API를 직접 사용.

OpenAPI 스펙으로 자체 클라이언트를 생성.

빠른 비교

기능	Python	TypeScript	CLI	REST API
설치	`pip install avala`	`npm install @avala-ai/sdk`	`curl -fsSL https://avala.ai/install.sh \| bash`	직접 HTTP
비동기	동기 + 비동기	비동기	N/A	모두
타입 안전성	완전한 타입 힌트	완전한 TypeScript 타입	N/A	N/A
자동 재시도	예	예	SDK를 통해	수동
페이지네이션	내장 이터레이터	내장 이터레이터	`--limit` 플래그	수동

환경 변수

모든 SDK는 다음 환경 변수를 사용하므로 한 번 구성하면 전체 스택에서 사용할 수 있습니다.

변수	설명	기본값
`AVALA_API_KEY`	인증을 위한 Avala API 키. 클라이언트 생성자에 키가 전달되지 않으면 자동으로 사용됩니다.	없음 (필수)
`AVALA_BASE_URL`	기본 API 기본 URL 재정의. 셀프 호스팅 배포 또는 개발 환경에 유용합니다.	`https://api.avala.ai/api/v1`

인증

Avala API에 대한 모든 요청은 X-Avala-Api-Key 헤더에 API 키를 포함해야 합니다. 설정 > 보안 아래 Avala 대시보드에서 API 키를 찾을 수 있습니다.

export AVALA_API_KEY="your-api-key"

환경 변수가 설정되면, 모든 SDK가 추가 구성 없이 자동으로 인식합니다.