sangtao.ai
API key

User Assets

List assets

List your assets, filtered by category or purpose.

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

Authorization

  • X-Api-Keystring · headerrequired

    Your API key, from the API keys page of your account.

Query parameters

  • categorystring

    Filter by category

    Available options:videoimageaudiodocument

  • purposestring

    Filter by purpose

    Available options:outro_videointro_videologowatermarkbackground_musicvoiceoverthumbnailgeneral

  • pageint

    Page number, from 1. Leave out page and pageSize to get everything.

  • pageSizeint

    Items per page. Default 50, at most 200. limit is accepted as the same thing.

The total, across all pages, is in the X-Total-Count header.

Response

  • idstringrequired

    Asset ID, ua_ followed by 9 letters and digits (e.g. "ua_3kT9qPz0B")

  • urlstringrequired

    Public URL of the asset

  • fileNamestringrequired

    Original file name

  • mimeTypestringrequired

    MIME type (e.g. "video/mp4")

  • fileSizeBytesnumberrequired

    File size in bytes

  • categorystringrequired

    Auto-detected

    Available options:videoimageaudiodocument

  • purposestringrequired

    Asset purpose

    Available options:outro_videointro_videologowatermarkbackground_musicvoiceoverthumbnailgeneral

  • labelstring

    Display label (nullable)

  • thumbnailUrlstring

    Thumbnail URL (nullable)

  • durationSecnumber

    Duration in seconds (video/audio)

  • aspectRatiostring

    Aspect ratio

  • hasAudioboolean

    Whether file has audio track (video/audio)

  • createdAtstring

    ISO 8601 creation timestamp

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"
    }
  ]
}