Publora — Mastodon

Publora API 的 Mastodon / Fediverse 平台能力。有关认证、核心调度、媒体上传以及工作区（workspace）/Webhook 文档，请参阅 publora 核心能力文档。

基础 URL： https://api.publora.com/api/v1
请求头（Header）： x-publora-key: sk_YOUR_KEY
平台 ID 格式： mastodon-{accountId}

注意： Publora 当前仅向 mastodon.social 实例发布内容。其他实例暂不支持。

平台限制（API 级别）

发布一条 Toot（纯文本）

await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    content: 'Hello Fediverse! Building open, decentralized tools for everyone. #fediverse #opensource',
    platforms: ['mastodon-123456789']
  })
});

定时发布一条 Toot

body: JSON.stringify({
  content: 'Your Mastodon post here',
  platforms: ['mastodon-123456789'],
  scheduledTime: '2026-03-20T10:00:00.000Z'
})

带图片发布 Toot

import requests

HEADERS = { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' }

# 步骤 1：创建帖子
post = requests.post('https://api.publora.com/api/v1/create-post', headers=HEADERS, json={
    'content': 'Here is a photo from our event 📷 #community',
    'platforms': ['mastodon-123456789']
}).json()

# 步骤 2：获取上传 URL（单文件上限 16 MB，支持 JPEG/PNG/GIF/WebP）
upload = requests.post('https://api.publora.com/api/v1/get-upload-url', headers=HEADERS, json={
    'postGroupId': post['postGroupId'],
    'fileName': 'photo.jpg',
    'contentType': 'image/jpeg',
    'type': 'image'
}).json()

# 步骤 3：执行上传
with open('photo.jpg', 'rb') as f:
    requests.put(upload['uploadUrl'], headers={'Content-Type': 'image/jpeg'}, data=f)

平台特性说明

• 仅支持 mastodon.social — Publora 当前仅适配该实例
• 宽松的图片大小限制：单图最高支持 16 MB，远超多数平台标准
• 视频以文件大小为限（默认约 99 MB）— 无显式时长限制
• 原生支持 WebP — 与 Instagram 不同，Mastodon 可直接接收 WebP 图片
• 联邦机制（Federation）：发布内容将自动同步至更广泛的 Fediverse 网络
• 话题标签（Hashtags）：对 Mastodon 上的内容发现至关重要，请在帖子中合理使用
• 内容警告（Content Warnings）：当前 Publora API 尚未直接支持；如需启用，可采用文本约定方式（例如在正文开头添加 CW: …）