エンドポイント一覧
すべての v1 エンドポイントと Agent 統合向けの機械可読契約。
Base URL:https://api.beatra.ai/v1 · 認証と共通ヘッダーは認証とリクエスト規約を参照してください。
このページは人間向けの索引です。Agent は下の機械可読契約を読み込み、operation ページでパラメータ詳細を参照してください。
エンドポイント
| メソッド | パス | 説明 | モード |
|---|---|---|---|
| GET | /v1/models | モデル一覧(OpenAI 互換) | 同期 |
| GET | /v1/catalog/models | モデルカタログ(機能メタデータ付き) | 同期 |
| GET | /v1/catalog/capabilities | 機能カタログ | 同期 |
| GET | /v1/catalog/capabilities/{capability} | 機能の詳細(各モデルのパラメータと価格) | 同期 |
| GET | /v1/catalog/models/{model} | モデルの詳細(対応機能と価格) | 同期 |
| POST | /v1/images/generations | テキストから画像 | 非同期 |
| POST | /v1/images/image-to-image | 画像から画像 | 非同期 |
| POST | /v1/images/edits | 画像編集 | 非同期 |
| POST | /v1/videos/text-to-video | テキストから動画 | 非同期 |
| POST | /v1/videos/image-to-video | 画像から動画 | 非同期 |
| POST | /v1/videos/reference-to-video | 参照画像から動画 | 非同期 |
| POST | /v1/videos/frames-to-video | 開始・終了フレームから動画 | 非同期 |
| POST | /v1/videos/edit | 指示と参照画像による動画編集 | 非同期 |
| POST | /v1/videos/extend | 元動画の終端から続きを生成 | 非同期 |
| POST | /v1/audio/speech | 音声合成 | 非同期 |
| POST | /v1/voices | ボイスクローン | 非同期 |
| GET | /v1/voices | ボイス一覧 | 同期 |
| GET | /v1/voices/{voice_id} | ボイス詳細 | 同期 |
| DELETE | /v1/voices/{voice_id} | ボイスの削除 | 同期 |
| POST | /v1/music/text-to-music | テキストから音楽 | 非同期 |
| POST | /v1/music/reference-audio-to-music | 参照オーディオから音楽 | 非同期 |
| POST | /v1/uploads | ソース素材のアップロード(≤100MB、artifact_id を返す) | 同期 |
| GET | /v1/tasks | タスク一覧(カーソルページネーション) | 同期 |
| GET | /v1/tasks/{task_id} | タスク詳細(完全な envelope) | 同期 |
| POST | /v1/tasks/{task_id}/cancel | タスクのキャンセル(冪等) | 同期 |
| GET | /v1/health | ヘルスチェック | 同期 |
パラメータレベルの契約は OpenAPI から自動生成されています。各機能ページの「エンドポイント定義」リンクから参照できます。
機械可読
- OpenAPI YAML · OpenAPI JSON
- llms.txt — AI コーディングアシスタント向け統合資料のインデックス
- MCP metadata — OAuth 対応 MCP runtime と upload・画像・動画・音楽・音声・voice・model・task tools。詳細は Quickstart