银行流水

上传流水材料并提供购房 / 还款参数，解析明细后给出有效资产认定与风险提示。须先上传文件拿到 materialRef，再创建估值任务。

接口

方法	路径	说明
POST	/api/open/v1/bank-statement-valuations/materials	上传流水文件（可多文件）
POST	/api/open/v1/bank-statement-valuations	创建并后台执行
GET	/api/open/v1/bank-statement-valuations/{taskId}	查询详情
POST	/api/open/v1/bank-statement-valuations/stream	创建并 SSE

通用约定见 约定与通用响应。

1. 上传材料

Content-Type: multipart/form-data

字段	位置	类型	必填	说明
files	form	file[]	是	流水文件，可多个。支持 PDF / Excel / 图片等

响应 data 为数组：

字段	类型	说明
fileName	string	原始文件名
materialRef	string	后续创建任务要用的引用
contentType	string	MIME 类型

curl -s -X POST "http://localhost:8080/api/open/v1/bank-statement-valuations/materials" \
  -H "X-Api-Key: aai_你的密钥" \
  -F "files=@./statement.pdf"

2. 创建估值请求体

Content-Type: application/json

字段	类型	必填	说明	示例
purchaseAmount	number	是	购房总价（元），≥ 0	3000000
downPaymentAmount	number	是	首付金额（元），≥ 0	900000
repaymentCycle	integer	是	还款期数（月），≥ 0	360
monthInstallment	number	是	月供（元），≥ 0	9800
materials	object[]	是	至少 1 条，见下表
source	string	否	对话闭环传 CHAT
chatSessionId	number	否	对话会话 ID

materials[]：

字段	类型	必填	说明
fileName	string	是	与上传返回一致
materialRef	string	是	上传返回的引用
contentType	string	否	MIME

查询参数：callbackUrl（可选）。

创建示例

curl -s -X POST "http://localhost:8080/api/open/v1/bank-statement-valuations" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: aai_你的密钥" \
  -d '{
    "purchaseAmount": 3000000,
    "downPaymentAmount": 900000,
    "repaymentCycle": 360,
    "monthInstallment": 9800,
    "materials": [
      {
        "fileName": "statement.pdf",
        "materialRef": "上传接口返回的 materialRef",
        "contentType": "application/pdf"
      }
    ]
  }'

成功时 result（节选）

字段	类型	说明
purchaseAmount	number	购房总价
repaymentCycle	integer	还款期数
monthInstallment	number	月供
startDate / endDate	string	流水起止
totalInflow / totalOutflow	number	总流入 / 流出
effectiveAssets	number	有效资产
riskQuantity	integer	风险点数量
assetEvaluationConclusion	string	评估结论
riskAlert	object	风险提示结构
sourceReferenceList	object[]	来源引用
generatedAt	string	生成时间

SDK

valuate / valuateStream 会先上传再创建：

const detail = await client.bankStatement.valuate({
  purchaseAmount: 3_000_000,
  downPaymentAmount: 900_000,
  repaymentCycle: 360,
  monthInstallment: 9800,
  files: [{ fileName: "statement.pdf", data: fileBlob }],
});