# 概要
> Beatra は Agent にプロダクション品質のマルチモーダル制作——動画・画像・音声・音楽——を提供します。必要なのは一度のインストール、一度のサインイン、ひとつのクレジット残高だけです。このドキュメントは、Beatra を組み込む開発者と、実際に呼び出しを実行する Agent の 2 種類の読者に向けて書かれています。

## 3 層の役割

- [1 · 起点 · Universal Skill](https://docs.beatra.ai/ja/docs/quickstart) — メッセージ 1 通でインストールする Skill です。いつクレジットを使うか、同じタスクだとどう見分けるか、アップロード、モデルの見つけ方を Agent に教えます。 すべての Agent プラットフォームはここから始まります
- [2 · 実行 · OAuth MCP](https://docs.beatra.ai/ja/docs/authentication) — `mcp.beatra.ai` の認証済み実行レイヤーです。制作・アップロード・モデル・ボイス・タスクの操作は、それぞれ 1 回の MCP ツール呼び出しです。 Skill が駆動します
- [並行 · 直結 · REST / OpenAPI](https://docs.beatra.ai/ja/docs/api-reference) — 同じ機能群を `api.beatra.ai` の HTTP エンドポイントとして提供します。 Agent を経由しないカスタムアプリケーション向けです

3 つの経路は同じ非同期タスクに着地します。タスク情報、進捗の確認、コールバック、課金は共通です。推奨は Skill + MCP です。REST は Agent を経由しないアプリケーション向けです。

## パスを選ぶ

- [Agent を使う場合](https://docs.beatra.ai/ja/docs/quickstart) — クイックスタートに従ってください。メッセージ 1 通、サインイン 1 回です。Skill をインストールでき、MCP に接続できる Agent なら使えます。
- [カスタムアプリケーションを作る場合](https://docs.beatra.ai/ja/docs/authentication) — 認証とリクエスト規約から始め、API リファレンスと非同期タスクを読んでください。
- [このページを読んでいる Agent へ](https://docs.beatra.ai/llms.txt) — `llms.txt` がサイトマップ、`/llms/*.md` が自己完結型ワークフロー、`openapi.json` が機械可読契約です。

## 機能マップ

4 つのモダリティに公開ソーシャルデータを加えた一覧です。どれも同じタスク情報、進捗の確認、同じコールバックの約束を持つ、非同期の課金タスクとして提供されます。

| モダリティ | できること |
| --- | --- |
| **画像** | [テキストから画像を生成](https://docs.beatra.ai/ja/docs/capabilities/images/text-to-image) · [参照画像で画像を変換](https://docs.beatra.ai/ja/docs/capabilities/images/image-to-image) · [ベース画像を編集](https://docs.beatra.ai/ja/docs/capabilities/images/image-edit) · [画像理解](https://docs.beatra.ai/ja/docs/capabilities/images/image-understanding) |
| **動画** | [テキストから動画を生成](https://docs.beatra.ai/ja/docs/capabilities/videos/text-to-video) · [画像をアニメーション化](https://docs.beatra.ai/ja/docs/capabilities/videos/image-to-video) · [参照素材から動画を生成](https://docs.beatra.ai/ja/docs/capabilities/videos/reference-to-video) · [指定した終了フレームへ動画を生成](https://docs.beatra.ai/ja/docs/capabilities/videos/frames-to-video) · [既存動画を編集](https://docs.beatra.ai/ja/docs/capabilities/videos/video-edit) · [既存動画を延長](https://docs.beatra.ai/ja/docs/capabilities/videos/video-extend) · [動画プロンプトを強化する](https://docs.beatra.ai/ja/docs/capabilities/videos/video-prompt-enhancement) · [動画理解](https://docs.beatra.ai/ja/docs/capabilities/videos/video-understanding) |
| **音声とボイス** | [音声合成](https://docs.beatra.ai/ja/docs/capabilities/speech/text-to-speech) · [ボイスクローン](https://docs.beatra.ai/ja/docs/capabilities/speech/voice-clone) · [ボイス管理](https://docs.beatra.ai/ja/docs/capabilities/speech/voices) |
| **音楽** | [テキストから音楽生成](https://docs.beatra.ai/ja/docs/capabilities/music/text-to-music) · [参照オーディオから音楽生成](https://docs.beatra.ai/ja/docs/capabilities/music/reference-audio-to-music) |
| **公開ソーシャルデータ** | [公開ソーシャルデータ](https://docs.beatra.ai/ja/docs/capabilities/social) |

機能ページは特定のモデルに縛られません。Agent は `beatra.models.list` でモデルと価格をリアルタイムに発見します。直接見るには[現在のモデルラインナップ](https://docs.beatra.ai/ja/docs/models)へ進んでください。

## プラットフォームの仕組み

| 仕組み | 答えること |
| --- | --- |
| [非同期タスク](https://docs.beatra.ai/ja/docs/mechanisms/async-tasks) | タスクが送信から終態までどう進み、どうポーリングし、何を失敗とみなすか。 |
| [ソース素材のアップロード](https://docs.beatra.ai/ja/docs/mechanisms/uploads) | ローカルの画像・音声・動画を参照可能な素材 ID にする方法。 |
| [コールバック](https://docs.beatra.ai/ja/docs/mechanisms/callbacks) | 終態を HTTPS アドレスへどう届け、署名をどう検証するか。 |
| [課金と使用量](https://docs.beatra.ai/ja/docs/mechanisms/billing) | いつ予約し、いつ確定し、失敗時にどう返金するか。 |
| [エラーとリトライ](https://docs.beatra.ai/ja/docs/mechanisms/errors) | エラーエンベロープの形、再試行できるもの、分岐の仕方。 |
| [レート制限](https://docs.beatra.ai/ja/docs/mechanisms/rate-limits) | 同時実行とレートの上限、超過後のバックオフ。 |