API Đăng Video Lên TikTok

Endpoint POST /api/tiktok/upload là API cốt lõi để xuất bản video hoàn chỉnh lên tài khoản TikTok của bạn với đầy đủ các thiết lập chuyên sâu.

1. Thông số Kỹ thuật & Chi phí

Endpoint: POST /api/tiktok/upload
Chi phí Credit: 5 Credits / 1 lần xuất bản thành công.
Định dạng dữ liệu: application/json (Pure JSON).

Tiền đề: Kết Nối Kênh Trước Khi Sử Dụng API Upload

Để xuất bản video qua API, bạn cần có ít nhất một kênh TikTok đang liên kết với tài khoản StackVid. Bạn có thể kết nối kênh tự động trong 10 giây bằng tiện ích mã nguồn mở StackVid Connect hoặc xem hướng dẫn tại Kết nối Kênh.

2. Các trường dữ liệu hỗ trợ (Payload Parameters)

Trường	Kiểu	Bắt buộc	Mô tả
`videoUrl`	String	Có	Đường dẫn URL video trực tiếp (link CDN/S3/server hoặc URL từ endpoint Presigned Upload)
`caption`	String	Không	Tiêu đề và mô tả bài đăng (hỗ trợ tag `#hashtag` và `@mention`)
`targetChannel`	String	Không	Tên kênh hoặc handle kênh (nếu bỏ trống, tự dùng Kênh mặc định)
`coverUrl`	String	Không	URL ảnh bìa tùy chỉnh cho video
`privacyLevel`	Number	Không	`0` = Công khai (Mặc định), `1` = Bạn bè, `2` = Riêng tư
`allowComment`	Boolean	Không	Cho phép người xem bình luận (Mặc định: `true`)
`allowDuet`	Boolean	Không	Cho phép người khác làm Duet (Mặc định: `true`)
`allowStitch`	Boolean	Không	Cho phép người khác làm Stitch (Mặc định: `true`)
`soundId`	String	Không	ID âm thanh/nhạc bản quyền TikTok gắn vào video
`productAnchors`	Array	Không	Danh sách sản phẩm Showcase / TikTok Shop gắn kèm
`proxyUrl`	String	Không	Proxy tùy chỉnh (nếu muốn đè lên proxy có sẵn của kênh)

3. Code Mẫu Hoàn Chỉnh

cURLNode.js

bash

curl -X POST https://api.stackvid.dev/api/tiktok/upload \
  -H "X-API-Key: tk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "videoUrl": "https://media.yourdomain.com/stackvid-uploads/users/usr_1/video.mp4",
    "caption": "Mẹo phối đồ công sở siêu xinh cho các nàng! #fashion #outfit #ootd",
    "targetChannel": "Kênh Thời Trang Hottrend",
    "privacyLevel": 0,
    "allowComment": true,
    "allowDuet": true,
    "allowStitch": true,
    "soundId": "7189283746591028374",
    "productAnchors": [
      {
        "type": 5,
        "keyword": "Áo Sơ Mi Lụa Cao Cấp",
        "content": {
          "product_id": "1729482910392817"
        }
      }
    ]
  }'

typescript

import axios from 'axios';

const publishResponse = await axios.post(
  'https://api.stackvid.dev/api/tiktok/upload',
  {
    videoUrl: 'https://media.yourdomain.com/stackvid-uploads/users/usr_1/video.mp4',
    caption: 'Mẹo phối đồ công sở siêu xinh cho các nàng! #fashion #outfit',
    targetChannel: 'Kênh Thời Trang Hottrend',
    privacyLevel: 0,
    allowComment: true,
    productAnchors: [
      {
        type: 5,
        keyword: 'Áo Sơ Mi Lụa Cao Cấp',
        content: { product_id: '1729482910392817' },
      },
    ],
  },
  {
    headers: { 'X-API-Key': 'tk_live_YOUR_API_KEY' },
  }
);

console.log('Video published successfully:', publishResponse.data);

4. Response Mẫu Khi Đăng Thành Công

json

{
  "success": true,
  "itemId": "7419827391823719283",
  "shareUrl": "https://www.tiktok.com/@thoitrang_hot/video/7419827391823719283",
  "status": "PUBLISHED",
  "creditDeducted": 5,
  "remainingBalance": 45
}

5. Xử lý các lỗi thường gặp

400 Bad Request: videoUrl must be an URL address: Bạn chưa truyền đúng định dạng URL video hợp lệ.
400 Bad Request: No active social channel found: Bạn chưa kết nối kênh TikTok nào hoặc kênh đã kết nối bị hết hạn (EXPIRED). Hãy kiểm tra lại tại trang Quản lý Kênh.
402 Payment Required: Insufficient credit balance: Số dư trong ví của bạn không đủ để thực hiện lệnh đăng (cần tối thiểu 5 Credits). Hãy xem hướng dẫn Nạp tiền tự động qua VietQR.

API Đăng Video Lên TikTok ​

1. Thông số Kỹ thuật & Chi phí ​

2. Các trường dữ liệu hỗ trợ (Payload Parameters) ​

3. Code Mẫu Hoàn Chỉnh ​