快速开始

1. 打开开放平台登录页使用 AssetAI 账号登录
2. 在 API keys 创建密钥（aai_ 开头，仅创建时完整展示）；或走开放认证：试用 POST /api/open/v1/auth/register → POST /api/open/v1/auth/api-keys，已有账号则短信登录后再创建 Key（见 鉴权）。Skill / MCP 会代为开户。
3. （可选）在 充值 页充值余额；新账户有免费额度。试用号免费用尽须先绑手机（40201）
4. 按 接口参考 调用，或把 Skill 交给 Agent（推荐，无需 MCP）。需要连接器时再看 MCP。

鉴权 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 / Skill / MCP / Demo	客户端、Agent（推荐 Skill）与浏览器联调