> ## Documentation Index
> Fetch the complete documentation index at: https://avala.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK

> Avala API를 위한 공식 SDK 및 클라이언트 라이브러리

Avala는 선호하는 언어나 프레임워크에서 플랫폼과 통합할 수 있도록 공식 SDK와 클라이언트 라이브러리를 제공합니다. 각 SDK는 관용적인 메서드, 내장 인증, 자동 재시도, 완전한 타입 안전성으로 Avala REST API를 래핑합니다.

## 클라이언트 라이브러리

<CardGroup cols={2}>
  <Card title="Python" icon="python" href="/docs/ko/sdks/python">
    동기 및 비동기 지원. 완전한 타입 힌트. Python 3.9+.
  </Card>

  <Card title="TypeScript" icon="js" href="/docs/ko/sdks/typescript">
    완전한 타입 지원. 의존성 없음. Node.js, Deno, Bun에서 작동.
  </Card>

  <Card title="CLI" icon="terminal" href="/docs/ko/sdks/cli">
    터미널에서 데이터셋, 내보내기, 스토리지를 관리. `curl -fsSL https://avala.ai/install.sh | bash`.
  </Card>

  <Card title="REST API" icon="globe" href="/docs/sdks/rest-api">
    HTTP 요청으로 모든 언어에서 API를 직접 사용.
  </Card>

  <Card title="OpenAPI" icon="code" href="/docs/sdks/openapi">
    OpenAPI 스펙으로 자체 클라이언트를 생성.
  </Card>
</CardGroup>

## 빠른 비교

| 기능         | 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 대시보드](https://avala.ai/settings?section=security)에서 API 키를 찾을 수 있습니다.

```bash theme={null}
export AVALA_API_KEY="your-api-key"
```

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

## MCP 통합

[Model Context Protocol](/docs/integrations/mcp-setup)을 통해 Claude, Cursor, VS Code 같은 AI 어시스턴트와 함께 Avala를 사용하세요.