ComfyUI Extension: ComfyUI-Thread

Authored by dseditor

Created

Updated

3 stars

A ComfyUI custom node package for seamless integration with Threads (Meta's social platform). This package allows you to publish posts, manage images, and retrieve post history directly from your ComfyUI workflows.

Custom Nodes (0)

    README

    ComfyUI-Thread

    A ComfyUI custom node package for seamless integration with Threads (Meta's social platform). This package allows you to publish posts, manage images/videos, and retrieve post history directly from your ComfyUI workflows.

    ComfyUI 的 Threads 整合自定義節點包，讓您能夠直接在 ComfyUI 工作流程中發布貼文、管理圖片/影片和獲取發文歷史。

    完整功能參考: 本節點為實現發布的簡要功能，包括文字，圖片、影片與多圖片容器，需要自訂ComfyUIHTTPS網址，如使用ngrok，若需要設定更完整的發布節點包括使用圖床金鑰、臨時伺服器與權杖管理測試，請參考 ComfyUI Threads Uploader

    Features | 功能特色

    🚀 Post Publishing | 發文功能

    • ✅ Text-only posts | 純文字發文
    • ✅ Single image posts | 單圖發文
    • ✅ Multi-image carousel posts | 多圖輪播發文
    • ✅ Video posts with smart path detection | 支援影片發文及智能路徑檢測
    • ✅ Image tensor support (from ComfyUI generators) | 支援圖片張量（來自 ComfyUI 生成器）
    • ✅ External image/video URL support | 支援外部圖片/影片網址
    • ✅ Local video file processing | 支援本地影片檔案處理

    📊 Analytics | 數據分析

    • ✅ Retrieve post history | 獲取發文歷史
    • ✅ Customizable date range (1-365 days) | 可自訂日期範圍（1-365天）
    • ✅ Formatted post content output | 格式化的貼文內容輸出

    ⚙️ Configuration | 配置管理

    • ✅ Long-lived access token management | 長期訪問令牌管理
    • ✅ Custom ComfyUI URL support | 支援自訂 ComfyUI 網址
    • ✅ Automatic configuration persistence | 自動配置持久化
    • ✅ Intelligent media processing | 智能媒體處理

    Installation | 安裝方式

    Using ComfyUI Manager | 使用 ComfyUI Manager 安裝

    1. Open ComfyUI Manager | 開啟 ComfyUI Manager
    2. Search for ComfyUI-Thread | 搜尋 ComfyUI-Thread
    3. Install the package | 安裝套件
    4. Restart ComfyUI | 重啟 ComfyUI

    Manual Installation | 手動安裝

    cd ComfyUI/custom_nodes/
git clone https://github.com/your-repo/ComfyUI-Thread.git
pip install -r ComfyUI-Thread/requirements.txt

    Setup | 設置

    1. Get Threads API Credentials | 獲取 Threads API 憑證

    You need to obtain the following from Meta Developers: 您需要從 Meta 開發者平台獲取以下資訊：

    • USER_ID - Your Threads user ID | 您的 Threads 用戶 ID
    • ACCESS_TOKEN - Short-lived access token | 短期訪問令牌
    • APP_SECRET - Your app secret | 您的應用密鑰

    參考資源: 有關憑證的取得方式，可以參考 SDK 的開發者網址，同時你也必須安裝 requirements.txt 中的 SDK： https://nijialin.com/2024/08/17/python-threads-sdk-introduction/

    2. Configure API Access | 配置 API 訪問

    Use the Start With Long Live Token node with your credentials to generate a long-lived access token.

    使用 Start With Long Live Token 節點輸入您的憑證來生成長期訪問令牌。

    Nodes | 節點說明

    📝 Start With Long Live Token

    Initialize the Threads API connection and generate a long-lived access token.

    初始化 Threads API 連接並生成長期訪問令牌。

    Inputs | 輸入:

    • USER_ID - Your Threads user ID | 您的 Threads 用戶 ID
    • ACCESS_TOKEN - Short-lived access token | 短期訪問令牌
    • APP_SECRET - Your app secret | 您的應用密鑰

    Outputs | 輸出:

    • result - Configuration status message | 配置狀態訊息

    Note | 注意: 成功後會在 token 資料夾下產生一個 thread_config.json 檔案。

    📤 Publish Thread

    Publish posts to Threads with text and images, supporting single images and multi-image carousels.

    發布包含文字和圖片的 Threads 貼文，支援單圖和多圖輪播。

    Inputs | 輸入:

    • text (required) - Post content | 貼文內容（必填）
    • ComfyUIHttpsURL (optional) - Custom ComfyUI base URL | 自訂 ComfyUI 基礎網址（選填）
    • image (optional) - Image tensor input | 圖片張量輸入（選填）
    • image_url (optional) - External image URLs, one per line | 外部圖片網址，每行一個（選填）

    Outputs | 輸出:

    • result - Post status and URL | 發文狀態和網址

    Features | 特色功能:

    • Supports single and multiple images | 支援單圖和多圖
    • Automatic carousel creation for multiple images | 多圖時自動創建輪播
    • Image tensor processing with batch support | 支援批次圖片張量處理

    🎬 Thread Publish Video

    Publish video posts to Threads with intelligent path detection and media container status monitoring.

    發布影片貼文到 Threads，具備智能路徑檢測和媒體容器狀態監控。

    Inputs | 輸入:

    • text (required) - Post content | 貼文內容（必填）
    • video_path (required) - Video path or URL | 影片路徑或網址（必填）
    • ComfyUIHttpsURL (optional) - Custom ComfyUI base URL | 自訂 ComfyUI 基礎網址（選填）

    Outputs | 輸出:

    • result - Post status and URL | 發文狀態和網址

    Smart Path Detection | 智能路徑檢測:

    • Network URL: Automatically detected if starts with http:// or https:// | 網路網址：以 http:// 或 https:// 開頭時自動檢測
    • Local Path: All other inputs treated as local file paths | 本地路徑：其他輸入均視為本地檔案路徑

    Media Processing | 媒體處理:

    • Automatic file copying to ComfyUI output directory | 自動複製檔案到 ComfyUI 輸出目錄
    • Status monitoring every 20 seconds | 每 20 秒檢查狀態
    • Support for common video formats (MP4, MOV, AVI, etc.) | 支援常見影片格式
    • File size validation (max 1GB) | 檔案大小驗證（最大 1GB）

    📈 Threads History

    Retrieve your post history from Threads with customizable date ranges.

    從 Threads 獲取您的發文歷史，可自訂日期範圍。

    Inputs | 輸入:

    • backfill_days - Number of days to look back (1-365) | 回溯天數（1-365）

    Outputs | 輸出:

    • history_content - Formatted post history | 格式化的發文歷史

    Usage Examples | 使用範例

    Example Workflow | 範例工作流

    範例工作流使用了 ollama-gemini 節點來產生圖文提示內容，此節點需自行配置 API 金鑰才能使用 Gemini： https://github.com/al-swaiti/ComfyUI-OllamaGemini

    有關圖像生成模型的部分，可以修改為你自己常用的模型與節點。

    Simple Text Post | 簡單文字發文

    1. Configure Start With Long Live Token with your API credentials | 使用 API 憑證配置令牌節點
    2. Connect Publish Thread and enter your text content | 連接發文節點並輸入文字內容
    3. Execute to post | 執行發文

    Image Post with Generated Content | 使用生成內容的圖片發文

    1. Create images using ComfyUI generators | 使用 ComfyUI 生成器創建圖片
    2. Connect image output to Publish Thread image input | 將圖片輸出連接到發文節點的圖片輸入
    3. Add your text content | 添加文字內容
    4. Execute to post with generated images | 執行以發布包含生成圖片的貼文

    Note | 注意: 支援 ImageBatch/BatchSize，不支援 ImageList 做為容器。可將多張圖片使用 MakeImageBatch 後上傳。

    Video Post | 影片發文

    1. Configure Thread Publish Video with your content | 配置影片發文節點
    2. Enter video path (local file or URL) | 輸入影片路徑（本地檔案或網址）
    3. Add your text content | 添加文字內容
    4. Execute and wait for processing | 執行並等待處理完成

    Multi-Image Carousel | 多圖輪播

    1. In Publish Thread, enter multiple image URLs in image_url field (one per line) | 在發文節點的圖片網址欄位輸入多行 HTTPS 網址
    2. Add your text content | 添加文字內容
    3. Execute to create a carousel post | 執行創建輪播貼文

    Analyze Post History | 分析歷史貼文

    1. Use Threads History to retrieve recent posts | 使用歷史節點獲取近期貼文
    2. Set backfill_days to desired time range | 設定回溯天數
    3. Review formatted output for content analysis | 查看格式化輸出進行內容分析

    File Structure | 檔案結構

    ComfyUI-Thread/
├── __init__.py              # Module initialization | 模組初始化
├── nodes.py                 # Main node implementations | 主要節點實作
├── requirements.txt         # Python dependencies | Python 相依性
└── token/                   # Auto-generated config directory | 自動生成的配置目錄
    ├── thread_config.json   # API credentials | API 憑證
    └── url.json            # ComfyUI URL configuration | ComfyUI 網址配置

    Requirements | 系統需求

    • ComfyUI
    • Python 3.8+
    • PIL (Pillow)
    • numpy
    • torch
    • requests
    • threads_sdk

    API Limitations | API 限制

    • Scope: Only works with your own Threads account | 僅適用於您自己的 Threads 帳號
    • Rate Limits: Subject to Meta's API rate limits (250 posts per 24 hours) | 受 Meta API 速率限制約束（24小時內250則貼文）
    • Video Requirements: Follows Threads' strict video format requirements | 遵循 Threads 嚴格的影片格式要求
    • Image Requirements: Must be publicly accessible URLs or properly configured HTTPS | 圖片必須是可公開存取的網址或正確配置的 HTTPS

    Configuration Notes | 配置說明

    ComfyUI HTTPS URL | ComfyUI HTTPS 網址

    • 此網址必須使用 ngrok 等建立 HTTPS 對外的網址
    • 填入一次之後會記憶在 url.json 檔案中
    • 網址變更時才需要重新填寫
    • 沒有填過則預設為 127.0.0.1，image 節點會無法傳圖只能使用網址

    Troubleshooting | 疑難排解

    Common Issues | 常見問題

    "Please execute StartWithLongLiveToken node first"

    • Make sure you've run the token configuration node before posting
    • 確保在發文前已執行令牌配置節點

    "Param image_url is not a valid URL"

    • Check that your image URLs are complete and accessible
    • Ensure URLs start with https://
    • 檢查圖片網址是否完整且可存取

    Image not displaying in posts | 發送成功圖片無法顯示，只有文字

    • Verify your ComfyUI URL is accessible from the internet
    • Check the ComfyUIHttpsURL configuration
    • 確認您的 ComfyUI 網址可從網際網路存取

    Video processing timeout | 影片處理超時

    • Check video file size (max 1GB)
    • Verify video format compatibility
    • Ensure stable internet connection
    • 檢查影片檔案大小（最大 1GB）
    • 確認影片格式相容性

    Local video file not found | 本地影片檔案未找到

    • Verify the file path is correct
    • Check file permissions
    • Ensure the file exists and is accessible
    • 確認檔案路徑正確
    • 檢查檔案權限

    License | 授權

    MIT License

    Support | 支援

    If you encounter any issues or have questions, please open an issue on GitHub.

    如果您遇到任何問題或有疑問，請在 GitHub 上開啟 issue。

    Note: This project is not officially affiliated with Meta or Threads. Use responsibly and in accordance with Threads' Terms of Service.

    注意：此專案與 Meta 或 Threads 無官方關聯。請負責任地使用並遵守 Threads 的服務條款。