sangtao.ai
API key

User Assets

Lấy asset theo ID

Lấy một asset theo ID.

GEThttps://api.sangtao.ai/v2/user-assets/{id}

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ố đường dẫn

  • idstringbắt buộc

    ID trong đường dẫn.

{id} trong đường dẫn là id của asset, ví dụ ua_3kT9qPz0B. id cũ dạng số vẫn được nhận.

Response

Asset, gồm các field sau:

  • 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)

Mã lỗi

MãerrorCodeKhi nào
404ASSET_NOT_FOUNDAsset không tồn tại hoặc không thuộc user
GET/user-assets/{id}
curl "https://api.sangtao.ai/v2/user-assets/ua_3kT9qPz0B" \
  -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"
  }
}