You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
Dreams
创建 Dream
复制全文
下载 pdf
创建 Dream
POST https://ark.cn-beijing.volces.com/api/v3/dreams​
创建一个异步记忆整理任务。每个任务读取一个已有 Memory Store 和 1~100 个历史 Session,生成一个新的 Memory Store,不修改输入 Memory Store。​
输出 Memory Store 会与任务一起创建,但在任务处于 pending 或 running 状态时不可挂载、读取或修改。任务最长执行 48 小时。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。​
​​
请求参数​
Body 参数​
inputs object[] 必选 | 任务输入​
​
model string 必选 | 模型 ID​
​
output_memory_store_name string 必选 | 输出记忆库名称​
​
instructions string | 整理指令​
​
output_memory_store_description string | 输出记忆库描述​
​
​
响应参数​
created_at string | 创建时间​
​
id string | Dream ID​
​
inputs object[] | 任务输入​
​
model object | 模型信息​
​
outputs object[] | 任务输出​
​
status string | 任务状态​
​
type string | 对象类型​
​
ended_at string | 结束时间​
​
error object | 失败信息​
​
instructions string | 整理指令​
​
running_time number | 累计运行时长​
​
usage object | 用量统计​
​
​

Request

dream=$(
  curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/dreams" \
    -H "Authorization: Bearer $ARK_API_KEY" \
    -H "Content-Type: application/json" \
    -d @- <<EOF
{
  "inputs": [
    {
      "type": "memory_store",
      "memory_store_id": "$INPUT_MEMORY_STORE_ID"
    },
    {
      "type": "sessions",
      "session_ids": [
        "$SESSION_ID_1",
        "$SESSION_ID_2"
      ]
    }
  ],
  "model": "$MODEL_ID",
  "instructions": "保留稳定偏好和已验证结论;删除重复、过期和包含个人身份的信息;按主题组织结果。",
  "output_memory_store_name": "dream-curated-memory",
  "output_memory_store_description": "Dream 整理后的长期记忆"
}
EOF
)

printf '%s\n' "$dream"

DREAM_ID=$(jq -er '.id' <<<"$dream")
OUTPUT_MEMORY_STORE_ID=$(
  jq -er '.outputs[] | select(.type == "memory_store") | .memory_store_id' <<<"$dream"
)

export DREAM_ID OUTPUT_MEMORY_STORE_ID
printf 'Dream ID: %s\n' "$DREAM_ID"
printf 'Output Memory Store ID: %s\n' "$OUTPUT_MEMORY_STORE_ID"

Response

{
  "type": "dream",
  "id": "drm-20260924143000-a1b2c",
  "status": "pending",
  "inputs": [
    {
      "type": "memory_store",
      "memory_store_id": "memstore-20260920100000-source"
    },
    {
      "type": "sessions",
      "session_ids": [
        "sesn-20260921100000-a1b2c",
        "sesn-20260922100000-d3e4f"
      ]
    }
  ],
  "outputs": [
    {
      "type": "memory_store",
      "memory_store_id": "memstore-20260924143000-output"
    }
  ],
  "model": {
    "id": "<MODEL_ID>"
  },
  "instructions": "保留稳定偏好和已验证结论;删除重复、过期和包含个人身份的信息;按主题组织结果。",
  "created_at": "2026-09-24T06:30:00Z",
  "ended_at": null,
  "usage": null,
  "running_time": null,
  "error": null
}
最近更新时间:2026.10.10 16:05:11
这个页面对您有帮助吗?
有用
有用
无用
无用