> ## 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/ja/sdks/python">
    同期・非同期サポート。完全な型ヒント。Python 3.9+。
  </Card>

  <Card title="TypeScript" icon="js" href="/docs/ja/sdks/typescript">
    完全型付き。ゼロ依存。Node.js、Deno、Bun で動作。
  </Card>

  <Card title="CLI" icon="terminal" href="/docs/ja/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` フラグ                                    | 手動       |
| **依存関係**     | httpx, pydantic     | なし（ネイティブ fetch）             | click, rich                                      | N/A      |

## 環境変数

すべての SDK は以下の環境変数をサポートしているため、一度設定すればスタック全体で使用できます。

| 変数               | 説明                                                     | デフォルト                         |
| ---------------- | ------------------------------------------------------ | ----------------------------- |
| `AVALA_API_KEY`  | 認証用の Avala API キー。クライアントコンストラクタにキーが渡されない場合、自動的に使用されます。 | なし（必須）                        |
| `AVALA_BASE_URL` | デフォルトの API ベース URL を上書きします。セルフホストデプロイメントや開発環境に便利です。    | `https://api.avala.ai/api/v1` |

## 認証

Avala API へのすべてのリクエストには、`X-Avala-Api-Key` ヘッダーに API キーを含める必要があります。API キーは [Avala ダッシュボード](https://avala.ai/settings?section=security)の**設定 > セキュリティ**で確認できます。

```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 を使用できます。`@avala-ai/mcp-server` パッケージは、データセット、プロジェクト、エクスポートを AI アシスタントが直接呼び出せるツールとして公開します。