GET https://ark.cn-beijing.volces.com/api/v3/dreams
分页查询当前账号和项目下的 Dream 任务。支持按任务状态和输入 Memory Store 筛选，并按创建时间升序或降序返回。
鉴权#
本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数#
Query 参数#
在 URL Query String 中传入。
limit integer 默认值 20 | 每页数量
每页返回的 Dream 数量，取值范围为 1～100。
取值范围：[1, 100]
order string 默认值 desc | 排序方式
Dream 的创建时间排序方式。asc 表示升序，desc 表示降序。
page string | 下一页标识
首次请求时省略该参数。
后续请求将上一次响应返回的 next_page 原样传入该参数。
不要解析、生成或修改该值；该值必须与当前账号、项目、状态、输入 Memory Store 筛选条件和排序方式匹配。
source_memory_store_query string | 输入记忆库筛选
按输入 Memory Store 筛选 Dream。传入完整 ID 时精确匹配；传入名称时执行子串匹配，其中 %、_ 和反斜线均按普通字符处理。
status string[] | 状态过滤
按 Dream 状态过滤。可以重复传入该 query 参数，匹配任一指定状态；省略时返回所有状态。可选值：pending、running、completed、failed、canceled。
响应参数#
data object[] | Dream 列表
当前页的 Dream 列表，按 order 指定的创建时间顺序返回。
created_at string | 创建时间
data.created_at
任务创建时间，RFC 3339 格式。
id string | Dream ID
data.id
Dream 任务的唯一标识符，格式为 drm- 开头的字符串。
inputs object[] | 任务输入
data.inputs
创建任务时保存的输入快照。
源记忆库输入 object
创建任务时保存的源 Memory Store 输入。
memory_store_id string | 源记忆库 ID
data.inputs.memory_store_id
源 Memory Store ID。
type string | 输入类型
data.inputs.type
输入类型，固定为 memory_store。
memory_store_name string | 输入记忆库名称
data.inputs.memory_store_name
输入 Memory Store 的当前名称。关联的 Memory Store 已删除时省略。
历史会话输入 object
创建任务时保存的历史 Session 输入。
session_ids string[] | 历史会话 ID
data.inputs.session_ids
创建任务时保存的历史 Session ID 列表。
type string | 输入类型
data.inputs.type
输入类型，固定为 sessions。
model object | 模型信息
data.model
执行记忆整理任务的模型信息。
id string | 模型 ID
data.model.id
执行记忆整理任务的模型 ID。
outputs object[] | 任务输出
data.outputs
Dream 创建的输出 Memory Store。访问时机和内容完整性由 status 表示。
memory_store_id string | 输出记忆库 ID
data.outputs.memory_store_id
Dream 创建的输出 Memory Store ID。
type string | 输出类型
data.outputs.type
输出类型，固定为 memory_store。
memory_store_name string | 输出记忆库名称
data.outputs.memory_store_name
输出 Memory Store 的当前名称。关联的 Memory Store 已删除时省略。
status string | 任务状态
data.status
Dream 任务状态。
pending：任务已受理，正在等待执行，输出 Memory Store 尚不可访问。running：任务正在执行，输出 Memory Store 尚不可访问。completed：任务已完成，输出 Memory Store 可以使用。failed：任务执行失败，输出 Memory Store 可以访问，但内容可能为空或不完整；可通过error查看原因。canceled：任务已取消，输出 Memory Store 可以访问，但内容可能为空或不完整。
type string | 对象类型
data.type
对象类型，固定为 dream。
ended_at string | 结束时间
data.ended_at
任务进入终态的时间，RFC 3339 格式。任务未结束时为 null。
error object | 失败信息
data.error
任务异步执行失败的信息。任务未失败时为 null。
message string | 错误信息
data.error.message
Dream 执行失败的原因，用于定位任务失败问题。
type string | 错误类型
data.error.type
错误类型。timeout 表示任务超时；internal_error 表示任务执行期间发生内部错误。
instructions string | 整理指令
data.instructions
创建任务时传入的记忆整理要求。未传入时为 null。
running_time number | 累计运行时长
data.running_time
Dream 排除空闲间隔后的累计运行时长，单位为秒。暂未获得时为 null。
usage object | 用量统计
data.usage
任务的 Token 用量。值为 null 时表示用量未知，不能解释为零消耗。
cache_creation_input_tokens integer | 缓存创建 Token 数
data.usage.cache_creation_input_tokens
写入缓存的输入 Token 数。
cache_read_input_tokens integer | 缓存读取 Token 数
data.usage.cache_read_input_tokens
从缓存读取的输入 Token 数。
input_tokens integer | 输入 Token 数
data.usage.input_tokens
本次 Dream 执行消耗的输入 token 数。
output_tokens integer | 输出 Token 数
data.usage.output_tokens
本次 Dream 执行生成的输出 token 数。
next_page string | 下一页标识
下一页标识。响应未返回 next_page 时，表示无更多数据，应停止分页查询。
total_count integer | Dream 总数
满足当前筛选条件的 Dream 总数，不受分页影响。