Конфігурація скрипту Post

Ця сторінка документує параметри конфігурації для скрипту post, що використовується при створенні завдань.

Огляд

Скрипт post використовується для автоматичної публікації контенту (відео або зображень) в TikTok або Instagram. Він підтримує різні методи публікації, джерела матеріалів та параметри звуку.

Параметри запиту

При створенні завдання можна вказати наступні параметри верхнього рівня:

Параметр	Тип	Обов'язковий	За замовчуванням	Опис
serials	string[]	Умовний	[]	Список серійних номерів пристроїв (Режим 1: на основі пристроїв)
usernames	string[]	Умовний	[]	Список імен користувачів для створення завдань (Режим 2: на основі імен користувачів)
script_name	string	Так	-	Назва скрипту для виконання (наприклад, "post")
script_config	object	Так	-	Параметри конфігурації скрипту (див. нижче)
enable_multi_account	boolean	Ні	false	Увімкнути режим мультиакаунту (створити завдання для кожного облікового запису на пристрої)
start_time	string	Ні	-	Необов'язковий час початку у форматі "HH:MM"
platform	string	Умовний*	auto	Цільова платформа: `tiktok`, `instagram`. Див. примітку нижче

Примітка: Необхідно вказати або serials, або usernames.

*Поведінка параметра Platform:

TikMatrix і IgMatrix: Параметр platform ігнорується, якщо його вказано. Платформа автоматично визначається з імені додатка (TikMatrix → tiktok, IgMatrix → instagram).
TikMatrix Pro: Параметр platform є обов'язковим і має бути явно вказаний як tiktok або instagram.

Конфігурація скрипту (`script_config`)

Об'єкт script_config містить параметри для скрипту post. Нижче наведено доступні параметри:

Загальні параметри (TikTok і Instagram)

Параметр	Тип	Обов'язковий	За замовчуванням	Опис
content_type	integer	Ні	0	Тип контенту: `0` = Відео, `1` = Зображення
image_count	integer	Ні	1	Кількість зображень для вибору (коли content_type = 1)
captions	string	Ні	""	Текст підпису для публікації. Підтримує формат spintax: `{варіант1\|варіант2\|варіант3}`
caption_format	string	Ні	"multiline"	Спосіб обробки багаторядкових підписів: `multiline` (вставляє реальні переноси рядків) або `singleline` (замінює `\n` пробілами)
ai_label	boolean	Ні	false	Чи додавати до публікації мітку вмісту, створеного ШІ
save_draft	boolean	Ні	false	Зберегти публікацію як чернетку замість негайної публікації
post_way	string	Ні	"addButton"	Метод публікації: `share`, `addButton` або `useSound`
material_source	string	Ні	"materialLibrary"	Джерело матеріалів: `materialLibrary` або `localFolder` (ігнорується, якщо надано material_list)
material_path	string	Умовний	""	Шлях до локальної папки (обов'язковий, коли material_source = "localFolder")
material_list	string[]	Ні	[]	Масив прямих шляхів до файлів матеріалів. При наданні обходить логіку material_source та material_path. Ідеально для автоматизації API.
materials_tags	string	Ні	""	Теги матеріалів через кому для фільтрації з бібліотеки
upload_wait_time	integer	Ні	10	Секунди очікування завершення завантаження

upload_wait_time застосовується і до звичайної публікації, і до режиму save_draft. Навіть під час збереження в чернетку TikTok/Instagram все одно потрібен час, щоб завершити завантаження відео у фоновому режимі. | sound_wait_time | integer | Ні | 10 | Секунди очікування завантаження звуку | | add_sound | string/integer | Ні | "-1" | Параметр звуку: -1 = за замовчуванням, 0 = вимкнути, 1 = увімкнути, custom = використати власний звук | | sound_name | string | Умовний | "" | Назва/URL звуку (обов'язковий, коли post_way = "useSound") | | custom_sound_keyword | string | Умовний | "" | Ключове слово для пошуку власного звуку (обов'язковий, коли add_sound = "custom") | | origin_sound_volume | integer | Ні | 100 | Гучність оригінального звуку (0-100) | | add_sound_volume | integer | Ні | 100 | Гучність доданого звуку (0-100) |

Параметри лише для TikTok

Параметр	Тип	Обов'язковий	За замовчуванням	Опис
add_product_link	integer	Ні	0	Чи додавати посилання на товар/магазин: `0` = ні, `1` = так

Параметри лише для Instagram

Параметр	Тип	Обов'язковий	За замовчуванням	Опис
placement	string	Ні	"reel"	Розміщення публікації: `reel` або `story`
enable_schedule_reels	boolean	Ні	false	Чи планувати Reel на майбутній час
schedule_reels_time	string	Умовно	""	Запланований час публікації у форматі `YYYY-MM-DD HH:MM` (обов'язково, якщо enable_schedule_reels = true)
story_link	string	Ні	""	URL для прикріплення як посилання-стікер на Story (застосовується лише коли placement = "story")

Приклади

Базове завдання публікації з прямим списком матеріалів

Це рекомендований підхід для автоматизації API - передавайте шляхи до матеріалів безпосередньо, не покладаючись на бібліотеку матеріалів або сканування папок:

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": "Подивіться на моє нове відео! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Завдання публікації з бібліотекою матеріалів (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": "Подивіться на моє нове відео! #viral #fyp",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "trending, dance",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

Завдання публікації за списком імен користувачів

Цей режим дозволяє створювати завдання безпосередньо для конкретних облікових записів без знання їх серійних номерів пристроїв:

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": "Подивіться на моє нове відео! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Завдання публікації з локальною папкою (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": "Чудовий контент! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

Публікація з власним звуком

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": "Танцюю під цей трендовий звук!",
      "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
    }
  }'

Публікація з використанням конкретного URL звуку

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": "Використовую цей чудовий звук!",
      "material_source": "materialLibrary"
    }
  }'

Публікація зображень (Карусель)

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": "Подивіться на ці фото! #photocarousel",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

Публікація з явним вибором платформи

Ви можете явно вказати цільову платформу, використовуючи параметр platform. Це корисно, коли ви хочете перевизначити налаштування середовища за замовчуванням:

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": "Публікую в Instagram! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Відповідь

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

Див. також

API управління завданнями - Створення, перегляд списку та управління завданнями

Огляд​

Параметри запиту​

Конфігурація скрипту (script_config)​

Загальні параметри (TikTok і Instagram)​

Параметри лише для TikTok​

Параметри лише для Instagram​

Приклади​

Базове завдання публікації з прямим списком матеріалів​

Завдання публікації з бібліотекою матеріалів (TikTok)​

Завдання публікації за списком імен користувачів​

Завдання публікації з локальною папкою (Instagram)​

Публікація з власним звуком​

Публікація з використанням конкретного URL звуку​

Публікація зображень (Карусель)​

Публікація з явним вибором платформи​

Відповідь​

Див. також​