发布帖子

创建 Publication → Post[]写入Unified即将推出

一个请求，发到 TikTok、Instagram、YouTube 和另外六个平台。每个平台各自返回结果，只有成功上线的帖子才收费。发帖到 X 现在就能用，走 AIsa X actions 的 Direct API。

一个请求，发到所有平台

只写一次，每个平台各自返回结果

文字、素材、目标账号和发布时间是共用的。只有某个平台才有的设置放在它自己的前缀下，比如 tiktok.privacy 或 instagram.format。任何账号都可以单独配一条更短的文案。

个平台
9
失败或在预检中被拦下
$0
每条成功上线的帖子
[$Z]
{
  "tool": "social.publications.create",
  "arguments": {
    "text": "Our 3-in-1 travel charger is here.",
    "media": ["med_7Hq2Lw"],
    "targets": [
      { "account": "tiktok:acme.home" },
      { "account": "instagram:acme.home",
        "instagram": { "format": "reels" } },
      { "account": "youtube:acmehome" },
      { "account": "x:acme_home",
        "text": "3-in-1 charger, out now." }
    ],
    "when": { "at": "2026-10-03T09:00:00-07:00" },
    "approval": "required",
    "idempotency_key": "launch-charger-01"
  }
}
用草稿试一试

每个目标账号各自返回结果

示例 · 虚构品牌 Acme Home

pub_01JB8W3K部分已发布
6 个中 3 个已上线 · 计费 3 条
账号形式状态结果计费
TikToktiktok:acme.home视频已发布tiktok:[post id]太平洋时间 09:00 上线计费
Instagraminstagram:acme.homeReels已发布instagram:[post id]太平洋时间 09:00 上线计费
Xx:acme_home文字 + 视频已发布x:[post id]用了更短的文案计费
YouTubeyoutube:acmehomeShorts发布中—上传处理中—
LinkedInlinkedin:acme-home视频已排期—下一个空档，太平洋时间 11:00—
Pinterestpinterest:acmehome视频 Pin失败connection_expired你可以修复：重新连接，再重试这个目标不计费

一个 Publication 的状态有：草稿、已排期、发布中、已发布、部分已发布、失败、已撤回。用同一个幂等键只重试失败的目标，不会重复发帖。

从连接到发出

  1. 01 · Connection

    连接一次

    账号所有者向 AIsa 授权。授权范围、状态和到期时间都可以读取，快过期时会提醒。

  2. 02 · Preflight

    发之前先检查

    长度、素材大小、形式和账号类型，逐个对照各平台的要求检查。没通过不收费。

  3. 03 · Approval

    先经人审批

    发布、删除和私信都可以等人审批后再执行。AI 运营员工默认开启。

  4. 04 · Publication

    立即发，或排队

    立即发、定时发、排进下一个空档，或者先存为草稿。时区始终写明。

  5. 05 · Event

    接收通知

    每条帖子上线或失败、有新的评论和私信、连接快要过期，都会通过 Webhook 通知你。

计划提供 9 个调用即将推出

我们自己拟的第一版路径，尚未评审。每个调用通过你授权的 Connection 作用于所列平台，目前都还没有部署。

  • POST/v1/social/publications把一条内容发往多个账号：立即、定时或排进队列全部 9 个社媒平台草稿
  • POST/v1/social/publications/precheck按各平台规则预检字数、素材和账号类型全部 9 个社媒平台草稿
  • GET/v1/social/publications/{publicationId}读取一个 Publication 及它在各平台上的状态全部 9 个社媒平台草稿
  • GET/v1/social/publications草稿、已排期和已发出的 Publication全部 9 个社媒平台草稿
  • PUT/v1/social/publications/{publicationId}修改草稿或已排期的 Publication全部 9 个社媒平台草稿
  • POST/v1/social/publications/{publicationId}/retry重试发送失败的平台全部 9 个社媒平台草稿
  • DELETE/v1/social/publications/{publicationId}删除草稿或取消定时发送全部 9 个社媒平台草稿
  • POST/v1/social/publications/bulk-upload从 CSV 文件批量新建 Publication全部 9 个社媒平台草稿
  • GET/v1/social/platforms可以发布的平台及各自的限制全部 9 个社媒平台草稿

每个平台允许做什么

这张表本身也是一个接口，随平台变化更新版本：GET /v1/social/platforms

平台发布评论和私信你自己的数据状态
X文字、图片、视频、串推、投票评论；私信即将推出支持已上线
TikTok视频评论；私信仅回复支持即将推出
Instagram帖子、Reels、Stories、轮播评论、私信支持即将推出
Facebook 主页文字、图片、视频、Reels评论、私信、主页评价支持即将推出
YouTube视频、Shorts评论支持即将推出
LinkedIn文字、图片、视频、文档公司主页的评论支持即将推出
Pinterest图片 Pin、视频 PinPinterest 不提供支持即将推出
Threads文字、图片、视频评论支持即将推出
Reddit文字、图片、视频、链接评论、私信有限即将推出

错误码写明谁能修复

错误码由 AIsa 自己定义。上游的错误码和报错信息不会传给你，所以平台背后的通道换了，你的代码也不用改。

你可以修复不重试 · 不计费
  • connection_expired
  • content_spec_mismatch
  • account_type_unsupported
平台方自动替你重试
  • platform_rate_limited
  • platform_unavailable
AIsa自动重试 · 费用由我们承担
  • aisa_internal

保护账号安全的防护措施

  • 发帖频率按账号控制在各平台的上限以内。
  • 同一条内容要发到很多账号时，先审核。
  • 新连接的账号从低频开始，逐步提高。
  • 评论和私信按个人数据处理，绝不在客户之间共用。

怎么收费

每个已连接的账号，含它自己的数据
[$] / 月
每条成功上线的帖子
[$Z]
每条评论或私信回复
[$]
X
按 X API 调用计费，单独列价

Agent 可以用 x402 按帖付费，不需要账号或套餐。

搜索目录

平台、Unified 实体、供应商 API、接口和连接器。