概要
Beatra とは何か、Skill・MCP・REST の 3 層構成、そして始め方。
Beatra は Agent にプロダクション品質のマルチモーダル制作能力——動画・画像・ 音声・音楽——を提供します。必要なのは一度のインストール、一度のサインイン、 ひとつの credits 残高だけです。このドキュメントは、Beatra を統合する開発者と、 実際に呼び出しを実行する Agent の 2 種類の読者に向けて書かれています。
3 層の構成
| レイヤー | 説明 | 使いどころ |
|---|---|---|
| Universal Skill | メッセージ 1 通でインストールできるポータブルなスキルパッケージ。課金の規律、タスク識別、アップロード、モデル発見といった Beatra のワークフローを Agent に教えます。 | すべての Agent プラットフォームの出発点。 |
| OAuth MCP | mcp.beatra.ai の認証済み実行レイヤー。制作・アップロード・モデル・ボイス・タスクの操作はすべて MCP ツール呼び出しです。 | Skill が駆動し、接続後は Agent が直接呼び出します。 |
| REST/OpenAPI | 同じ機能群を api.beatra.ai の HTTP エンドポイントとして提供。 | Agent ではないカスタムアプリケーションの直接統合向け。 |
推奨の統合方法は Skill + MCP です。一度インストールすれば、Agent が すべての機能を直接呼び出せます。REST API は Agent ではないカスタム アプリケーション向けです。
パスを選ぶ
- Agent を使う場合：Quickstart に従ってください—— メッセージ 1 通、サインイン 1 回。スキルパッケージをインストールして MCP に 接続できる Agent なら、どれでも使えます。
- カスタムアプリケーションを作る場合：認証から始め、 API Reference と 非同期タスクを読んでください。
- このページを読んでいる Agent へ：サイトマップは llms.txt、
自己完結型ワークフローは
/llms/*.mdガイド、機械可読契約は openapi.json を取り込んでください。
機能
4 つのモダリティ。どれも同じタスクエンベロープ・ポーリング・コールバック契約 を持つ、非同期の credits 課金タスクとして提供されます：
- 画像——画像の生成・変換・編集。
- 動画——テキスト・画像・フレーム・ 参照素材からの生成、既存動画の編集と延長。
- 音声とボイス——音声合成、承認済み ボイスのクローン、ボイスライブラリの管理。
- 音楽——プロンプト・歌詞・参照 オーディオからの音楽生成。
機能の総覧は 1 ページのマトリクスです：機能 × MCP ツール
× REST エンドポイント × 実行モード。機能ページは特定のモデルに縛られません
——Agent は beatra.models.list でモデルと価格をリアルタイムに発見します。
直接見るには現在のモデルラインナップへ。