# 使用 SosoAPI 排程 Threads 文字与图片帖子

标准 URL： https://sosoapi.ai/zh-hans/docs/threads-api-publishing

为一个已连接 Threads 账号排程文字或图片帖子，然后检查是否已上线。示例使用占位符，不会从本页执行。发布契约审核于 2026年十月20日。

## 1. 链接并检查目标

在 SosoAPI 中连接目标 Threads 账号。平台同意需要 threads_content_publish 才能发布。SosoAPI 调用方还需获允许的工作区、editor 访问权限及 agent:publish 能力才能排程。

确认 SosoAPI 返回的是你预期使用的 Threads 账号。排程前，请使用内容与时间执行完整草稿资格检查。回复、地点及跨平台分享等功能另有权限与资格要求。

- [检查平台能力矩阵](https://sosoapi.ai/zh-hans/docs/publishing-capabilities)

## 2. 排程已审核的文字帖子

使用 API 参考中的服务器辅助函数，替换占位符，并选择带偏移量的未来 ISO-8601 时间。运行此请求会创建真实排程，因此发送前请确认账号、措辞和时间。

TEXT 帖子的 media 请留空。此请求请维持同一个幂等键，并存储返回的 post.id，以便检查状态。此账号请使用 Threads provider_payload。

```
await sosoPost("/studio-api/scheduled-posts/create", {
  "workspace_id": "<workspace-uuid>",
  "social_account_id": "<threads-account-uuid>",
  "caption": "A reviewed update from our team.",
  "hashtags": [],
  "media": [],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {
      "post_type": "TEXT"
    }
  },
  "scheduled_at": "<future-ISO-8601-instant-with-offset>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<stable-key-for-this-one-intent>"
});
```

- [发布 API 参考](https://sosoapi.ai/zh-hans/docs/publishing-api-reference)

## 3. 使用已就绪且已登记的图片

本地图片使用 sosoapi_upload_asset。公共图片 URL 则调用 sosoapi_import_asset_url，并检查 sosoapi_get_asset_import_status 直到就绪。在帖子中使用已登记素材的 ID 和规范 URL。

一般创建请求请将 post_type 设为 IMAGE，并将已就绪图片加入 media。下列片段会替换文字示例中的这两个字段。保留文案、账号与时间，并为这篇新确认的帖子使用新的固定键。

- 请将 asset_id 替换为实际正整数，不要使用数字字串。

- 不要使用来源 URL、暂时预览 URL 或尚未完成的导入来排程。

- 只有使用权、工作区 及所选内容都合适时，才能重复使用同一张素材库图片。

```
{
  "media": [{
    "kind": "image",
    "asset_id": "<ready-image-asset-id-as-number>",
    "url": "<canonical-image-asset-url>"
  }],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {"post_type": "IMAGE"}
  }
}
```

## 4. 验证发布并避免重复发送

读取原始排程帖子并检查最终发布结果。ID、已接受排程或 Threads 媒体容器，只代表请求存在，不代表已发布。可获取时，请显示平台帖子 ID 或永久链接。

如果 Threads 仍在处理，或你遗失响应，请持续检查同一篇帖子。不要改用其他键再发送创建请求。重新链接账号无法证明先前的写入是否成功。

Threads 开始发布文字帖子后，平台步骤可能已无法复原。请依 SosoAPI 返回的可用操作处理，不要重新发送帖子。处理时间可能不同。

- [与 Claude Code 或 Codex 一起审核](https://sosoapi.ai/zh-hans/docs/claude-code-codex-social-publishing)

- [发布 API 参考](https://sosoapi.ai/zh-hans/docs/publishing-api-reference)