# 使用 SosoAPI 排程 Threads 文字與圖片貼文

標準 URL： https://sosoapi.ai/zh-tw/docs/threads-api-publishing

為一個已連結 Threads 帳號排程文字或圖片貼文，然後檢查是否已上線。範例使用預留位置，不會從本頁執行。發布契約審核於 2026 年十月 20 日。

## 1. 連結並檢查目標

在 SosoAPI 中連結目標 Threads 帳號。平台同意需要 threads_content_publish 才能發布。SosoAPI 呼叫端還需獲允許的工作空間、editor 存取權限及 agent:publish 能力才能排程。

確認 SosoAPI 回傳的是您預期使用的 Threads 帳號。排程前，請使用內容與時間執行完整草稿資格檢查。回覆、地點及跨平台分享等功能另有權限與資格要求。

- [檢查平台能力對照表](https://sosoapi.ai/zh-tw/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-tw/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 或尚未完成的匯入來排程。

- 只有使用權、Workspace 及所選內容都合適時，才能重複使用同一張素材庫圖片。

```
{
  "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-tw/docs/claude-code-codex-social-publishing)

- [發布 API 參考資料](https://sosoapi.ai/zh-tw/docs/publishing-api-reference)