Konfiguracja skryptu publikacji

Aktualizacja Threads\nThreads obsługuje teraz posty tylko tekstowe: content_type = 2. Ta wartość dotyczy wyłącznie Threads; filmy, obrazy i wersje robocze działają bez zmian.\n:::

Ta strona dokumentuje parametry konfiguracyjne dla skryptu post używanego przy tworzeniu zadań.

Przegląd

Skrypt post służy do automatycznego publikowania filmów lub obrazów na TikTok, Instagram lub Threads. TikTok i Instagram obsługują platformowe metody publikowania i opcje dźwięku opisane poniżej; Threads obsługuje posty z podpisami i szkice.

Parametry żądania

Podczas tworzenia zadania można określić następujące parametry najwyższego poziomu:

Parametr	Typ	Wymagany	Domyślnie	Opis
serials	string[]	Warunkowy	[]	Lista numerów seryjnych urządzeń (Tryb 1: oparty na urządzeniu)
usernames	string[]	Warunkowy	[]	Lista nazw użytkowników do tworzenia zadań (Tryb 2: oparty na nazwie użytkownika)
script_name	string	Tak	-	Nazwa skryptu do wykonania (np. "post")
script_config	object	Tak	-	Parametry konfiguracji skryptu (patrz poniżej)
enable_multi_account	boolean	Nie	false	Włącz tryb wielu kont (utwórz zadanie dla każdego konta na urządzeniu)
start_time	string	Nie	-	Opcjonalny czas rozpoczęcia w formacie "HH:MM"
platform	string	Warunkowy*	auto	Platforma docelowa: `tiktok`, `instagram`, `threads`. Zobacz uwagę poniżej

Uwaga: Należy podać serials lub usernames.

*Zachowanie Parametru Platform:

TikMatrix i IgMatrix: Parametr platform jest ignorowany jeśli jest podany. Platforma jest automatycznie określana na podstawie nazwy aplikacji (TikMatrix → tiktok, IgMatrix → instagram).
TikMatrix Pro: Parametr platform jest wymagany i musi być jawnie określony jako tiktok, instagram lub threads.
Threads: obsługuje posty wideo/obrazu, wiele obrazów, podpisy, oba źródła materiałów i save_draft. Threads ignoruje ustawienia dźwięku, produktu, umieszczenia, okładki, etykiety AI, linku do historii i natywnego planowania, ponieważ aplikacja nie udostępnia tych przepływów TikTok/Instagram.

Konfiguracja skryptu (`script_config`)

Obiekt script_config zawiera parametry dla skryptu publikacji. Poniżej znajdują się dostępne parametry:

Wspólne parametry (TikTok, Instagram i Threads)

Parametr	Typ	Wymagany	Domyślnie	Opis
content_type	integer	Nie	0	Typ treści: `0` = Wideo, `1` = Obrazy
image_count	integer	Nie	1	Liczba obrazów do wybrania (gdy content_type = 1)
captions	string	Nie	""	Tekst podpisu do posta. Obsługuje format spintax: `{opcja1\|opcja2\|opcja3}`
caption_format	string	Nie	"multiline"	Sposób obsługi wieloliniowych podpisów: `multiline` (wstawia prawdziwe nowe linie) lub `singleline` (zastępuje `\n` spacjami)
ai_label	boolean	Nie	false	Czy dodać etykietę treści generowanej przez AI do posta
save_draft	boolean	Nie	false	Zapisz post jako szkic zamiast natychmiastowego opublikowania
post_way	string	Nie	"addButton"	Metoda publikacji. Szczegóły znajdziesz w sekcji Metody publikacji poniżej
material_source	string	Nie	"materialLibrary"	Źródło materiału: `materialLibrary` lub `localFolder` (ignorowane, jeśli podano material_list)
material_path	string	Warunkowy	""	Ścieżka do folderu lokalnego (wymagana, gdy material_source = "localFolder")
material_list	string[]	Nie	[]	Tablica bezpośrednich ścieżek plików materiałów. Gdy podana, pomija logikę material_source i material_path. Idealna do automatyzacji API.
materials_tags	string	Nie	""	Tagi materiałów oddzielone przecinkami do filtrowania z biblioteki
upload_wait_time	integer	Nie	10	Sekundy oczekiwania na zakończenie przesyłania
upload_wait_time_min	integer	Nie	-	Dolna granica zakresu oczekiwania. Gdy ustawione są obie granice, skrypt losuje wartość z zakresu dla każdego zadania
upload_wait_time_max	integer	Nie	-	Górna granica zakresu oczekiwania
sound_wait_time	integer	Nie	10	Sekundy oczekiwania na załadowanie dźwięku
sound_wait_time_min	integer	Nie	-	Dolna granica zakresu oczekiwania. Gdy ustawione są obie granice, skrypt losuje wartość z zakresu dla każdego zadania
sound_wait_time_max	integer	Nie	-	Górna granica zakresu oczekiwania
add_sound	string/integer	Nie	"-1"	Opcja dźwięku: `-1` = domyślny, `0` = wyłącz, `1` = włącz, `custom` = użyj niestandardowego dźwięku
sound_name	string	Warunkowy	""	Nazwa/URL dźwięku (wymagana, gdy post_way = "useSound")
custom_sound_keyword	string	Warunkowy	""	Słowo kluczowe do wyszukiwania niestandardowego dźwięku (wymagane, gdy add_sound = "custom")
origin_sound_volume	integer	Nie	100	Głośność oryginalnego dźwięku (0-100)
add_sound_volume	integer	Nie	100	Głośność dodanego dźwięku (0-100)

upload_wait_time dotyczy zarówno zwykłego publikowania, jak i trybu save_draft. Nawet przy zapisie do szkicu TikTok/Instagram nadal potrzebuje czasu, aby dokończyć przesyłanie filmu w tle.

upload_wait_time i sound_wait_time przyjmują także zakres: wyślij upload_wait_time_min / upload_wait_time_max (lub sound_wait_time_min / sound_wait_time_max), a skrypt wylosuje nową wartość z tego zakresu dla każdego zadania, dzięki czemu zadania nie czekają tyle samo sekund. Gdy obie granice są obecne, zakres ma pierwszeństwo; w przeciwnym razie używany jest klucz z pojedynczą wartością.

Metody publikacji (`post_way`)

Parametr post_way określa, w jaki sposób skrypt otwiera ekran publikacji:

Wartość	Opis
`addButton`	(Domyślne) Klika przycisk tworzenia "+" w aplikacji, a następnie wybiera multimedia z galerii urządzenia. Działa ze wszystkimi miejscami publikacji (`reel`, `story`, `post`). Zalecane w większości przypadków.
`share`	Wywołuje intencję udostępniania Androida bezpośrednio z pliku multimedialnego do aplikacji Instagram/TikTok. To alternatywna metoda omijająca nawigację w aplikacji; przydatna, gdy przepływ `addButton` jest zawodny na danym urządzeniu lub w danej wersji aplikacji.
`useSound`	Najpierw przechodzi do określonej ścieżki audio (przez adres URL lub słowo kluczowe `sound_name`), a następnie dołącza wideo do tego dźwięku. Tylko dla Reels / TikTok. Wymaga ustawienia `sound_name`. Nie jest kompatybilne z `placement = "post"` ani `placement = "story"`.

notatka

Gdy placement ma wartość post (post w aktualnościach na Instagramie), automatyzacja dźwięku nie jest obsługiwana niezależnie od post_way. Skrypt automatycznie pominie krok dźwięku.

Parametry specyficzne dla TikTok

Parametr	Typ	Wymagany	Domyślnie	Opis
placement	string	Nie	""	Miejsce publikacji: `""` (zwykłe wideo, domyślnie) lub `"story"` (TikTok Story). Przy `"story"` skrypt klika "Your Story" po konfiguracji dźwięku, pomijając kroki tytułu/linku produktu/etykiety AI.
add_product_link	integer	Nie	0	Czy dodać link do produktu/zakupów: `0` = nie, `1` = tak

Parametry specyficzne dla Instagram

Parametr	Typ	Wymagany	Domyślnie	Opis
placement	string	Nie	"reel"	Miejsce publikacji: `reel` (Reels), `story` (Stories) lub `post` (zwykły post w aktualnościach). Uwaga: opcje dźwięku nie są obsługiwane, gdy `placement` ma wartość `post`
enable_schedule_reels	boolean	Nie	false	Czy zaplanować Reel na przyszły czas
schedule_reels_time	string	Warunkowo	""	Zaplanowany czas publikacji w formacie `YYYY-MM-DD HH:MM` (wymagany gdy enable_schedule_reels = true)
story_link	string	Nie	""	URL do dołączenia jako link naklejki na Story (dotyczy tylko gdy placement = "story")

Przykłady

Publikowanie w TikTok Story

Publikuj bezpośrednio w TikTok Story. Po konfiguracji dźwięku skrypt klika "Your Story" — bez kroków tytułu/linku produktu/etykiety AI :

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "placement": "story",
      "post_way": "addButton",
      "material_list": ["C:/Videos/story_video.mp4"],
      "upload_wait_time": 30
    }
  }'

Podstawowe zadanie publikacji z bezpośrednią listą materiałów

Jest to zalecane podejście do automatyzacji API - przekazuj ścieżki materiałów bezpośrednio bez polegania na bibliotece materiałów lub skanowaniu folderów:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Check out my new video! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Zadanie publikacji z biblioteką materiałów (TikTok)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Check out my new video! #viral #fyp",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "trending, dance",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

Zadanie publikacji według listy nazw użytkowników

Ten tryb pozwala tworzyć zadania bezpośrednio dla określonych kont bez znajomości ich numerów seryjnych urządzeń:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@user1", "@user2", "@user3"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Check out my new video! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Zadanie publikacji z folderu lokalnego (Instagram)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Amazing content! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

Post w aktualnościach na Instagramie (placement: post)

Publikuj w zwykłych aktualnościach Instagramu (nie Reel). Opcje dźwięku nie są obsługiwane dla tego miejsca publikacji:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "New post! #instagram",
      "placement": "post",
      "post_way": "addButton",
      "material_list": ["C:/Videos/my_video.mp4"],
      "upload_wait_time": 45
    }
  }'

Publikacja z niestandardowym dźwiękiem

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Dancing to this trending sound!",
      "post_way": "addButton",
      "add_sound": "custom",
      "custom_sound_keyword": "trending dance 2024",
      "origin_sound_volume": 30,
      "add_sound_volume": 70,
      "material_source": "materialLibrary",
      "upload_wait_time": 60
    }
  }'

Publikacja z użyciem określonego URL dźwięku

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "post_way": "useSound",
      "sound_name": "https://www.tiktok.com/music/original-sound-7123456789",
      "captions": "Using this awesome sound!",
      "material_source": "materialLibrary"
    }
  }'

Publikacja obrazów (Karuzela)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 1,
      "image_count": 5,
      "captions": "Check out these photos! #photocarousel",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

Publikacja z Wyraźnym Wyborem Platformy

Możesz wyraźnie określić platformę docelową używając parametru platform. Jest to przydatne, gdy chcesz nadpisać domyślną wartość środowiska:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "Publikowanie na Instagramie! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Odpowiedź

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [101, 102],
    "created_count": 2
  }
}

Zobacz także

API zarządzania zadaniami - Tworzenie, wyświetlanie i zarządzanie zadaniami

Przegląd​

Parametry żądania​

Konfiguracja skryptu (script_config)​

Wspólne parametry (TikTok, Instagram i Threads)​

Metody publikacji (post_way)​

Parametry specyficzne dla TikTok​

Parametry specyficzne dla Instagram​

Przykłady​

Publikowanie w TikTok Story​

Podstawowe zadanie publikacji z bezpośrednią listą materiałów​

Zadanie publikacji z biblioteką materiałów (TikTok)​

Zadanie publikacji według listy nazw użytkowników​

Zadanie publikacji z folderu lokalnego (Instagram)​

Post w aktualnościach na Instagramie (placement: post)​

Publikacja z niestandardowym dźwiękiem​

Publikacja z użyciem określonego URL dźwięku​

Publikacja obrazów (Karuzela)​

Publikacja z Wyraźnym Wyborem Platformy​

Odpowiedź​

Zobacz także​