API 集成

把图片或视频交给 Buffer 排期

先拿到工作台的成品，再用 Buffer 准备或安排社交帖子。两边要分别授权，也要分别检查结果。

约 3 分钟API 接入

下方提示词和代码保留原文。复制后，把示例中的占位值换成自己的资料。

本页目录

开始前 1. 读取已经完成的制作任务 2. 给 Buffer 一个稳定的文件地址 3. 先建草稿 4. 核对草稿，再排期哪些步骤需要自己配置

开始前

准备已完成的制作任务、确认过的配文、支持的 Buffer 频道，以及把素材交给 Buffer 并向目标受众公开的权限。直接调用 Buffer API 时，在 Buffer 的「设置 → API」里申请密钥，单独保存。接口访问取决于账号权限。

当前工作流目录没有原生 Buffer 动作。可以用 n8n、Zapier 衔接，也可以在自己的服务里调用相应接口。

1. 读取已经完成的制作任务

用工作台凭据读原任务：

示例

GET https://api.bsquarerealty.com/v1/workflow-api/media/operations/OPERATION_ID?medium=poster
Authorization: Bearer YOUR_AGENTOS_KEY

视频任务用 medium=video。只在 operation.status 为 succeeded 时继续。从 operation.artifacts 中按 kind、MIME 类型、尺寸和 expiresAt 选对文件。任务 ID、内部素材引用和模板预览地址都不能当作 Buffer 的媒体 URL。

2. 给 Buffer 一个稳定的文件地址

趁链接有效时下载已批准的成品，再上传到有权公开的媒体存储。用文件本身的 HTTPS 直链，确认无需登录就能访问，并且存储允许自动访问。

Buffer 需要在实际发布时还能读取文件。私密分享页或临时下载链接不适合用来排期。上传到公开存储本身就会分享文件。仅使用批准公开的内容，文件、路径、配文和 URL 都不要带密钥或客户个人资料。

相关资料：Buffer 媒体存储要求

3. 先建草稿

如果用 Zapier，连接 Buffer 后看频道当前支持的动作。有草稿或审核模式就先选它。动作叫「Add to Buffer」，不代表只做预览。

直接调用 API 时，用 Buffer 自己的 Bearer 凭据向 https://api.buffer.com 发 GraphQL 请求。示例结合了图片帖和草稿选项。替换成已确认的频道、配文和媒体地址：

              示例
            
mutation PrepareCampaignDraft {
  createPost(input: {
    channelId: "YOUR_VERIFIED_BUFFER_CHANNEL_ID"
    text: "YOUR_APPROVED_CAPTION"
    schedulingType: automatic
    mode: addToQueue
    saveToDraft: true
    assets: [{
      image: { url: "https://YOUR_PUBLIC_MEDIA_HOST/approved-poster.jpg" }
    }]
  }) {
    ... on PostActionSuccess {
      post { id text }
    }
    ... on MutationError {
      message
    }
  }
}

把上面的 mutation 作为 JSON 请求的 query 值：

示例

POST https://api.buffer.com
Authorization: Bearer YOUR_BUFFER_KEY
Content-Type: application/json

在 n8n 用专门给 Buffer 的 HTTP Request 凭据。在 Zapier 用 Buffer 授权连接，或为 api.buffer.com 另建 API by Zapier 连接。不要把工作台密钥发给 Buffer。

发视频时，把图片资源改成视频资源，填获批 MP4 的公开直链。审核期间保留 saveToDraft: true。支持的内容和自动发布方式因社交频道而异。

相关资料：图片请求示例 · 视频请求示例 · 草稿行为说明

4. 核对草稿，再排期

检查 GraphQL 的顶层错误和 MutationError。记下返回的帖子 ID，到 Buffer 打开草稿，核对频道、素材、配文和发布设置。单看 HTTP 200 无法判断 mutation 是否成功。

审核通过后，安排已有草稿发布。入队后还要在 Buffer 确认社交平台的实际发布结果。如果创建结果丢失，先查有没有原帖，再考虑重试 createPost。工作台的 requestKey 不适用于 Buffer。

哪些步骤需要自己配置

工作台密钥接口不会替你上传到公开存储、创建 Buffer 凭据、选频道或发布。缺频道权限时，停在已批准的文件和配文，不要改投其他频道。

2026 年 11 月 9 日核对了工作台源码和 Buffer 官方文档。编写时没有使用 Buffer 凭据、上传、创建草稿或实际发布。