API ドキュメント
RakuAI 開発者コンソール REST API と MCP ランタイムコントラクトのリファレンス。REST エンドポイントは /api/v1/ 配下にバージョン管理されています。MCP サーバーは raku-mcp.fly.dev/mcp/ にあります。
クイックスタート
最速ルート: MCP サーバーを Claude Desktop に組み込み、get_metrics を呼び出す。以下の REST フローは開発者コンソールへのプログラム的アクセス用です。
1. API キーを取得
開発者 NDA に同意し、ダッシュボード から API キーを作成。同じキーで MCP サーバー用の短期 JWT を発行（Claude Desktop ガイドを参照）し、下記の REST 呼び出しを認可できます。
2. MCP 経由でランタイムを駆動
Claude Desktop の接続が完了したら、こう尋ねてみてください:
Claude が get_metrics を呼び出し、次のような JSON ペイロードを返します:
"fps": 0.0,
"sim_running": false,
"loaded_adapters": 0,
"status": "ok"
}
3. REST エンドポイントを直接呼び出す
プログラム的な開発者コンソール作業（キー管理、使用状況など）には、API キーで REST エンドポイントを呼び出します:
-H "Authorization: Bearer YOUR_API_KEY"
認証
すべての API リクエストには、Authorization ヘッダーに Bearer トークンが必要です。ログイン・登録から得られる JWT アクセストークン、または開発者ダッシュボードから取得した API キーのいずれかを使用できます。
MCP サーバー
任意の MCP 対応クライアントからランタイムを駆動するための 6 ツール MCP サーフェス。stdio および HTTP トランスポート対応。ツール×呼び出し元ごとのデフォルト拒否パーミッション、完全な監査ログ。接続手順とツール完全リファレンスは Claude Desktop ガイドを参照。
| ツール | モード | 説明 |
|---|---|---|
get_metrics | 全モード | FPS、フレーム時間、アダプター数、稼働時間 — 安全な読み取り。 |
get_scene_state | 全モード | ノード、物理ボディ、ロード済みアダプター、シミュレーション状態のスナップショット。 |
load_world_model | サンドボックス／開発 | アダプターを登録（Runway、Veo、Marble、Genie、content_pack）。 |
ingest_frame | サンドボックス／開発 | 生成モデルのフレームをシーングラフにプッシュ。 |
set_render_target | サンドボックス／開発 | WebGL、VR ヘッドセット、ネイティブウィンドウ、オフスクリーン。 |
start_simulation | サンドボックス／開発 | シミュレーションループを開始。設計上、本番モードでは拒否。 |
GET /api/v1/usage
生成・改良回数、ティア情報、残りクォータを取得します。
API キー管理
指定したスコープで新しい API キーを作成します。
すべての API キー（有効・失効済み）を一覧表示します。
API キーを失効させます。取り消せません。
レート制限
API リクエストはユーザーのティアごとにレート制限されます：
| ティア | 生成 / 日 | 改良 / 日 | 同時実行 |
|---|---|---|---|
| 匿名 | 3 | 0 | 1 |
| Free | 10 | 30 | 1 |
| Pro | 100 | 500 | 3 |
| Enterprise | 無制限 | 無制限 | 10 |
制限を超えると 429 Too Many Requests と Retry-After ヘッダーが返ります。
インタラクティブ API エクスプローラー
自動生成ドキュメントで、API 全体をインタラクティブに探索できます：
Swagger UI → Redoc →