sangtao.ai
API key

Tổng quan

Giới thiệu

API sangtao.ai cho phép bạn tạo ảnh AI (GPT Image), upload ảnh tham chiếu, theo dõi và quản lý job, đăng bài lên mạng xã hội qua tài khoản đã kết nối, quản lý media assets và nhân vật, và lấy danh sách giọng đọc, nhạc nền. Tất cả endpoint theo chuẩn REST và trả về JSON.

/v2 đã ổn định. Tên trường và cách trả về đã công bố được giữ nguyên; có thể có thêm trường mới.

Base URL

https://api.sangtao.ai/v2

Bắt đầu nhanh

  1. Lấy API key

    Tạo key ở trang API key. Copy ngay và giữ trong biến môi trường, không đặt trong code chạy ở trình duyệt.

  2. Gọi API đầu tiên

    Kiểm tra số dư credit — chỉ đọc, không tốn gì:

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

  3. Đọc kết quả

    json
    {
  "success": true,
  "data": {
    "freeCredit": 50,
    "purchasedCredit": 100,
    "lockedCredit": 0,
    "availableCredit": 150
  }
}
    Mọi endpoint trả về cùng một khuôn — xem Định dạng phản hồi bên dưới.

Định dạng phản hồi

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

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

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

Lỗi

Mọi lỗi trả về cùng một khuôn JSON, kèm errorCode để rẽ nhánh — mã trạng thái và mã lỗi xem ở trang Mã lỗi.

Giới hạn tốc độ

Giới hạnGiá trị
Số request mỗi phút, cho mỗi API key6.000
Số job chạy cùng lúc, cho mỗi tài khoảnMặc định 20 — con số của bạn có ở GET /account (limits)
Khoảng cách polling (khuyến nghị)3–5 giây

Các header giới hạn gọi và lỗi 429: Quy ước API.

Trang sauXác thực