Post-Skript-Konfiguration

Auf dieser Seite werden die Konfigurationsparameter für das post-Skript beschrieben, das beim Erstellen von Aufgaben verwendet wird.

Überblick

Das post-Skript wird verwendet, um automatisch Inhalte (Videos oder Bilder) auf TikTok oder Instagram zu veröffentlichen. Es unterstützt verschiedene Veröffentlichungsmethoden, Materialquellen und Audio-Optionen.

Anforderungsparameter

Beim Erstellen einer Aufgabe können Sie folgende Parameter auf oberster Ebene angeben:

Parameter	Typ	Erforderlich	Standard	Beschreibung
serials	string[]	Bedingt	[]	Liste der Geräteseriennummern (Modus 1: gerätebasiert)
usernames	string[]	Bedingt	[]	Liste der Benutzernamen, für die Aufgaben erstellt werden sollen (Modus 2: benutzernamenbasiert)
script_name	string	Ja	-	Name des auszuführenden Skripts (z. B. "post")
script_config	object	Ja	-	Skriptkonfigurationsparameter (siehe unten)
enable_multi_account	boolean	Nein	false	Multi-Account-Modus aktivieren (Aufgabe für jeden Account auf dem Gerät erstellen)
start_time	string	Nein	-	Optionale Startzeit im Format "HH:MM"
platform	string	Bedingt*	auto	Zielplattform: `tiktok`, `instagram`. Siehe Hinweis unten

Hinweis: Entweder serials oder usernames muss angegeben werden.

*Platform-Parameter-Verhalten:

TikMatrix & IgMatrix: Der Parameter platform wird ignoriert, falls angegeben. Die Plattform wird automatisch aus dem App-Namen bestimmt (TikMatrix → tiktok, IgMatrix → instagram).
TikMatrix Pro: Der Parameter platform ist erforderlich und muss explizit als tiktok oder instagram angegeben werden.

Skript-Konfiguration (`script_config`)

Das script_config-Objekt enthält Parameter für das Post-Skript. Nachfolgend die verfügbaren Parameter:

Allgemeine Parameter (TikTok und Instagram)

Parameter	Typ	Erforderlich	Standard	Beschreibung
content_type	integer	Nein	0	Inhaltstyp: `0` = Video, `1` = Bilder
image_count	integer	Nein	1	Anzahl der auszuwählenden Bilder (wenn content_type = 1)
captions	string	Nein	""	Untertiteltext für den Beitrag. Unterstützt Spintax: `{Option1\|Option2\|Option3}`
caption_format	string	Nein	"multiline"	Wie mehrzeilige Untertitel behandelt werden: `multiline` (fügt echte Zeilenumbrüche ein) oder `singleline` (ersetzt `\n` durch Leerzeichen)
ai_label	boolean	Nein	false	Ob dem Beitrag das KI-generierte Inhalts-Label hinzugefügt werden soll
save_draft	boolean	Nein	false	Beitrag als Entwurf speichern statt sofort veröffentlichen
post_way	string	Nein	"addButton"	Veröffentlichungsmethode. Details finden Sie im Abschnitt Veröffentlichungsmethoden weiter unten
material_source	string	Nein	"materialLibrary"	Materialquelle: `materialLibrary` (Bibliothek) oder `localFolder` (lokaler Ordner), wird ignoriert wenn material_list angegeben
material_path	string	Bedingt	""	Pfad zum lokalen Ordner (erforderlich, wenn material_source = "localFolder")
material_list	string[]	Nein	[]	Array direkter Dateipfade zu Materialien. Wenn dieser Parameter angegeben ist, werden material_source und material_path-Logik ignoriert. Ideal für API-Automatisierung.
materials_tags	string	Nein	""	Kommagetrennte Material-Tags zum Filtern aus der Bibliothek
upload_wait_time	integer	Nein	10	Upload-Wartezeit in Sekunden

upload_wait_time gilt sowohl für normales Posten als auch für den save_draft-Modus. Selbst beim Speichern als Entwurf benötigt TikTok/Instagram noch Zeit, um den Video-Upload im Hintergrund abzuschließen. | sound_wait_time | integer | Nein | 10 | Audio-Lade-Wartezeit in Sekunden | | add_sound | string/integer | Nein | "-1" | Audio-Optionen: -1 = Standard, 0 = deaktiviert, 1 = aktiviert, custom = benutzerdefiniertes Audio verwenden | | sound_name | string | Bedingt | "" | Audio-Name/URL (erforderlich, wenn post_way = "useSound") | | custom_sound_keyword | string | Bedingt | "" | Suchbegriff für benutzerdefiniertes Audio (erforderlich, wenn add_sound = "custom") | | origin_sound_volume | integer | Nein | 100 | Lautstärke des Originaltons (0-100) | | add_sound_volume | integer | Nein | 100 | Lautstärke des hinzugefügten Tons (0-100) |

Veröffentlichungsmethoden (`post_way`)

Der Parameter post_way steuert, wie das Skript den Veröffentlichungsbildschirm öffnet:

Wert	Beschreibung
`addButton`	(Standard) Tippt auf die In-App-Schaltfläche "+" zum Erstellen und wählt dann Medien aus der Galerie des Geräts aus. Funktioniert mit allen Platzierungen (`reel`, `story`, `post`). Für die meisten Fälle empfohlen.
`share`	Löst direkt aus der Mediendatei einen Android-Freigabe-Intent an die Instagram-/TikTok-App aus. Dies ist eine alternative Methode, die die Navigation in der App umgeht; nützlich, wenn der `addButton`-Ablauf auf einem bestimmten Gerät oder mit einer bestimmten App-Version unzuverlässig ist.
`useSound`	Navigiert zuerst zu einem bestimmten Audiotrack (über die URL oder das Stichwort in `sound_name`) und verknüpft dann das Video mit diesem Sound. Nur für Reels / TikTok. `sound_name` muss gesetzt sein. Nicht kompatibel mit `placement = "post"` oder `placement = "story"`.

hinweis

Wenn placement auf post gesetzt ist (Instagram-Feed-Beitrag), wird Sound-Automatisierung unabhängig von post_way nicht unterstützt. Das Skript überspringt den Sound-Schritt automatisch.

TikTok-spezifische Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
placement	string	Nein	""	Veröffentlichungsort: `""` (normales Video, Standard) oder `"story"` (TikTok Story). Mit `"story"` klickt das Skript nach der Sound-Einrichtung auf "Your Story" und überspringt Titel/Produkt-Link/KI-Label.
add_product_link	integer	Nein	0	Ob ein Produkt-/Einkaufs-Link hinzugefügt werden soll: `0` = nein, `1` = ja

Instagram-spezifische Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
placement	string	Nein	"reel"	Platzierung des Beitrags: `reel` (Reels), `story` (Stories) oder `post` (normaler Feed-Beitrag). Hinweis: Sound-Optionen werden nicht unterstützt, wenn `placement` auf `post` gesetzt ist
enable_schedule_reels	boolean	Nein	false	Ob das Reel für einen zukünftigen Zeitpunkt geplant werden soll
schedule_reels_time	string	Bedingt	""	Geplante Veröffentlichungszeit im Format `YYYY-MM-DD HH:MM` (erforderlich wenn enable_schedule_reels = true)
story_link	string	Nein	""	URL zum Anhängen als Sticker-Link an eine Story (gilt nur wenn placement = "story")

Beispiele

TikTok Story Veröffentlichen

Direkt als TikTok Story veröffentlichen. Nach der Sound-Einrichtung klickt das Skript auf "Your Story" — keine Titel-/Produkt-Link-/KI-Label-Schritte :

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

Basis-Post-Aufgabe mit direkter Materialliste

Dies ist der empfohlene Ansatz für API-Automatisierung - Materialpfade direkt übergeben ohne Verwendung der Bibliothek oder Ordner-Scanning:

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": "Schaut euch mein neues Video an! #trending #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Post mit Materialbibliothek (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": "Schaut euch mein neues Video an! #trending #fyp",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "trending, dance",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

Aufgabe nach Benutzernamen-Liste erstellen

Dieser Modus ermöglicht es, Aufgaben direkt für bestimmte Konten zu erstellen, ohne deren Geräteseriennummern zu kennen:

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": "Schaut euch mein neues Video an! #trending #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Post aus lokalem Ordner (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": "Toller Content! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

Instagram-Feed-Beitrag (placement: post)

Veröffentlichen Sie im regulären Instagram-Feed (kein Reel). Sound-Optionen werden für diese Platzierung nicht unterstützt:

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

Post mit benutzerdefiniertem Audio

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": "Tanze zu diesem Track!",
      "post_way": "addButton",
      "add_sound": "custom",
      "custom_sound_keyword": "trending music 2024",
      "origin_sound_volume": 30,
      "add_sound_volume": 70,
      "material_source": "materialLibrary",
      "upload_wait_time": 60
    }
  }'

Post mit spezifischer Audio-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": "Verwende diesen coolen Sound!",
      "material_source": "materialLibrary"
    }
  }'

Bild-Post (Karussell)

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": "Schaut euch diese Fotos an! #carousel",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

Post mit expliziter Plattformauswahl

Sie können die Zielplattform explizit mit dem Parameter platform angeben. Dies ist nützlich, wenn Sie den Umgebungsstandard überschreiben möchten:

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": "Poste auf Instagram! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Antwort

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

Siehe auch

Task-Management-API - Erstellen, Anzeigen und Verwalten von Aufgaben

Überblick​

Anforderungsparameter​

Skript-Konfiguration (script_config)​

Allgemeine Parameter (TikTok und Instagram)​

Veröffentlichungsmethoden (post_way)​

TikTok-spezifische Parameter​

Instagram-spezifische Parameter​

Beispiele​

TikTok Story Veröffentlichen​

Basis-Post-Aufgabe mit direkter Materialliste​

Post mit Materialbibliothek (TikTok)​

Aufgabe nach Benutzernamen-Liste erstellen​

Post aus lokalem Ordner (Instagram)​

Instagram-Feed-Beitrag (placement: post)​

Post mit benutzerdefiniertem Audio​

Post mit spezifischer Audio-URL​

Bild-Post (Karussell)​

Post mit expliziter Plattformauswahl​

Antwort​

Siehe auch​