Конфигурация скрипта 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 содержит параметры для скрипта публикации. Ниже приведены доступные параметры:

Общие параметры (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"	Способ публикации. Подробнее см. раздел Способы публикации ниже
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) |

Способы публикации (`post_way`)

Параметр post_way управляет тем, как скрипт открывает экран публикации:

Значение	Описание
`addButton`	(По умолчанию) Нажимает кнопку создания "+" в приложении, затем выбирает медиа из галереи устройства. Работает со всеми вариантами размещения (`reel`, `story`, `post`). Рекомендуется для большинства случаев.
`share`	Запускает Android share intent напрямую из медиафайла в приложение Instagram/TikTok. Это альтернативный способ, который обходит навигацию внутри приложения; полезен, когда сценарий `addButton` работает нестабильно на конкретном устройстве или версии приложения.
`useSound`	Сначала переходит к определённой аудиодорожке (через URL или ключевое слово `sound_name`), затем привязывает видео к этому звуку. Только для Reels / TikTok. Требуется указать `sound_name`. Несовместимо с `placement = "post"` или `placement = "story"`.

примечание

Когда placement имеет значение post (обычный пост в ленте Instagram), автоматизация звука не поддерживается независимо от post_way. Скрипт автоматически пропустит шаг со звуком.

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

Параметр	Тип	Обязательно	По умолчанию	Описание
placement	string	Нет	""	Место публикации: `""` (обычное видео, по умолчанию) или `"story"` (TikTok Story). При `"story"` скрипт нажимает "Your Story" после настройки звука, пропуская заголовок/ссылку на товар/метку ИИ.
add_product_link	integer	Нет	0	Следует ли добавить ссылку на товар/магазин: `0` = нет, `1` = да

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

Параметр	Тип	Обязательно	По умолчанию	Описание
placement	string	Нет	"reel"	Размещение публикации: `reel` (Reels), `story` (Stories) или `post` (обычный пост в ленте). Примечание: параметры звука не поддерживаются, когда `placement` имеет значение `post`
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")

Примеры

Публикация в TikTok Story

Публикация напрямую в TikTok Story. После настройки звука скрипт нажимает "Your Story" — без шагов заголовка/ссылки на товар/метки ИИ :

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
    }
  }'

Базовая задача публикации с прямым списком материалов

Это рекомендуемый подход для 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
  }'

Публикация в ленте Instagram (placement: post)

Публикация в обычную ленту Instagram (не Reel). Параметры звука для этого варианта размещения не поддерживаются:

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
    }
  }'

Публикация с собственным звуком

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
  }
}

См. также

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

Обзор​

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

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

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

Способы публикации (post_way)​

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

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

Примеры​

Публикация в TikTok Story​

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

Публикация с использованием библиотеки материалов (TikTok)​

Создание задачи по списку имён пользователей​

Публикация из локальной папки (Instagram)​

Публикация в ленте Instagram (placement: post)​

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

Публикация с указанным URL звука​

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

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

Ответ​

См. также​