Zum Hauptinhalt springen

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.

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)​

ParameterTypErforderlichStandardBeschreibung
content_typeintegerNein0Inhaltstyp: 0 = Video, 1 = Bilder
image_countintegerNein1Anzahl der auszuwählenden Bilder (wenn content_type = 1)
captionsstringNein""Untertiteltext für den Beitrag. Unterstützt Spintax: {Option1|Option2|Option3}
post_waystringNein"share"Veröffentlichungsmethode: share, addButton oder useSound
material_sourcestringNein"materialLibrary"Materialquelle: materialLibrary (Bibliothek) oder localFolder (lokaler Ordner), wird ignoriert wenn material_list angegeben
material_pathstringBedingt""Pfad zum lokalen Ordner (erforderlich, wenn material_source = "localFolder")
material_liststring[]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_tagsstringNein""Kommagetrennte Material-Tags zum Filtern aus der Bibliothek
upload_wait_timeintegerNein30Upload-Wartezeit in Sekunden
sound_wait_timeintegerNein10Audio-Lade-Wartezeit in Sekunden
add_soundstring/integerNein"-1"Audio-Optionen: -1 = Standard, 0 = deaktiviert, 1 = aktiviert, custom = benutzerdefiniertes Audio verwenden
sound_namestringBedingt""Audio-Name/URL (erforderlich, wenn post_way = "useSound")
custom_sound_keywordstringBedingt""Suchbegriff für benutzerdefiniertes Audio (erforderlich, wenn add_sound = "custom")
origin_sound_volumeintegerNein50Lautstärke des Originaltons (0-100)
add_sound_volumeintegerNein50Lautstärke des hinzugefügten Tons (0-100)

Nur TikTok-Parameter​

ParameterTypErforderlichStandardBeschreibung
add_product_linkintegerNein0Produktlink hinzufügen: 0 = nein, 1 = ja

Nur Instagram-Parameter​

ParameterTypErforderlichStandardBeschreibung
placementstringNein"reel"Veröffentlichungsplatzierung: reel oder story

Beispiele​

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": "share",
      "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
  }'

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": "share",
      "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
    }
  }'

Antwort​

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

Siehe auch​