| Time | Event | Device | Detail |
|---|---|---|---|
| 列名 | 必須 | 説明 | 例 |
|---|---|---|---|
| device_id | 必須 | 管理上の端末 ID。30 文字以内・重複不可（重複行はスキップ） | PANBO-JP-00000001 |
| mac_address | 任意 | 簡易アクティベーションを使うなら実質必須。端末の Wi-Fi STA MAC。大文字コロン区切りで保存される | 90:E5:B1:D4:80:8C |
| hardware_version | 任意 | 基板の版数 | v1.2 |
| serial_number | 任意 | 製造番号 | SN2026Q3-0001 |
device_id,mac_address,hardware_version,serial_number PANBO-JP-00000001,90:E5:B1:D4:80:8C,v1.2,SN2026Q3-0001 PANBO-JP-00000002,90:E5:B1:D4:80:9A,v1.2,SN2026Q3-0002 PANBO-JP-00000003,,v1.2,
- 文字コードは UTF-8、区切りは半角カンマ。値の中にカンマは使えません（引用符付き CSV には未対応）
- 列の順番は自由です。見出し名で対応付けます（大文字小文字は問いません）
- 空欄にしたい列は、上の 3 行目のようにカンマだけを置きます
- 登録直後の状態は UNACTIVATED。端末が初回接続した時点で ACTIVE になります
- 行ごとに QR 方式用のアクティベーションコードが自動発行されます（有効期限 24 か月）
- 既に存在する device_id の行はスキップされ、取り込み結果に理由付きで表示されます
| Device ID | Status | Plan | Firmware | Tags | Last Seen | Anomaly | ||
|---|---|---|---|---|---|---|---|---|
|
|
FLAG- |
|
| MAC | ロットコード | FW | 送信元 IP | 試行 | 初回 / 最終 | 状態 | |
|---|---|---|---|---|---|---|---|
|
|
承認済み・端末の次回接続で自動有効化されます
この端末は登録済みです。手動操作は不要です。端末が次にサーバへ接続したとき（＝次に会話を始めたとき）に自動的に ACTIVE になり、認証キーが発行されます。すぐに反映したい場合は端末を再起動してください。
This activation code can only be used once. Keep it secure.
空欄にするとプラン設定（Settings → デバイス設定）に従います。変更は次に開始されるセッションから反映されます。
| Session ID | Status | Model | Issued | Ended | Duration | Reason |
|---|---|---|---|---|---|---|
| Session ID | Device | Status | Model | Issued | Last HB | Duration | 申告 in/out | Cost | Reason | |
|---|---|---|---|---|---|---|---|---|---|---|
| Device | Measured | Reported | Sessions | Cost | |
|---|---|---|---|---|---|
| Time | Actor | Event | Device | IP | Detail |
|---|---|---|---|---|---|
Save this TOTP secret or scan the QR code with your authenticator app. It cannot be retrieved later.
| Role | Status | Created | Actions | |
|---|---|---|---|---|
Reset TOTP を実行すると、現在の認証アプリに登録されている TOTP コードはすべて無効になります。新しいシークレットを認証アプリに再登録するまでログインできなくなります。
Register this new secret in your authenticator app immediately. Your old TOTP codes no longer work.
| Name | Description | Devices | Active | Actions |
|---|---|---|---|---|
| Device ID | Status | Plan | Firmware | Last Seen | Actions |
|---|---|---|---|---|---|
よく使う役割（プロンプト）を貯めておき、端末やプランへワンクリックで適用します。 適用は内容のコピーです。ここでプリセットを編集しても、すでに適用済みの端末は変わりません（再適用してください）。
反映は次に開始されるセッションから。通話中の端末は影響を受けません。
| Firmware Version | Total Devices | Active | Ratio | Actions |
|---|---|---|---|---|
|
|
| Device ID | Status | Firmware | Hardware | Group | Last Seen |
|---|---|---|---|---|---|
デバイスが OpenAI Realtime API に接続するために使用する API キーを管理します。
Active Key を設定・変更するには、まず新しいキーを Standby に登録し、Swap で Active に昇格させます。この2段階により、テスト済みのキーのみが Active になることを保証します。
Swap は瞬時に切り替わり、通信中のセッションに影響しません。問題があれば再度 Swap で即座に戻せます。
上部の Standby Key パネルの Swap ボタンをクリックしてください。
端末の役割（プロンプト）・言語・音声・モデル・利用上限をサーバ側で管理します。変更は次に発行されるセッションから適用されます（通話中のセッションには影響しません）。
最大 4000 文字。空欄の場合はサーバ内蔵の既定文が使われます。
この QR はスマートフォンで読みます。端末と同じ LAN の中でしか使わないなら http://192.168.x.x:8080/… でも動きますが、 外から使うなら**公開できるホスト名と HTTPS** が要ります。
単価は使用量レポートの概算コスト計算に使われます。モデル変更時は実価格に合わせて更新してください。
ファームウェアバージョンごとにロットコードを設定し、デバイスが MACアドレス + ロットコード で自動アクティベーションできるようにします。
セキュリティモデル: ロットコードはロット内で共通ですが、MAC アドレスが CSV で事前登録済みのデバイスのみアクティブ化できます。未登録 MAC からのリクエストは拒否されます。また、IP あたり 10回/時、MAC あたり 5回/時 のレート制限が適用されます。
従来のアクティベーションコード方式（POST /api/v1/device/activate）も引き続き利用可能です。
| FW Version | Lot Code | Description | Status | Created | Actions |
|---|---|---|---|---|---|
|
|
Disable / Delete の動作について
該当 FW バージョンのロットコードを即座に無効化します。新規アクティベーションはすべて拒否されますが、既にアクティブ化済みのデバイスには影響しません（接続・利用は継続可能）。再度 Enable で再開できます。
ロットコードを完全に削除します。Disable と同様に既存デバイスへの影響はありません。削除後に同じ FW バージョンで再作成が可能です。
活用例: FW バージョン更新時に旧バージョンを Disable → 新バージョンのロットコードを追加することで、旧 FW での新規アクティベーションを防止できます。