API

所有文件都在 R2（faishion-ai-staging，公开地址 https://staging.cdn.faishion.ai/）。新文件一律经过素材库上传，这样谁传了什么、是什么，都有记录。每个请求都要带钥匙：Authorization: Bearer dam_…。

上传一个文件

curl -H "Authorization: Bearer $DAM_KEY" \
  -F file=@look.jpg -F category=look -F brand=rollcall \
  -F title="复古学院风叠穿" -F visibility=PUBLIC \
  https://dam.faishion.ai/api/assets

可选字段：key（自己定对象路径，例如 2b-growth/v1/uniqlo/looks/A-1.jpg；不填就自动生成）、group、subtitle、description、keywords、note、flags（逗号隔开：tbc 待确认 / draft 草稿 / test 测试案例）、tags、source、externalRef（你自己的 ID；同一个 source + externalRef 再传会原地替换）、thumb=0（不做小图）、meta（JSON）。返回素材信息，其中 url 是 CDN 地址、thumbUrl 是小图。

查找

curl -H "Authorization: Bearer $DAM_KEY" "https://dam.faishion.ai/api/assets?q=RL26WJK15&category=look&brand=rollcall&limit=50"
curl -H "Authorization: Bearer $DAM_KEY" "https://dam.faishion.ai/api/assets/<id>"
curl -H "Authorization: Bearer $DAM_KEY" "https://dam.faishion.ai/api/assets/by-ref?source=studio:prod&ref=<你的 ID>"

筛选：q（标题、副标题、搜索词、key、文件名）、category、brand、flag、tag、source（结尾加 * 按前缀）、visibility；翻页用返回的 next 作 cursor。

登记 R2 里已经有的文件（不重新上传）

curl -H "Authorization: Bearer $DAM_KEY" -H "content-type: application/json" \
  -d '[{"key":"2b-growth/v1/rollcall/looks/RL26WJK05-1.jpg","category":"look","brand":"rollcall","title":"…"}]' \
  https://dam.faishion.ai/api/assets/register

改信息、删除

curl -X PATCH -H "Authorization: Bearer $DAM_KEY" -H "content-type: application/json" \
  -d '{"title":"新标题","flags":["tbc"]}' https://dam.faishion.ai/api/assets/<id>
curl -X DELETE -H "Authorization: Bearer $DAM_KEY" "https://dam.faishion.ai/api/assets/<id>?purge=1"   # 管理钥匙；purge=1 连 R2 里的文件一起删

分享

https://dam.faishion.ai/a/<id> 跳到文件本身，要先登录素材库或带钥匙，适合在团队内部发。公开文件的 CDN 地址可以直接用在官网和社媒上。

钥匙

只读、读写、管理三种。团队共用的钥匙写在飞书「fAIshion Studio — 团队上手」文档里；服务（Studio、2b-growth 脚本）各用自己的钥匙，作废一把不影响别的。管理钥匙在 钥匙 页发。