sangtao.ai
API key

User Assets

Danh sách assets

Danh sách assets của bạn, lọc theo category hoặc purpose.

GEThttps://api.sangtao.ai/v2/user-assets

Xác thực

  • X-Api-Keystring · headerbắt buộc

    API key của bạn, tạo ở trang API key trong tài khoản.

Tham số query

  • categorystring

    Lọc theo category

    Giá trị có thể:videoimageaudiodocument

  • purposestring

    Lọc theo purpose

    Giá trị có thể:outro_videointro_videologowatermarkbackground_musicvoiceoverthumbnailgeneral

  • pageint

    Số trang, từ 1. Bỏ trống cả page lẫn pageSize thì nhận hết.

  • pageSizeint

    Số mục mỗi trang. Mặc định 50, tối đa 200. Gửi limit cũng được, cùng nghĩa.

Tổng số, tính mọi trang, nằm ở header X-Total-Count.

Response

  • idstringbắt buộc

    ID của asset, ua_ cộng 9 ký tự chữ và số (ví dụ "ua_3kT9qPz0B")

  • urlstringbắt buộc

    URL công khai của asset

  • fileNamestringbắt buộc

    Tên file gốc

  • mimeTypestringbắt buộc

    MIME type (ví dụ "video/mp4")

  • fileSizeBytesnumberbắt buộc

    Kích thước (bytes)

  • categorystringbắt buộc

    Tự phát hiện

    Giá trị có thể:videoimageaudiodocument

  • purposestringbắt buộc

    Mục đích asset

    Giá trị có thể:outro_videointro_videologowatermarkbackground_musicvoiceoverthumbnailgeneral

  • labelstring

    Nhãn hiển thị (nullable)

  • thumbnailUrlstring

    URL thumbnail (nullable)

  • durationSecnumber

    Thời lượng (video/audio)

  • aspectRatiostring

    Tỷ lệ khung

  • hasAudioboolean

    File có audio track không (video/audio)

  • createdAtstring

    Thời điểm tạo (ISO 8601)

GET/user-assets
curl "https://api.sangtao.ai/v2/user-assets?purpose=logo&page=1&pageSize=50" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": [
    {
      "id": "ua_3kT9qPz0B",
      "url": "https://blob.sangtao.ai/user-assets/abc123/my-logo.png",
      "fileName": "my-logo.png",
      "mimeType": "image/png",
      "fileSizeBytes": 245000,
      "category": "image",
      "purpose": "logo",
      "label": "My Brand Logo",
      "thumbnailUrl": null,
      "durationSec": null,
      "aspectRatio": null,
      "hasAudio": false,
      "createdAt": "2026-06-08T10:30:00Z"
    }
  ]
}