媒体 APIAPI
上传一次，随处发布
把文件发送到媒体库，拿回一个 id。把这个 id 附加到任意数量的帖子，FoPost 会按每个网络需要的形式转换并投递。存储是私有的，并限定在工作区内。
POST /v1/media/upload
curl -X POST "https://api.fopost.com/v1/media/upload?workspace_id=9b2f6c1e-..." \
-H "X-API-Key: $API_KEY" \
-F "[email protected]"
{
"data": [
{
"id": "e5a1c9d4-...",
"type": "image",
"name": "launch.png",
"url": "https://.../launch.png",
"preview_url": "https://api.fopost.com/v1/media/e5a1c9d4-.../file",
"size": 412883
}
]
}分段上传
最大 50 MB 的图片和视频，按内容校验，而不只看扩展名。
按 id 复用
上传一次，可用于任意数量的帖子。文件绝不会发送两次。
默认私有
文件存放在私有存储中，只对工作区成员提供。
附加到帖子
curl -X POST https://api.fopost.com/v1/posts \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": "9b2f6c1e-...",
"content": [{ "text": "Launch day.", "media": [{ "type": "image", "name": "launch.png", "url": "https://.../launch.png" }] }],
"accounts": ["4a71d80b-..."]
}'图片
PNG、JPEG、GIF 和 WebP，上传时读取类型和大小。
视频
MP4 和 MOV，发布时按每个网络检查时长和大小。
经过校验
文件的真实内容必须与其类型一致，否则上传会被拒绝。
投递
每个网络的正确格式，替你搞定
各网络对宽高比、大小和编码的要求各不相同。发布时，每个适配器会取出存储的原始文件，上传该平台接受的版本，因此同一个媒体库素材在轮播、帖子串和短视频信息流中都能用。
了解投递的工作方式
按网络的规则
大小和格式限制由适配器处理，而不是你。
有序媒体
内容块中的顺序就是轮播的顺序。
明确的失败
网络无法接受的文件只会让该次投递失败并说明原因，而不是整条帖子。
管理
浏览、获取并复用媒体库
用筛选条件列出媒体库，通过文件端点获取任意素材，该端点每次请求都会检查工作区成员身份且永不过期，同一个 id 可被任意多的帖子引用。品牌素材、导入内容和生成的图片都汇入同一个媒体库。
开始构建GET /v1/media
curl "https://api.fopost.com/v1/media?workspace_id=9b2f6c1e-...&type=image" \
-H "X-API-Key: $API_KEY"
# Fetch the file itself
curl -L "https://api.fopost.com/v1/media/e5a1c9d4-.../file" \
-H "X-API-Key: $API_KEY" -o launch.png列出与筛选
按类型、来源或品牌角色筛选，支持分页。
稳定的文件 URL
/v1/media/:id/file always works for members; no signed links to refresh.
按工作区隔离
一个密钥只能看到一个工作区的媒体库，别无其他。
关于 媒体 API 的常见问题解答
大小限制是多少？
每个文件 50 MB。各网络有自己的上限，会在帖子投递到该网络时检查。
接受哪些格式？
常见图片格式（PNG、JPEG、GIF、WebP）和视频格式（MP4、MOV）。上传时会检查文件的实际字节，因此改了扩展名的文件会被拒绝。
一个媒体 id 可以附加到多条帖子吗？
可以，这正是媒体库的意义所在。上传一次，就能在工作区的任何帖子中引用这个 id。
上传的文件是公开的吗？
不是。存储是私有的。文件端点每次请求都会检查工作区成员身份，网络只在发布时收到一个短时有效的链接。
会占用配额吗？
会。每个账号都包含免费存储额度，超出部分在绑定银行卡后按每 GB 每月计量。每次上传、导入和生成的图片都以同样方式计入。
可以从 URL 或设计工具导入吗？
可以。导入内容进入同一个媒体库并带有来源引用，你可以原地重新拉取更新后的设计，而不必上传新文件。