Перейти к основному содержимому

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

На этой странице описаны параметры конфигурации скрипта post, используемого при создании задач.

Обзор​

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

Параметры запроса​

При создании задачи вы можете указать следующие параметры верхнего уровня:

ПараметрТипОбязательноПо умолчаниюОписание
serialsstring[]Условно[]Список серийных номеров устройств (Режим 1: на основе устройства)
usernamesstring[]Условно[]Список имен пользователей для создания задач (Режим 2: на основе имени пользователя)
script_namestringДа-Имя выполняемого скрипта (например, "post")
script_configobjectДа-Параметры конфигурации скрипта (см. ниже)
enable_multi_accountbooleanНетfalseВключить режим нескольких аккаунтов (создать задачу для каждого аккаунта на устройстве)
start_timestringНет-Необязательное время начала в формате "HH:MM"
platformstringУсловно*autoЦелевая платформа: tiktok, instagram. См. примечание ниже

Примечание: Необходимо указать serials или usernames.

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

  • TikMatrix и IgMatrix: Параметр platform игнорируется, если он указан. Платформа автоматически определяется из имени приложения (TikMatrix → tiktok, IgMatrix → instagram).
  • TikMatrix Pro: Параметр platform обязателен и должен быть явно указан как tiktok или instagram.

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

Объект script_config содержит параметры для скрипта публикации. Ниже приведены доступные параметры:

Общие параметры (TikTok и Instagram)​

ПараметрТипОбязательноПо умолчаниюОписание
content_typeintegerНет0Тип контента: 0 = видео, 1 = изображения
image_countintegerНет1Количество выбираемых изображений (когда content_type = 1)
captionsstringНет""Текст подписи к посту. Поддерживает spintax: {вариант1|вариант2|вариант3}
post_waystringНет"share"Способ публикации: share, addButton или useSound
material_sourcestringНет"materialLibrary"Источник материала: materialLibrary (библиотека) или localFolder (локальная папка), игнорируется если указан material_list
material_pathstringУсловно""Путь к локальной папке (обязательно, когда material_source = "localFolder")
material_liststring[]Нет[]Массив прямых путей к файлам материалов. При указании этого параметра логика material_source и material_path игнорируется. Идеально для API-автоматизации.
materials_tagsstringНет""Теги материалов через запятую для фильтрации из библиотеки
upload_wait_timeintegerНет30Время ожидания загрузки в секундах

upload_wait_time применяется и к обычной публикации, и к режиму save_draft. Даже при сохранении в черновики TikTok всё равно нужно время, чтобы завершить загрузку видео в фоне. | 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 | Нет | 50 | Громкость оригинального звука (0-100) | | add_sound_volume | integer | Нет | 50 | Громкость добавленного звука (0-100) |

Параметры только для Instagram​

ПараметрТипОбязательноПо умолчаниюОписание
placementstringНет"reel"Размещение публикации: reel или 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": "Посмотрите моё новое видео! #популярное #рекомендации",
      "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": "Посмотрите моё новое видео! #популярное #рекомендации",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "популярное, танцы",
      "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": "Посмотрите моё новое видео! #популярное #рекомендации",
      "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": "популярная музыка 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": "Посмотрите эти фото! #карусель",
      "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
  }
}

См. также​