API Reference

Tài liệu API

Tích hợp sangtao.ai vào ứng dụng của bạn qua REST API.

Giới thiệu

API sangtao.ai cho phép bạn tạo video, voiceover và hình ảnh bằng AI qua lập trình. Tất cả endpoint theo chuẩn REST và trả về JSON.

Base URL

https://sangtao.ai/api/v2

Thử gọi API đầu tiên — kiểm tra số dư credit (không tốn gì, chỉ đọc):

bash

curl https://sangtao.ai/api/v2/account/balance \
  -H "X-Api-Key: YOUR_API_KEY"

Kết quả:

json

{
  "success": true,
  "data": {
    "freeCredit": 50,
    "purchasedCredit": 100,
    "lockedCredit": 0,
    "availableCredit": 150
  }
}

Tip: Lấy API key tại Cài đặt → API Key trong dashboard sangtao.ai.

API bao phủ toàn bộ quy trình tạo video — từ kịch bản đến video hoàn chỉnh:

Render VideoPOST

Bạn đã có ảnh/video + audio? Ghép chúng thành video hoàn chỉnh với layout, hiệu ứng, chuyển cảnh và phụ đề.

/render/video

Video từ kịch bảnPOST

Viết kịch bản, chọn giọng đọc — AI tự động tạo ảnh minh họa và giọng đọc, rồi render video hoàn chỉnh.

/voiceover-videos/create

Video StockPOST

Tương tự Voiceover Video, nhưng dùng footage stock thật thay vì ảnh AI. Phù hợp cho nội dung tin tức hoặc chuyên nghiệp.

/stock-videos/create

Video SlideshowPOST

Có danh sách ảnh + câu chuyện? Biến chúng thành video slideshow có giọng đọc AI và nhạc nền.

/slideshow-videos/create

Bài báo → VideoPOST

Dán URL bài báo — AI crawl nội dung, tóm tắt, tìm hình ảnh, tạo giọng đọc và render video hoàn chỉnh.

/article-videos/create

• Bạn có danh sách ảnh + câu chuyện — tạo video slideshow có giọng đọc AI và nhạc nền

• Trang tin của bạn đăng bài báo — tự động chuyển mỗi bài thành video có narration cho mạng xã hội

• Bạn có kịch bản và muốn footage chuyên nghiệp — tạo video với hình ảnh thật và giọng đọc AI

• Bạn xây dựng công cụ sáng tạo nội dung — tích hợp API để user tạo video ngay trên nền tảng của bạn

• Bạn đã có sẵn tài nguyên (ảnh, file audio) — ghép chúng thành video hoàn chỉnh với chuyển cảnh và hiệu ứng

Tất cả endpoint trả về JSON theo format thống nhất:

JSON

// Success
{ "success": true, "data": { ... } }

// Error
{ "success": false, "error": "Error message" }

Mã	Ý nghĩa	Cách xử lý
200	Thành công	Parse field data
400	Lỗi validation	Kiểm tra error message và sửa request
401	Chưa xác thực	Kiểm tra API key hoặc refresh token
402	Không đủ credit	Nạp thêm credit trước khi thử lại
404	Không tìm thấy	Kiểm tra URL endpoint hoặc resource ID
429	Rate limited	Đợi và thử lại sau thời gian chỉ định
500	Lỗi server	Thử lại sau vài giây. Liên hệ support nếu lỗi liên tục

Giới hạn	Giá trị
Số job đồng thời tối đa per user	4 (shared across tất cả endpoint)
Số article-video job tối đa toàn hệ thống	30
Khoảng cách polling (khuyến nghị)	3–5 giây