# クイックスタート > 一文送って一度ログインすれば、あなたの Agent で Beatra を使えます。Skill をインストールでき、Python 3.10 以降を実行できる Agent であれば、次の流れはそのまま使えます。 手順の最終確認：2026-11-09 この手順で、Agent に Beatra Skill をインストールし、ブラウザで一度ログインして、最初の作品を受け取ります。Claude Code、Cursor、Codex、WorkBuddy のほか、Skill をインストールでき、Python 3.10 以降を実行できる Agent なら同じ流れです。インストールとログインは無料で、メディアの生成には Beatra のクレジットを使います。Skill、MCP、REST API を先に比べたい場合は、[利用方法の選び方](https://docs.beatra.cn/ja/docs/choose-integration)をご覧ください。 ### インストールのメッセージを Agent に送る ```text title="Agent に送る" Beatra をインストールし、ログインが必要になったら知らせてください：https://beatra.ai/install.md ``` Agent は利用中の環境を確認し、自動で進められる設定を完了します。プラットフォームの画面で操作が必要な場合は、その手順を具体的に案内します。インストールされる内容と、後からの更新や再接続の方法は[Beatra Skill のインストール](https://docs.beatra.cn/ja/docs/install-skill)にあります。 **チェックポイント** - [x] Agent がインストール完了を確認していること。 ### ブラウザで一度ログインする ブラウザで Beatra が開いたら、ログインして一度だけアクセスを許可してください。この一度のログインで画像、動画、音楽、音声をカバーし、制作の種類を変えても再認可は不要です。完了したら新しい Agent セッションを開始し、Beatra を読み込んでください。 **チェックポイント** - [x] ブラウザのページに「承認しました」と表示され、Agent が接続すると「接続しました」に変わること。 - [x] Agent が Beatra の準備完了を報告していること。 ### 制作を始める 普段の言葉で、欲しい結果を伝えてください。 ```text title="Agent に送る" このランディングページ用に、温かみのある雑誌風のイラストを作ってください。 ``` 時間のかかる制作はバックグラウンドで進み、完成すると Agent が結果を返します。メディアの生成にはクレジットが使われます。 **チェックポイント** - [x] Agent が Beatra タスクの作成を確認していること。 - [x] 完成後に成果物と今回の課金額が返ってくること。タスクが待機中や生成中のままなのは正常です。Agent は進捗を確認し続けます。 ### コンソールまたはスマホで確認する 作品は[コンソールの作品ページ](https://console.beatra.cn/assets)に表示されます。WeChat でスキャンして、[Beatra ミニプログラム](https://www.beatra.cn/ja/mini-program?utm_source=docs&utm_medium=quickstart)で見ることもできます。 **チェックポイント** - [x] コンソールの「作品」ページに今回の成果物が表示されていること。 ## うまく進まない場合 [#if-a-step-fails] 同じインストールメッセージをもう一度送ってください。正しく完了している設定はそのままに、残っている部分から再開します。具体的なメッセージが出た場合は次を参照してください。 - 承認ページ、ログインの認証コード、ログインの期限切れ：[トラブルシューティング：ログインできない](https://docs.beatra.cn/ja/docs/troubleshooting#sign-in)。WeChat の QR コードと認証コードについては[ログインのトラブルシューティング](https://docs.beatra.cn/ja/docs/sign-in-help)。 - クレジット不足：[トラブルシューティング：クレジットが足りない](https://docs.beatra.cn/ja/docs/troubleshooting#credits)。 - タスクが終わらない、またはエラーで終わった：[トラブルシューティング：タスクが遅い・タイムアウトする](https://docs.beatra.cn/ja/docs/troubleshooting#timeouts)。 ## 独自のサービスに組み込む 独自アプリケーションから Beatra を使う場合は REST/OpenAPI を利用します。 - [REST · API リファレンス](https://docs.beatra.cn/ja/docs/api-reference) — すべての v1 エンドポイントと機械可読契約です。 - [始める前に · 認証とリクエスト規約](https://docs.beatra.cn/ja/docs/authentication) — API Key、共通 Header、べき等です。 - [仕組み · 非同期タスク](https://docs.beatra.cn/ja/docs/mechanisms/async-tasks) — 送信から終態までのライフサイクルです。