Docs

文件与结果

最后更新: 2026-09-07阅读约 3 分钟

两类文件操作：把图片上传到 GREM 以便附加到房源上，以及取回工具生成的成品。

基础地址：https://developers.grem.capital/api/v1。

上传图片

curl -X POST https://developers.grem.capital/api/v1/uploads \
  -H "Authorization: Bearer gsk_live_xxx" \
  -F "file=@photo.jpg"

{ "files": [ { "id": "…", "url": "…" } ], "requestId": "req_…" }

需要 media:write 权限范围。上传不计费。

限制：

参数数值
格式JPG、PNG、WEBP
单个文件不超过 15 MB
每次请求的文件数最多 10 个
整个请求不超过 30 MB

表单中的字段名不重要 — 在限额内想发多少个文件片段都可以。

返回的 id 在创建或编辑房源时填入 photos 字段：

{ "photos": ["<first file id>", "<second file id>"] }

您上传的原图只有您自己能看到。照片一旦附加到房源上，外部读者只会看到带水印的版本。

取回生成的结果

工具返回的文件链接是相对路径。用同一个密钥通过 GREM 的域名下载：

curl -H "Authorization: Bearer gsk_live_xxx" \
  https://developers.grem.capital/api/v1/artifacts/<path from the response> \
  -o presentation.pdf

需要 tools:artifacts 权限范围。下载是 GET 请求，因此免费，也不计入 API 调用次数。

支持通过 Range 请求头分段下载：较大的视频和演示文档可以分块拉取，或在中断后续传。

这里同样需要密钥：产物链接并非公开。不要把它嵌入访客可以打开的页面 — 请改由您自己的服务器提供该文件。

任意路径都不会奏效：只接受由工具响应给出的地址，其余一律返回 404。

相关文章

这篇文章对您有帮助吗？