API リファレンス
N.E.K.O. は FastAPI を通じて包括的な API を公開しています。すべてのエンドポイントはメインサーバー（デフォルト http://localhost:48911）から提供されます。
ベース URL
http://localhost:48911認証
ローカルアクセスでは認証は不要です。LLM プロバイダーの API キーは設定システムで別途管理されます。
REST エンドポイント
| ルーター | プレフィックス | 説明 |
|---|---|---|
| Config | /api/config | API キー、ユーザー設定、プロバイダー設定 |
| Characters | /api/characters | キャラクターの CRUD、音声設定、マイク |
| Live2D | /api/live2d | Live2D モデル管理、感情マッピング |
| VRM | /api/model/vrm | VRM モデル管理、アニメーション |
| Memory | /api/memory | メモリファイル、レビュー設定 |
| Agent | /api/agent | エージェントフラグ、タスク、ヘルスチェック |
| Workshop | /api/steam/workshop | Steam Workshop アイテム、パブリッシュ |
| MMD | /api/model/mmd | MMD モデル管理 |
| PNGTuber | /api/model/pngtuber | PNGTuber モデル管理 |
| Music | /api/music | 音楽検索と再生プロキシ |
| Jukebox | /api/jukebox | 楽曲とアクションのライブラリ |
| Game | /api/game | ミニゲームバックエンド |
| Galgame | /api/galgame | ギャルゲーの返信オプション |
| Icebreaker | /api/icebreaker | 新規ユーザーのオンボーディング |
| Proactive | /api/proactive | プロアクティブチャットのモードと設定 |
| System | /api | 感情分析、スクリーンショット、ユーティリティ |
その他 / 内部ルーター
以下のルーターは稼働していますが、ここでは個別にドキュメント化されていません：capture（/api/capture）、cloudsave（/api/cloudsave）、storage-location（/api/storage/location）、avatar-drop（/api/avatar-drop）、card-assist（/api/card-assist）、auth/cookies（/api/auth）、tool（/api/tools）、debug（/api/debug）。
WebSocket
| エンドポイント | 説明 |
|---|---|
| プロトコル | 接続ライフサイクルとセッション管理 |
| メッセージタイプ | すべてのクライアント→サーバーおよびサーバー→クライアントのメッセージフォーマット |
| オーディオストリーミング | バイナリオーディオフォーマット、割り込み、リサンプリング |
内部 API
これらはサービス間 API であり、外部からの使用を意図していません：
| サーバー | 説明 |
|---|---|
| Memory Server | メモリの保存と取得（ポート 48912） |
| Agent Server | エージェントタスクの実行（ポート 48915） |
レスポンスフォーマット
すべての REST エンドポイントは JSON を返します。成功レスポンスは通常、データを直接含みます。エラーレスポンスは FastAPI のデフォルトフォーマットに従います：
json
{
"detail": "Error message describing what went wrong"
}コンテンツタイプ
application/json— ほとんどのエンドポイントmultipart/form-data— ファイルアップロード（モデル、音声サンプル）audio/*— 音声プレビューレスポンス