Docs

文件

最后更新: 2026-10-03阅读约 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 "[email protected]"

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

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

限制：

参数值
格式JPG、PNG、WEBP
单个文件最大 15 MB；更大返回 413
每个请求的文件数最多 10 个
整个请求最大 30 MB

表单字段名称无关紧要：在限制范围内发送任意数量的文件部分。

创建或编辑房源时，把返回的 id 放入 photos（房源）；在工具接受照片地址的地方使用 url（内容包，form.media.photos）：

{ "photos": ["<第一个文件的 ID>", "<第二个文件的 ID>"] }

只有您能获得原图链接。照片附加到已发布的房源后，目录只向其他人提供带水印的变体。

下载结果

使用同一个密钥通过 GREM 域名下载文件：

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

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

支持通过 Range 请求头分段下载：大型视频和演示文稿可以分段获取或断点续传。

这里同样需要密钥：结果链接不是公开的。不要把它嵌入访客可见的页面，请从您自己的服务器提供文件。

不能传入任意路径：只接受结果下载路径和 /files/... 文件，其他一律返回 404。完整路径列表见任务与结果。

相关文章

这篇文章对您有帮助吗？