触发一次异步记忆整理任务。
POST /api/v1/cloud/dreams
创建一个 Dream,系统将异步整理指定的 Memory Store。返回 Dream 对象。
请求头
| 头部 | 必选 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或 SAT> |
Content-Type | 是 | application/json |
请求体
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
inputs | array | 是 | 输入列表。必须包含一个 memory_store 类型输入,可选包含 sessions 类型输入 |
model | string | object | null | 否 | 模型 ID 或 Dream model 对象,可同时指定思考深度和上下文窗口。省略或传 null/空字符串时使用 auto |
instructions | string | 否 | 自定义整理指令,UTF-8 编码后最多 4096 字节(多字节字符会占用多个字节) |
inputs 元素
| 字段 | 类型 | 说明 |
|---|---|---|
type | string | "memory_store" 或 "sessions" |
memory_store_id | string | 当 type 为 memory_store 时必填 |
session_ids | array | 当 type 为 sessions 时必填,最多 100 个 Session ID |
model 对象
旧字符串请求仍受支持,例如 "model": "auto"。也可传对象:
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
id | string | 是 | 非空模型 ID。使用 列出模型 返回的可用且启用的 ID;不限定为固定档位 |
effort | string | 否 | 思考深度:none、low、medium、high、xhigh、max。除 none 外,必须在所选模型的 efforts 中;none 表示显式关闭思考 |
context_window | integer | 否 | 上下文窗口 token 数,必须为正整数。模型有非空 available_context_windows 时必须选其中一个值;目录未声明档位时不做档位限制 |
- 两个选项可独立省略;省略表示不指定覆盖值,响应不会补成用户显式选择。显式传 null、空 effort、零或负窗口等非法值返回 400。
- 整个
model省略、为 null、空字符串或纯空白字符串时按auto处理;对象必须包含非空id,{}不等价于 auto。 auto不带选项时保留自动路由;带effort或context_window时,模型目录必须存在可用且支持相应选项的auto条目,否则返回 400。- 对象只支持
id、effort、context_window;speed及其他未知字段返回 400。错误响应的error.param指向对应字段。 - 上例仅演示格式;使用前查询当前身份可用的模型及参数,不假定
dfmodel、high或400000始终可用。
示例请求
示例响应
HTTP 201 Created
错误码
| HTTP | Type | 触发条件 |
|---|---|---|
| 400 | invalid_request_error | inputs 为空或无效、缺少或重复 memory_store 输入、引用的源 Store 不存在或不可访问、sessions 总数超过 100、模型不可用或未启用、模型选项类型/组合无效或含未知字段、instructions 超过 4096 UTF-8 字节 |
| 401 | authentication_error | 缺少或无效的认证令牌 |
| 409 | conflict_error | 当前身份在该工作空间已有活跃 Dream(pending 或 running) |