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ểu	Bắt Buộc	Mặc Định	Mô Tả
serials	string[]	Có điều kiện	[]	Danh sách số serial thiết bị (Chế độ 1: dựa trên thiết bị)
usernames	string[]	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_name	string	Có	-	Tên script để thực thi (ví dụ: "post")
script_config	object	Có	-	Các tham số cấu hình script (xem bên dưới)
enable_multi_account	boolean	Không	false	Bậ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_time	string	Không	-	Thời gian bắt đầu tùy chọn theo định dạng "HH:MM"
platform	string	Có điều kiện*	auto	Nề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ểu	Bắt Buộc	Mặc Định	Mô Tả
content_type	integer	Không	0	Loại nội dung: `0` = Video, `1` = Hình ảnh
image_count	integer	Không	1	Số lượng hình ảnh để chọn (khi content_type = 1)
captions	string	Khô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}`
caption_format	string	Không	"multiline"	Cách xử lý chú thích nhiều dòng: `multiline` (chèn dòng mới thực) hoặc `singleline` (thay thế `\n` bằng khoảng trắng)
ai_label	boolean	Không	false	Có thêm nhãn nội dung do AI tạo ra vào bài đăng không
save_draft	boolean	Không	false	Lưu bài đăng dưới dạng bản nháp thay vì xuất bản ngay
post_way	string	Không	"addButton"	Phương thức đăng: `share`, `addButton` hoặc `useSound`
material_source	string	Không	"materialLibrary"	Nguồn tài liệu: `materialLibrary` hoặc `localFolder` (bị bỏ qua nếu cung cấp material_list)
material_path	string	Có điều kiện	""	Đường dẫn thư mục cục bộ (bắt buộc khi material_source = "localFolder")
material_list	string[]	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_tags	string	Khô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_time	integer	Không	10	Số giây chờ hoàn thành tải lên

upload_wait_time áp dụng cho cả đăng bài bình thường và chế độ save_draft. Ngay cả khi lưu dưới dạng bản nháp, TikTok/Instagram vẫn cần thời gian để hoàn tất tải video lên ở chế độ nền. | sound_wait_time | integer | Không | 10 | Số giây chờ tải âm thanh | | add_sound | string/integer | Khô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_name | string | Có điều kiện | "" | Tên/URL âm thanh (bắt buộc khi post_way = "useSound") | | custom_sound_keyword | string | Có đ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_volume | integer | Không | 100 | Âm lượng âm thanh gốc (0-100) | | add_sound_volume | integer | Không | 100 | Âm lượng âm thanh thêm vào (0-100) |

Tham số Đặc thù TikTok

Tham Số	Kiểu	Bắt Buộc	Mặc Định	Mô Tả
add_product_link	integer	Không	0	Có thêm liên kết sản phẩm/mua sắm không: `0` = không, `1` = có

Tham số Đặc thù Instagram

Tham Số	Kiểu	Bắt Buộc	Mặc Định	Mô Tả
placement	string	Không	"reel"	Vị trí đăng: `reel` hoặc `story`
enable_schedule_reels	boolean	Không	false	Có lên lịch đăng Reel vào thời điểm trong tương lai không
schedule_reels_time	string	Có điều kiện	""	Thời gian xuất bản theo lịch theo định dạng `YYYY-MM-DD HH:MM` (bắt buộc khi enable_schedule_reels = true)
story_link	string	Không	""	URL để đính kèm làm liên kết nhãn dán trên Story (chỉ áp dụng khi placement = "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"
    }
  }'

Đăng Hình Ảnh (Carousel)

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

API Quản Lý Tác Vụ - Tạo, liệt kê và quản lý tác vụ

Tổng Quan​

Tham Số Yêu Cầu​

Cấu Hình Script (script_config)​

Tham Số Chung (TikTok & Instagram)​

Tham số Đặc thù TikTok​

Tham số Đặc thù Instagram​

Ví Dụ​

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

Tác Vụ Đăng Bài Với Thư Viện Tài Liệu (TikTok)​

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

Tác Vụ Đăng Bài Với Thư Mục Cục Bộ (Instagram)​

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

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

Đăng Hình Ảnh (Carousel)​

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

Phản Hồi​

Xem Thêm​