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	सशर्त आवश्यक*	स्वत:	लक्षित प्लेटफ़ॉर्म: 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	पोस्ट में AI-जनित सामग्री लेबल जोड़ना है या नहीं
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_min	integer	नहीं	-	प्रतीक्षा अवधि की निचली सीमा। दोनों सीमाएँ सेट होने पर स्क्रिप्ट हर कार्य के लिए इस दायरे में यादृच्छिक मान चुनती है
upload_wait_time_max	integer	नहीं	-	प्रतीक्षा अवधि की ऊपरी सीमा
sound_wait_time	integer	नहीं	10	ऑडियो लोड होने की प्रतीक्षा करने के लिए सेकंड
sound_wait_time_min	integer	नहीं	-	प्रतीक्षा अवधि की निचली सीमा। दोनों सीमाएँ सेट होने पर स्क्रिप्ट हर कार्य के लिए इस दायरे में यादृच्छिक मान चुनती है
sound_wait_time_max	integer	नहीं	-	प्रतीक्षा अवधि की ऊपरी सीमा
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)

upload_wait_time सामान्य पोस्टिंग और save_draft मोड दोनों पर लागू होता है। ड्राफ्ट के रूप में सेव करने पर भी TikTok/Instagram को बैकग्राउंड में वीडियो अपलोड पूरा करने के लिए समय चाहिए।

upload_wait_time और sound_wait_time दायरे के रूप में भी दिए जा सकते हैं: upload_wait_time_min / upload_wait_time_max (या sound_wait_time_min / sound_wait_time_max) भेजें और स्क्रिप्ट हर कार्य के लिए उस दायरे में नया यादृच्छिक मान चुनेगी, ताकि सभी कार्य एक ही अवधि तक प्रतीक्षा न करें। दोनों सीमाएँ मौजूद होने पर दायरे को प्राथमिकता मिलती है, अन्यथा एकल-मान कुंजी का उपयोग होता है।

पोस्ट मेथड्स (post_way)

post_way पैरामीटर नियंत्रित करता है कि स्क्रिप्ट पोस्टिंग स्क्रीन कैसे खोलती है:

मान	विवरण
addButton	(डिफ़ॉल्ट) ऐप के अंदर "+" create बटन पर टैप करता है, फिर डिवाइस गैलरी से मीडिया चुनता है। यह सभी प्लेसमेंट्स (reel, story, post) के साथ काम करता है। अधिकतर मामलों के लिए अनुशंसित।
share	मीडिया फ़ाइल से सीधे Instagram/TikTok ऐप में Android share intent ट्रिगर करता है। यह एक वैकल्पिक तरीका है जो ऐप-के-अंदर नेविगेशन को बायपास करता है; तब उपयोगी होता है जब addButton फ़्लो किसी खास डिवाइस या ऐप संस्करण पर भरोसेमंद न हो।
useSound	पहले किसी विशेष ऑडियो ट्रैक पर जाता है (sound_name URL या keyword के जरिए), फिर वीडियो को उस साउंड से जोड़ता है। केवल Reels / TikTok के लिए। इसके लिए sound_name सेट होना आवश्यक है। यह placement = "post" या placement = "story" के साथ संगत नहीं है।

note

जब placement post (Instagram feed post) हो, तब post_way चाहे कुछ भी हो, sound automation समर्थित नहीं है। स्क्रिप्ट sound step को अपने-आप छोड़ देगी।

TikTok विशिष्ट पैरामीटर

पैरामीटर	प्रकार	आवश्यक	डिफ़ॉल्ट मान	विवरण
placement	string	नहीं	""	प्रकाशन स्थान: "" (सामान्य वीडियो, डिफ़ॉल्ट) या "story" (TikTok Story)। "story" के साथ, स्क्रिप्ट ध्वनि सेटअप के बाद "Your Story" क्लिक करती है, शीर्षक/उत्पाद लिंक/AI लेबल चरणों को छोड़ती है।
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	नहीं	""	Story पर स्टिकर लिंक के रूप में संलग्न करने के लिए URL (केवल तभी लागू होता है जब placement = "story")

उदाहरण

TikTok Story पोस्ट करें

सीधे TikTok Story पर प्रकाशित करें। ध्वनि सेटअप के बाद, स्क्रिप्ट "Your Story" क्लिक करती है — शीर्षक/उत्पाद लिंक/AI लेबल चरण नहीं :

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": "मेरा नया वीडियो देखें! #trending #recommended",
      "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": "मेरा नया वीडियो देखें! #trending #recommended",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "trending, dance",
      "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": "मेरा नया वीडियो देखें! #trending #recommended",
      "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 feed post (placement: post)

सामान्य Instagram feed (Reel नहीं) में प्रकाशित करें। इस placement में sound options समर्थित नहीं हैं:

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": "trending dance 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": "ये तस्वीरें देखें! #photoset",
      "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 - कार्यों को बनाएं, सूचीबद्ध करें और प्रबंधित करें