Dream オブジェクト
すべての Dream エンドポイントは Dream オブジェクトを返します。| フィールド | 型 | 説明 |
|---|---|---|
id | string | Dream ID（drm_ プレフィックス） |
type | string | 常に "dream" |
status | string | Dream ステータス、Dream ステータス を参照 |
inputs | array | 入力リスト、Dream input を参照 |
outputs | array | 出力リスト、Dream output を参照 |
model | object | 使用モデル、形式は {"id": "auto"} |
instructions | string | カスタム整理指示、最大 4096 文字 |
session_id | string または null | 関連する Dreaming Session ID（実行開始後に設定） |
usage | object | トークン使用統計 |
error | object または null | 失敗時のエラー詳細 |
created_at | string | UTC 作成時刻（ISO 8601） |
ended_at | string または null | UTC 終了時刻（終了状態のみ） |
archived_at | string または null | UTC アーカイブ時刻 |
Dream ステータス
| 値 | 説明 |
|---|---|
pending | 作成済み、実行待ち |
running | メモリ整理を実行中 |
completed | 整理完了、結果は outputs に格納 |
failed | 実行失敗、原因は error を参照 |
canceled | ユーザーによりキャンセル |
Dream input
inputs 配列の各要素:
| type の値 | 必須フィールド | 説明 |
|---|---|---|
memory_store | memory_store_id | 入力 Memory Store を指定（必須、1 件のみ） |
sessions | session_ids | 優先する Session を指定（任意、最大 100 件） |
Dream output
完了後、outputs 配列の要素:
| フィールド | 型 | 説明 |
|---|---|---|
type | string | 常に "memory_store" |
memory_store_id | string | 整理後の出力 Memory Store ID |
files_touched | array | 作成・変更・削除されたメモリファイルのパス |
Dream usage
| フィールド | 型 | 説明 |
|---|---|---|
input_tokens | integer | 入力トークン数 |
output_tokens | integer | 出力トークン数 |
cache_creation_input_tokens | integer | キャッシュ作成トークン数 |
cache_read_input_tokens | integer | キャッシュ読み込みトークン数 |
Dream error
失敗時に返されるエラーオブジェクト:| フィールド | 型 | 説明 |
|---|---|---|
type | string | エラー種別（例: "no_output"、"internal_error"） |
message | string | エラー説明 |