Bắt đầu nhanh trong 5 phút

Hướng dẫn này sẽ đưa bạn từ bước đăng ký tài khoản đến khi thực hiện thành công cuộc gọi API đầu tiên trên nền tảng StackVid.

---

Bước 1: Đăng ký tài khoản & Nhận 50 Credits miễn phí

1. Truy cập vào trang Đăng ký tài khoản.
2. Nhập Email, Tên hiển thị và Mật khẩu của bạn.
3. Hoàn tất xác nhận bảo mật và bấm Tạo tài khoản.
4. Ngay khi đăng ký thành công, ví tài khoản của bạn sẽ được tặng sẵn 50 complimentary credits để bắt đầu trải nghiệm toàn bộ tính năng.

---

Bước 2: Tạo API Key

Để gọi API từ máy chủ, bot hoặc mã nguồn của bạn, bạn cần một API Key:

1. Đăng nhập vào User Dashboard.
2. Chọn menu API Keys trên thanh điều hướng bên trái.
3. Bấm Create Key, nhập tên gợi nhớ (ví dụ: Production Server hoặc n8n Automation).
4. Hệ thống sẽ sinh ra một khóa có tiền tố tk_live_....
5. ⚠️ Lưu ý: Hãy sao chép và lưu trữ mã khóa này cẩn thận vì hệ thống chỉ hiển thị mã gốc duy nhất một lần.

---

Bước 3: Thực hiện cuộc gọi API đầu tiên (Crawl Video của Creator)

Mở Terminal và chạy lệnh sau để kiểm tra kết nối API và cào thử danh sách video triệu view từ bất kỳ nhà sáng tạo TikTok nào:

cURL

curl -X GET "https://api.stackvid.dev/api/tiktok/user/posts?username=lamine.yamal&count=5" \
  -H "X-API-Key: tk_live_YOUR_API_KEY_HERE"

Node.js

import axios from 'axios';

const res = await axios.get('https://api.stackvid.dev/api/tiktok/user/posts', {
  params: { username: 'lamine.yamal', count: 5 },
  headers: { 'X-API-Key': 'tk_live_YOUR_API_KEY_HERE' },
});

console.log('Videos:', res.data.itemList);

Python

import requests

res = requests.get(
    'https://api.stackvid.dev/api/tiktok/user/posts',
    params={'username': 'lamine.yamal', 'count': 5},
    headers={'X-API-Key': 'tk_live_YOUR_API_KEY_HERE'}
)

print('Videos:', res.json())

---

Bước 4: Thực hiện cuộc gọi API đăng video đầu tiên

Để đăng video lên TikTok, bạn chỉ cần gửi yêu cầu đến POST /api/tiktok/upload kèm đường dẫn videoUrl:

• Nếu đã có sẵn link video trực tiếp (từ CDN, S3, máy chủ của bạn): Truyền thẳng link đó vào trường videoUrl mà không cần gọi API upload nào cả.
• Nếu bạn chỉ có file video cục bộ trên máy tính/server: Sử dụng endpoint Presigned URL POST /api/uploads/presigned-url để tải tệp lên và lấy publicUrl trước khi đăng bài (xem chi tiết tại Cung Cấp Video & Upload Tệp).

Ví dụ gọi API đăng video với link trực tiếp:

cURL

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://cdn.yourdomain.com/videos/first-video.mp4",
    "text": "Video đầu tiên đăng qua StackVid API! #stackvid #automation",
    "targetChannel": "Kênh Thời Trang Hottrend"
  }'

Node.js

import axios from 'axios';

await axios.post(
  'https://api.stackvid.dev/api/tiktok/upload',
  {
    videoUrl: 'https://cdn.yourdomain.com/videos/first-video.mp4',
    text: 'Video đầu tiên đăng qua StackVid API! #stackvid #automation',
    targetChannel: 'Kênh Thời Trang Hottrend',
  },
  {
    headers: { 'X-API-Key': 'tk_live_YOUR_API_KEY' },
  }
);

Chúc mừng! Bạn đã hoàn thành quy trình xuất bản video tự động đầu tiên với StackVid.