Files · 客户使用文档

用户需要准备

准备上传文件，无需另行注册存储服务；分享前确认访问权限。

工作台操作步骤

1. 01创建文件空间。
2. 02选择并上传文件。
3. 03确认访问权限后使用文件 URL。

调用与集成示例

上传 logo.png，并用返回的 URL 在网站显示图片。

# Create a space in the workspace; copy its real SPACE_ID.
curl --fail-with-body -X PUT \
  "$BASE_URL/api/picosvc/files/spaces/$SPACE_ID/object?path=logo.png" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H 'Content-Type: image/png' --data-binary @logo.png
# The JSON response contains publicUrl. Do not upload secrets.

示例包含占位值；请替换 $BASE_URL、$SESSION_TOKEN 和生成的 URL。不要将令牌或 API 密钥发布到网站或仓库。

管理 API 入口

POST /api/picosvc/files/spaces

空间名称、文件与存储路径。

文件 URL 和存储用量。

不支持的功能

每个文件最多 10 MiB；不支持大文件或高级图片处理。

功能比较与资料来源

访问控制与图片处理：小文件上传与 URL 分发。

Supabase Storage：文档介绍公开／私有存储桶、细粒度权限和图片转换。