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"	प्रकाशन विधि: share, addButton या useSound
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) |

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

पैरामीटर	प्रकार	आवश्यक	डिफ़ॉल्ट मान	विवरण
add_product_link	integer	नहीं	0	उत्पाद/शॉपिंग लिंक जोड़ना है या नहीं: 0 = नहीं, 1 = हाँ

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

पैरामीटर	प्रकार	आवश्यक	डिफ़ॉल्ट मान	विवरण
placement	string	नहीं	"reel"	प्रकाशन स्थान: reel (रील) या story (स्टोरी)
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")

उदाहरण

मूल प्रकाशन कार्य - सीधे सामग्री पथ पास करें

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

कस्टम ऑडियो के साथ प्रकाशित करें

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 - कार्यों को बनाएं, सूचीबद्ध करें और प्रबंधित करें