# クイックスタート
> 一文送って一度ログインすれば、あなたの Agent で Beatra を使えます。Skill をインストールでき、MCP サーバーに接続できる Agent であれば、次の流れはそのまま使えます。

### インストールのメッセージを Agent に送る

```text title="Agent に送る"
Beatra をインストールし、ログインが必要になったら知らせてください：https://beatra.ai/install.md
```

Agent は利用中の環境を確認し、自動で進められる設定を完了します。プラットフォームの画面で操作が必要な場合は、その手順を具体的に案内します。

**チェックポイント**

- [x] Agent がインストール完了を確認していること。

### ブラウザで一度ログインする

ブラウザで Beatra が開いたら、ログインして一度だけアクセスを許可してください。この一度のログインで画像、動画、音楽、音声をカバーし、制作の種類を変えても再認可は不要です。完了したら新しい Agent セッションを開始し、Beatra を読み込んでください。

**チェックポイント**

- [x] ブラウザでサインインページが開き、一度アクセスを許可したこと。
- [x] Agent が Beatra 接続の検証完了を報告していること。

### 制作を始める

普段の言葉で、欲しい結果を伝えてください。

```text title="Agent に送る"
このランディングページ用に、温かみのある雑誌風のイラストを作ってください。
```

時間のかかる制作はバックグラウンドで進み、完成すると Agent が結果を返します。メディアの生成にはクレジットが使われます。

**チェックポイント**

- [x] Agent が Beatra タスクの作成を確認していること。
- [x] 完成後に成果物と今回の課金額が返ってくること。タスクが待機中や生成中のままなのは正常です。Agent は進捗を確認し続けます。

### コンソールまたはスマホで確認する

作品は[コンソールの作品ページ](https://console.beatra.ai/assets)に表示されます。WeChat でスキャンして、[Beatra ミニプログラム](https://beatra.ai/ja/mini-program?utm_source=docs&utm_medium=quickstart)で見ることもできます。

> **インストールやログインが途中で止まった場合**
>
> 同じインストールメッセージをもう一度送ってください。正しく完了している設定はそのままに、残っている部分から再開します。

## 独自のサービスに組み込む

独自アプリケーションから Beatra を使う場合は REST/OpenAPI を利用します。

- [REST · API リファレンス](https://docs.beatra.ai/ja/docs/api-reference) — すべての v1 エンドポイントと機械可読契約です。
- [始める前に · 認証とリクエスト規約](https://docs.beatra.ai/ja/docs/authentication) — API Key、共通 Header、べき等です。
- [仕組み · 非同期タスク](https://docs.beatra.ai/ja/docs/mechanisms/async-tasks) — 送信から終態までのライフサイクルです。