機能の総覧
Beatra の全機能を 1 枚のマトリクスで：モダリティ、MCP ツール、REST エンドポイント、実行モード。
1 機能 1 行。Agent はここでツールを選び、機能ページで引数・タスクの状態・
リカバリーを確認します。モデル・コントロール・価格は beatra.models.list
でリアルタイムに発見します。今すぐ利用可能なモデルと価格を見るには
現在のモデルラインナップへ。
画像
| 機能 | 入力 → 出力 | MCP ツール | REST エンドポイント |
|---|---|---|---|
| 画像理解 | 1〜8 枚の画像 + テキスト → テキスト | beatra.images.understand | POST /v1/images/responses |
| テキストから画像 | テキスト → 画像 | beatra.images.generate | POST /v1/images/generations |
| 画像から画像 | 画像 + テキスト → 画像 | beatra.images.transform | POST /v1/images/image-to-image |
| 画像編集 | 画像 + テキスト → 画像 | beatra.images.edit | POST /v1/images/edits |
動画
| 機能 | 入力 → 出力 | MCP ツール | REST エンドポイント |
|---|---|---|---|
| 動画理解 | 動画 1 本 + テキスト → テキスト | beatra.videos.understand | POST /v1/videos/responses |
| 動画プロンプト強化 | テキスト + 任意の参照素材 → 強化テキスト | beatra.videos.enhance_prompt | POST /v1/videos/prompts/enhance |
| テキストから動画 | テキスト → 動画 | beatra.videos.generate | POST /v1/videos/text-to-video |
| 画像から動画 | 画像 + テキスト → 動画 | beatra.videos.animate | POST /v1/videos/image-to-video |
| 参照から動画 | 参照素材 + テキスト → 動画 | beatra.videos.generate_from_references | POST /v1/videos/reference-to-video |
| フレーム指定から動画 | 必須の終了フレーム + 任意の開始フレーム + テキスト → 動画 | beatra.videos.interpolate | POST /v1/videos/frames-to-video |
| 動画編集 | 動画 + 参照 + テキスト → 動画 | beatra.videos.edit | POST /v1/videos/edit |
| 動画延長 | 動画 + テキスト → 動画 | beatra.videos.extend | POST /v1/videos/extend |
音声とボイス
| 機能 | 入力 → 出力 | MCP ツール | REST エンドポイント |
|---|---|---|---|
| 音声合成 | テキスト + ボイス → 音声 | beatra.speech.synthesize | POST /v1/audio/speech |
| ボイスクローン | 音声サンプル → ボイス | beatra.voices.clone | POST /v1/voices |
| ボイス管理 | —（管理） | beatra.voices.list | GET /v1/voices |
音楽
| 機能 | 入力 → 出力 | MCP ツール | REST エンドポイント |
|---|---|---|---|
| テキストから音楽 | プロンプト / 歌詞 → 音声 | beatra.music.generate | POST /v1/music/text-to-music |
| 参照オーディオから音楽 | 音声 + テキスト → 音声 | beatra.music.generate | POST /v1/music/reference-audio-to-music |
公開ソーシャルデータ
| 機能 | 入力 → 出力 | MCP ツール | REST エンドポイント |
|---|---|---|---|
| 公開ソーシャルデータ | 公開ソーシャル照会 → JSON（本文、指標、メディア URL） | beatra.social.tools.search / get / execute | MCP のみ |
ソーシャル読み取りは既存の OAuth MCP 接続を再利用します。各 execute は 1 件の前払いタスクで、価格は 6 / 12 / 30 / 60 credits のいずれかです。公開 Social REST API はありません。
共有契約
上の表の制作・理解呼び出しはすべて課金対象で、非同期タスクを返します：
202 + Task envelope を beatra.tasks.get（または
GET /v1/tasks/{task_id}）で終端状態までポーリングします。発見・管理系の
読み取り（ボイス、モデル、タスク）は同期呼び出しです。ライフサイクル全体——envelope スキーマ、
キャンセル、返金——は非同期タスクで一度だけ
定義され、すべての行に適用されます。