后台中的工具同样可以通过编程方式使用。工具的价格与后台相同,另加一次 API 调用(限制与计费)。基础地址:https://developers.grem.capital/api/v1。
列表
| 工具 | 请求 | 权限范围 | 运行方式 |
|---|---|---|---|
| 快速估价 | POST /valuation/express | tools:valuation | 立即 |
| 完整估价报告 | POST /valuation/report | tools:valuation | 任务 |
| 租金估算 | POST /valuation/rent | tools:rent | 立即 |
| 报告审核 | POST /valuation/review | tools:review | 任务,带文件,等待确认 |
| 内容包 | POST /content/generate | tools:contentgen | 任务 |
| 房源文案 | POST /text/generate | tools:text | 任务 |
| 照片生成视频 | POST /video/create | tools:video | 任务,带文件 |
| 数字人视频 | POST /avatar/video | tools:avatar | 任务 |
| 照片优化 | POST /photo/enhance | tools:photo | 任务,带文件 |
| 户型图清理 | POST /floorplan/create | tools:floorplan | 立即(202 已包含结果),带文件 |
| 房源落地页 | POST /site/create | tools:sitegen | 立即 |
| PDF 演示文稿 | POST /pdf/create | tools:pdf | 任务 |
| 个人传单 | POST /flyer/create | tools:flyer | 立即 |
| 从文件生成草稿 | POST /draft/extract | tools:draft | 立即,带文件 |
各工具的字段、示例和错误:
工具作为输入使用的 ID(声音、数字人、音乐、结束语)以及当前可用性:参考数据。
发送数据
- JSON:大多数工具,
Content-Type: application/json。 - multipart/form-data:带文件的工具。它们的字段结构不同,这一点很重要:
- 照片优化和草稿:选项作为一个 JSON 字符串放在
data字段中,文件作为单独的部分; - 视频:每个选项都是独立的表单字段(
prompt、length、musicTrackId...),照片作为photos部分; - 报告审核和户型图:文件放在
file部分,选项作为独立字段。
- 照片优化和草稿:选项作为一个 JSON 字符串放在
向需要文件的工具发送 JSON 会得到 400。
响应
- 同步工具返回
200和结果。 - 异步工具返回
202和一个任务;结果通过轮询或 webhook 获取(任务与结果)。 - 生成的文件通过
GET /artifacts/{path}下载。
每个启动工具的请求都请带上 Idempotency-Key(幂等性)。
API 暂不提供
3D 看房和街区市场报告目前仅在后台提供。