Docs

通过 API 使用工具

最后更新: 2026-10-02阅读约 3 分钟

后台中的工具同样可以通过编程方式使用。工具的价格与后台相同,另加一次 API 调用(限制与计费)。基础地址:https://developers.grem.capital/api/v1。

列表

工具请求权限范围运行方式
快速估价POST /valuation/expresstools:valuation立即
完整估价报告POST /valuation/reporttools:valuation任务
租金估算POST /valuation/renttools:rent立即
报告审核POST /valuation/reviewtools:review任务,带文件,等待确认
内容包POST /content/generatetools:contentgen任务
房源文案POST /text/generatetools:text任务
照片生成视频POST /video/createtools:video任务,带文件
数字人视频POST /avatar/videotools:avatar任务
照片优化POST /photo/enhancetools:photo任务,带文件
户型图清理POST /floorplan/createtools:floorplan立即(202 已包含结果),带文件
房源落地页POST /site/createtools:sitegen立即
PDF 演示文稿POST /pdf/createtools:pdf任务
个人传单POST /flyer/createtools:flyer立即
从文件生成草稿POST /draft/extracttools:draft立即,带文件

各工具的字段、示例和错误:

工具作为输入使用的 ID(声音、数字人、音乐、结束语)以及当前可用性:参考数据。

发送数据

  • JSON:大多数工具,Content-Type: application/json。
  • multipart/form-data:带文件的工具。它们的字段结构不同,这一点很重要:
    • 照片优化和草稿:选项作为一个 JSON 字符串放在 data 字段中,文件作为单独的部分;
    • 视频:每个选项都是独立的表单字段(prompt、length、musicTrackId ...),照片作为 photos 部分;
    • 报告审核和户型图:文件放在 file 部分,选项作为独立字段。

向需要文件的工具发送 JSON 会得到 400。

响应

  • 同步工具返回 200 和结果。
  • 异步工具返回 202 和一个任务;结果通过轮询或 webhook 获取(任务与结果)。
  • 生成的文件通过 GET /artifacts/{path} 下载。

每个启动工具的请求都请带上 Idempotency-Key(幂等性)。

API 暂不提供

3D 看房和街区市场报告目前仅在后台提供。

相关文章

这篇文章对您有帮助吗?