Konfiguration av post-script

Den här sidan dokumenterar konfigurationsparametrarna för post-scriptet som används vid skapande av uppgifter.

Översikt

post-scriptet används för att automatiskt publicera innehåll (videor eller bilder) till TikTok eller Instagram. Det stöder olika publiceringsmetoder, materialkällor och ljudalternativ.

Begäran parametrar

När du skapar en uppgift kan du ange följande parametrar på toppnivå:

Parameter	Typ	Krävs	Standard	Beskrivning
serials	string[]	Villkorligt	[]	Lista över enhetens serienummer (Läge 1: enhetsbaserad)
usernames	string[]	Villkorligt	[]	Lista över användarnamn för att skapa uppgifter (Läge 2: användarnamnbaserad)
script_name	string	Ja	-	Scriptnamn att köra (t.ex. "post")
script_config	object	Ja	-	Scriptkonfigurationsparametrar (se nedan)
enable_multi_account	boolean	Nej	false	Aktivera flerkontosläge (skapa uppgift för varje konto på enheten)
start_time	string	Nej	-	Valfri starttid i formatet "HH:MM"
platform	string	Villkorligt*	auto	Målplattform: `tiktok`, `instagram`. Se anmärkning nedan

Obs: serials eller usernames måste anges.

*Platform Parameter Beteende:

TikMatrix & IgMatrix: Parametern platform ignoreras om den anges. Plattformen bestäms automatiskt från appnamnet (TikMatrix → tiktok, IgMatrix → instagram).
TikMatrix Pro: Parametern platform är obligatorisk och måste anges explicit som tiktok eller instagram.

Scriptkonfiguration (`script_config`)

Objektet script_config innehåller parametrarna för post-scriptet. Nedan finns tillgängliga parametrar:

Gemensamma parametrar (TikTok & Instagram)

Parameter	Typ	Krävs	Standard	Beskrivning
content_type	integer	Nej	0	Innehållstyp: `0` = Video, `1` = Bilder
image_count	integer	Nej	1	Antal bilder att välja (när content_type = 1)
captions	string	Nej	""	Bildtexttext för inlägget. Stöder spintax-format: `{option1\|option2\|option3}`
caption_format	string	Nej	"multiline"	Hur flerradiga bildtexter hanteras: `multiline` (infoga verkliga radbrytningar) eller `singleline` (ersätt `\n` med mellanslag)
ai_label	boolean	Nej	false	Om AI-genererat innehållsmärke ska läggas till inlägget
save_draft	boolean	Nej	false	Spara inlägget som utkast istället för att publicera omedelbart
post_way	string	Nej	"addButton"	Publiceringsmetod. Se avsnittet Publiceringsmetoder nedan för detaljer
material_source	string	Nej	"materialLibrary"	Materialkälla: `materialLibrary` eller `localFolder` (ignoreras om material_list anges)
material_path	string	Villkorligt	""	Lokal mappsökväg (krävs när material_source = "localFolder")
material_list	string[]	Nej	[]	Array med direkta materialfilsökvägar. När detta anges kringgås material_source och material_path logik. Idealisk för API-automation.
materials_tags	string	Nej	""	Kommaseparerade materialtaggar för filtrering från bibliotek
upload_wait_time	integer	Nej	10	Sekunder att vänta på att uppladdning ska slutföras

upload_wait_time gäller både vanlig publicering och läget save_draft. Även när du sparar som utkast behöver TikTok/Instagram fortfarande tid för att slutföra videouppladdningen i bakgrunden. | sound_wait_time | integer | Nej | 10 | Sekunder att vänta på att ljud ska laddas | | add_sound | string/integer | Nej | "-1" | Ljudalternativ: -1 = standard, 0 = inaktivera, 1 = aktivera, custom = använd anpassat ljud | | sound_name | string | Villkorligt | "" | Ljudnamn/URL (krävs när post_way = "useSound") | | custom_sound_keyword | string | Villkorligt | "" | Nyckelord för att söka efter anpassat ljud (krävs när add_sound = "custom") | | origin_sound_volume | integer | Nej | 100 | Originalljudvolym (0-100) | | add_sound_volume | integer | Nej | 100 | Tillagt ljudvolym (0-100) |

Publiceringsmetoder (`post_way`)

Parametern post_way styr hur skriptet öppnar publiceringsskärmen:

Värde	Beskrivning
`addButton`	(Standard) Trycker på appens "+"-knapp för att skapa ett inlägg och väljer sedan media från enhetens galleri. Fungerar med alla placeringar (`reel`, `story`, `post`). Rekommenderas i de flesta fall.
`share`	Utlöser ett Android-delningsintent direkt från mediefilen till Instagram/TikTok-appen. Det är en alternativ metod som kringgår navigering i appen; användbar när flödet `addButton` är opålitligt på en viss enhet eller appversion.
`useSound`	Navigerar först till ett specifikt ljudspår (via URL eller nyckelord i `sound_name`) och kopplar sedan videon till det ljudet. Endast för Reels / TikTok. Kräver att `sound_name` är angivet. Inte kompatibelt med `placement = "post"` eller `placement = "story"`.

anteckning

När placement är post (Instagram-inlägg i flödet) stöds inte ljudautomation oavsett post_way. Skriptet hoppar över ljudsteget automatiskt.

TikTok-specifika parametrar

Parameter	Typ	Krävs	Standard	Beskrivning
placement	string	Nej	""	Publiceringsplats: `""` (normalt video, standard) eller `"story"` (TikTok Story). Med `"story"` klickar skriptet på "Your Story" efter ljudinställningen och hoppar över titel/produktlänk/AI-etikett.
add_product_link	integer	Nej	0	Om en produkt-/shoppinglänk ska läggas till: `0` = nej, `1` = ja

Instagram-specifika parametrar

Parameter	Typ	Krävs	Standard	Beskrivning
placement	string	Nej	"reel"	Publiceringsplacering: `reel` (Reels), `story` (Stories) eller `post` (vanligt inlägg i flödet). Obs: ljudalternativ stöds inte när `placement` är `post`
enable_schedule_reels	boolean	Nej	false	Om Reeln ska schemaläggas till en framtida tid
schedule_reels_time	string	Villkorligt	""	Schemalagd publiceringstid i formatet `YYYY-MM-DD HH:MM` (krävs när enable_schedule_reels = true)
story_link	string	Nej	""	URL att bifoga som klistermärkeslänk på en Story (gäller endast när placement = "story")

Exempel

Publicera TikTok Story

Publicera direkt till TikTok Story. Efter ljudinställningen klickar skriptet på "Your Story" — inga steg för titel/produktlänk/AI-etikett :

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

Grundläggande postuppgift med direkt materiallista

Detta är den rekommenderade metoden för API-automation - skicka materialsökvägar direkt utan att förlita sig på materialbibliotek eller mappskanning:

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": "Check out my new video! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Postuppgift med materialbibliotek (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": "Check out my new video! #viral #fyp",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "trending, dance",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

Postuppgift efter användarnamnslista

Detta läge gör det möjligt att skapa uppgifter direkt för specifika konton utan att känna till deras enhetserienummer:

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": "Check out my new video! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Postuppgift med lokal mapp (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": "Amazing 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-inlägg i flödet (placement: post)

Publicera i det vanliga Instagram-flödet (inte Reel). Ljudalternativ stöds inte för denna placering:

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 med anpassat ljud

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": "Dancing to this trending sound!",
      "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
    }
  }'

Post med specifik ljud-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": "Using this awesome sound!",
      "material_source": "materialLibrary"
    }
  }'

Posta bilder (Karusell)

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": "Check out these photos! #photocarousel",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

Posta med Explicit Plattformsval

Du kan explicit ange målplattformen med parametern platform. Detta är användbart när du vill åsidosätta miljöstandarden:

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

Svar

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

Se även

API för uppgiftshantering - Skapa, lista och hantera uppgifter

Översikt​

Begäran parametrar​

Scriptkonfiguration (script_config)​

Gemensamma parametrar (TikTok & Instagram)​

Publiceringsmetoder (post_way)​

TikTok-specifika parametrar​

Instagram-specifika parametrar​

Exempel​

Publicera TikTok Story​

Grundläggande postuppgift med direkt materiallista​

Postuppgift med materialbibliotek (TikTok)​

Postuppgift efter användarnamnslista​

Postuppgift med lokal mapp (Instagram)​

Instagram-inlägg i flödet (placement: post)​

Post med anpassat ljud​

Post med specifik ljud-URL​

Posta bilder (Karusell)​

Posta med Explicit Plattformsval​

Svar​

Se även​