Chuyển tới nội dung chính

Cấu Hình Script Post

Trang này ghi lại các tham số cấu hình cho script post được sử dụng trong việc tạo tác vụ.

Tổng Quan​

Script post được sử dụng để tự động đăng nội dung (video hoặc hình ảnh) lên TikTok hoặc Instagram. Nó hỗ trợ nhiều phương thức đăng bài, nguồn tài liệu và tùy chọn âm thanh.

Tham Số Yêu Cầu​

Khi tạo tác vụ, bạn có thể chỉ định các tham số cấp cao nhất sau:

Tham SốKiểuBắt BuộcMặc ĐịnhMô Tả
serialsstring[]Có điều kiện[]Danh sách số serial thiết bị (Chế độ 1: dựa trên thiết bị)
usernamesstring[]Có điều kiện[]Danh sách tên người dùng để tạo tác vụ (Chế độ 2: dựa trên tên người dùng)
script_namestringCó-Tên script để thực thi (ví dụ: "post")
script_configobjectCó-Các tham số cấu hình script (xem bên dưới)
enable_multi_accountbooleanKhôngfalseBật chế độ đa tài khoản (tạo tác vụ cho mỗi tài khoản trên thiết bị)
start_timestringKhông-Thời gian bắt đầu tùy chọn theo định dạng "HH:MM"
platformstringCó điều kiện*autoNền tảng mục tiêu: tiktok, instagram. Xem ghi chú bên dưới

Lưu ý: Phải cung cấp serials hoặc usernames.

*Hành Vi Tham Số Platform:

  • TikMatrix và IgMatrix: Tham số platform sẽ bị bỏ qua nếu được cung cấp. Nền tảng được xác định tự động từ tên ứng dụng (TikMatrix → tiktok, IgMatrix → instagram).
  • TikMatrix Pro: Tham số platform là bắt buộc và phải được chỉ định rõ ràng là tiktok hoặc instagram.

Cấu Hình Script (script_config)​

Đối tượng script_config chứa các tham số cho script post. Dưới đây là các tham số có sẵn:

Tham Số Chung (TikTok & Instagram)​

Tham SốKiểuBắt BuộcMặc ĐịnhMô Tả
content_typeintegerKhông0Loại nội dung: 0 = Video, 1 = Hình ảnh
image_countintegerKhông1Số lượng hình ảnh để chọn (khi content_type = 1)
captionsstringKhông""Văn bản chú thích cho bài đăng. Hỗ trợ định dạng spintax: {lựa_chọn1|lựa_chọn2|lựa_chọn3}
post_waystringKhông"share"Phương thức đăng: share, addButton hoặc useSound
material_sourcestringKhông"materialLibrary"Nguồn tài liệu: materialLibrary hoặc localFolder (bị bỏ qua nếu cung cấp material_list)
material_pathstringCó điều kiện""Đường dẫn thư mục cục bộ (bắt buộc khi material_source = "localFolder")
material_liststring[]Không[]Mảng đường dẫn file tài liệu trực tiếp. Khi được cung cấp, sẽ bỏ qua logic của material_source và material_path. Lý tưởng cho tự động hóa API.
materials_tagsstringKhông""Các thẻ tài liệu phân cách bằng dấu phẩy để lọc từ thư viện
upload_wait_timeintegerKhông30Số giây chờ hoàn thành tải lên
sound_wait_timeintegerKhông10Số giây chờ tải âm thanh
add_soundstring/integerKhông"-1"Tùy chọn âm thanh: -1 = mặc định, 0 = tắt, 1 = bật, custom = sử dụng âm thanh tùy chỉnh
sound_namestringCó điều kiện""Tên/URL âm thanh (bắt buộc khi post_way = "useSound")
custom_sound_keywordstringCó điều kiện""Từ khóa để tìm kiếm âm thanh tùy chỉnh (bắt buộc khi add_sound = "custom")
origin_sound_volumeintegerKhông50Âm lượng âm thanh gốc (0-100)
add_sound_volumeintegerKhông50Âm lượng âm thanh thêm vào (0-100)

Tham Số Riêng Cho TikTok​

Tham SốKiểuBắt BuộcMặc ĐịnhMô Tả
add_product_linkintegerKhông0Thêm liên kết sản phẩm: 0 = Không, 1 = Có

Tham Số Riêng Cho Instagram​

Tham SốKiểuBắt BuộcMặc ĐịnhMô Tả
placementstringKhông"reel"Vị trí đăng: reel hoặc story

Ví Dụ​

Tác Vụ Đăng Bài Cơ Bản Với Danh Sách Tài Liệu Trực Tiếp​

Đây là cách tiếp cận được khuyến nghị cho tự động hóa API - truyền đường dẫn tài liệu trực tiếp mà không dựa vào thư viện tài liệu hoặc quét thư mục:

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": "Xem video mới của tôi! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Tác Vụ Đăng Bài Với Thư Viện Tài Liệu (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": "Xem video mới của tôi! #viral #fyp",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "trending, dance",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

Tác Vụ Đăng Bài Theo Danh Sách Tên Người Dùng​

Chế độ này cho phép bạn tạo tác vụ trực tiếp cho các tài khoản cụ thể mà không cần biết số serial thiết bị của họ:

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": "Xem video mới của tôi! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Tác Vụ Đăng Bài Với Thư Mục Cục Bộ (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": "Nội dung tuyệt vời! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

Đăng Bài Với Âm Thanh Tùy Chỉnh​

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": "Nhảy theo âm thanh đang thịnh hành này!",
      "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
    }
  }'

Đăng Bài Sử Dụng URL Âm Thanh Cụ Thể​

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": "Sử dụng âm thanh tuyệt vời này!",
      "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": "Xem những bức ảnh này! #photocarousel",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

Đăng Bài Với Lựa Chọn Nền Tảng Rõ Ràng​

Bạn có thể chỉ định rõ ràng nền tảng mục tiêu bằng tham số platform. Điều này hữu ích khi bạn muốn ghi đè mặc định của môi trường:

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": "Đang đăng lên Instagram! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Phản Hồi​

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

Xem Thêm​