文档迁移接口

本文介绍文档迁移相关的 3 个接口。异步导出 document、下载导出文件，以及异步导入 document，用于数据迁移。

调用说明

• 接入地址：https://cloud.memory.bj.baidubce.com/api，下文路径直接拼接在该地址后。
• 请求头：Authorization: Bearer <token> 必填；有 JSON 请求体时需携带 Content-Type: application/json。
• 错误码、异步操作和 operationId 的说明见 API 简介。

接口列表

异步导出 document

POST /v1/default/banks/{bank_id}/document-transfer/export

提交异步 document 导出任务，将 Bank 中的 document（抽取的事实、entity 名称、因果链接和 chunks）打包为迁移用 ZIP 归档。归档不包含 embeddings 和数据库 ID；导入时会使用目标 Bank 的模型重新生成 embedding 并解析实体。除非设置 include_observations=true，否则不会导出 consolidation 后的 observations。传入 document_id 查询参数可导出指定 document；省略时导出整个 Bank。接口立即返回 operation_id，可通过异步操作接口查询进度；完成后从操作结果中取得下载地址。

参数

请求头

响应

• 状态码：202 — 已接受导出任务
• 格式：application/json

响应示例

1{
2  "operation_id": "550e8400-e29b-41d4-a716-446655440000",
3  "status": "pending"
4}

响应

• 状态码：422 — 校验错误
• 格式：application/json

响应示例

1{
2  "detail": [
3    {
4      "loc": [],
5      "msg": "string",
6      "type": "string",
7      "input": null,
8      "ctx": {}
9    }
10  ]
11}

operationId=export_documents

下载导出文件

GET /v1/default/files/download/{key}

下载异步导出任务生成并存入文件存储的 ZIP 归档。key 来自导出操作的 result_metadata（storage_key 或 download_url）；服务端会根据该 key 所属的 Bank 校验访问权限，并以附件形式返回文件。

参数

请求头

响应

• 状态码：200 — 文件内容
• 格式：application/octet-stream

响应

• 状态码：422 — 校验错误
• 格式：application/json

operationId=download_file

导入 document（异步）

POST /v1/default/banks/{bank_id}/document-transfer

提交 transfer archive（由 export 接口生成）导入 Bank。作为后台 operation 运行：使用目标 Bank 的 embedding model 重新生成 facts embedding，并重新解析 entities，不执行 LLM 抽取。返回 operation_id；轮询 GET /v1/default/banks/{bank_id}/operations/{operation_id} 获取状态及 result_metadata 中导入/跳过的数量。使用 on_conflict 控制已有 document ID：skip（默认）、replace 或 new-id。

参数

请求头

请求体

• 格式：multipart/form-data
• 必填：是

请求示例

1{
2  "file": "string"
3}

响应

• 状态码：202 — 成功响应
• 格式：application/json

响应示例

1{
2  "operation_id": "string",
3  "status": "pending"
4}

响应

• 状态码：422 — 校验错误
• 格式：application/json

响应示例

1{
2  "detail": [
3    {
4      "loc": [],
5      "msg": "string",
6      "type": "string",
7      "input": null,
8      "ctx": {}
9    }
10  ]
11}

operationId=import_documents