快速开始

1. 打开开放平台登录页（/open-platform/login）使用 Asset-AI 账号登录
2. 在 API keys 创建密钥（aai_ 开头，仅创建时完整展示）
3. （可选）在 充值 页充值余额；新账户有免费额度
4. 按 接口参考 调用，或使用官方 SDK

鉴权 Header

X-Api-Key: aai_xxxxxxxx

最小轮询示例（房产）

必填：city、address、buildingArea、propertyUsage。完整字段见 房产估值。

curl -s -X POST "http://localhost:8080/api/open/v1/property-valuations" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: aai_你的密钥" \
  -d '{
    "city": "广东省/深圳市/南山区",
    "address": "科技园某某小区",
    "buildingArea": 89.5,
    "propertyUsage": "RESIDENTIAL"
  }'

响应里取 data.taskId，再轮询：

curl -s "http://localhost:8080/api/open/v1/property-valuations/{taskId}" \
  -H "X-Api-Key: aai_你的密钥"

status=SUCCESS 时读 data.result；FAILED 时读 data.errorMessage。

设备估值示例

必填：model、manufactureDate（YYYY-MM）。完整字段见 设备估值。

curl -s -X POST "http://localhost:8080/api/open/v1/equipment-valuations" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: aai_你的密钥" \
  -d '{
    "model": "STC200",
    "manufactureDate": "2021-06",
    "manufacturer": "徐工"
  }'

下一步

文档	内容
约定与通用响应	信封、创建/查询字段、资产路径表
房产 / 车辆 / 土地 / 设备 / 流水	入参表、返回 result、curl / SDK
轮询 / 流式 / Webhook	取数方式
智能对话	OCR、发消息 Body、SSE 事件
SDK / Demo	客户端与浏览器联调