Assets

The Assets API allows you to manage media assets used in your video templates and personalizations.

List Assets

GET/assets

Retrieves a list of assets in your account.

Query Parameters

Parameter	Type	Description
page	integer	Optional Page number for pagination (default: 1)
limit	integer	Optional Number of items per page (default: 20, max: 100)
type	string	Optional Filter by asset type (image, video, audio)
tag	string	Optional Filter by tag

Response

{
  "data": [
    {
      "id": "asset_12345abcde",
      "name": "Company Logo",
      "type": "image",
      "url": "https://cdn.sixtyseconds.video/assets/asset_12345abcde.png",
      "content_type": "image/png",
      "size": 24680,
      "width": 512,
      "height": 512,
      "duration": null,
      "tags": ["logo", "branding"],
      "created_at": "2025-02-10T08:30:00Z"
    },
    {
      "id": "asset_67890fghij",
      "name": "Background Music",
      "type": "audio",
      "url": "https://cdn.sixtyseconds.video/assets/asset_67890fghij.mp3",
      "content_type": "audio/mpeg",
      "size": 2457600,
      "width": null,
      "height": null,
      "duration": 60.5,
      "tags": ["music", "upbeat"],
      "created_at": "2025-02-11T14:45:00Z"
    }
  ],
  "pagination": {
    "total": 35,
    "page": 1,
    "limit": 20,
    "next_page": 2,
    "prev_page": null
  }
}

Upload Asset

POST/assets

Uploads a new asset to your account.

Request Body (multipart/form-data)

Parameter	Type	Description
file	file	Required The file to upload
name	string	Required Name of the asset
type	string	Required Type of asset (image, video, audio)
tags	array	Optional Array of tags for the asset

Response

{
  "id": "asset_abcdef12345",
  "name": "Product Image",
  "type": "image",
  "url": "https://cdn.sixtyseconds.video/assets/asset_abcdef12345.jpg",
  "content_type": "image/jpeg",
  "size": 153428,
  "width": 1200,
  "height": 800,
  "duration": null,
  "tags": ["product", "marketing"],
  "created_at": "2025-03-05T11:20:30Z"
}

Get Asset

GET/assets/{asset_id}

Retrieves information about a specific asset.

Path Parameters

Parameter	Type	Description
asset_id	string	Required The ID of the asset to retrieve

Response

{
  "id": "asset_12345abcde",
  "name": "Company Logo",
  "type": "image",
  "url": "https://cdn.sixtyseconds.video/assets/asset_12345abcde.png",
  "content_type": "image/png",
  "size": 24680,
  "width": 512,
  "height": 512,
  "duration": null,
  "tags": ["logo", "branding"],
  "created_at": "2025-02-10T08:30:00Z",
  "last_used": "2025-02-15T09:45:00Z",
  "used_in_videos": 12,
  "used_in_templates": 3
}

Delete Asset

DELETE/assets/{asset_id}

Deletes an asset from your account.

Path Parameters

Parameter	Type	Description
asset_id	string	Required The ID of the asset to delete

Response

{
  "id": "asset_12345abcde",
  "deleted": true
}

Warning

Deleting an asset that is currently used in active videos or templates may cause those videos to render incorrectly. Check the used_in_videos and used_in_templates counts before deleting.

Update Asset

PUT/assets/{asset_id}

Updates an asset's metadata.

Path Parameters

Parameter	Type	Description
asset_id	string	Required The ID of the asset to update

Request Body

Parameter	Type	Description
name	string	Optional New name for the asset
tags	array	Optional Updated array of tags

Example Request

{
  "name": "Updated Logo 2025",
  "tags": ["logo", "branding", "2025"]
}

Response

{
  "id": "asset_12345abcde",
  "name": "Updated Logo 2025",
  "type": "image",
  "url": "https://cdn.sixtyseconds.video/assets/asset_12345abcde.png",
  "content_type": "image/png",
  "size": 24680,
  "width": 512,
  "height": 512,
  "duration": null,
  "tags": ["logo", "branding", "2025"],
  "created_at": "2025-02-10T08:30:00Z",
  "updated_at": "2025-03-05T15:10:20Z"
}

Asset Types

The platform supports the following asset types:

Type	Description	Supported Formats
image	Static images	JPG, PNG, SVG, WEBP
video	Video clips	MP4, WEBM, MOV
audio	Audio files	MP3, WAV, AAC

Working with Assets

Asset Usage

Assets can be referenced in your video templates and when creating personalized videos. To use an asset, include its ID in the appropriate field of your template or video creation request.

Asset Storage

Assets are stored on our secure CDN and are available for use immediately after upload. The URL for each asset is provided in the response and can be used for preview purposes.

File Size Limits

The following file size limits apply:

• Images: Up to 10MB
• Videos: Up to 200MB
• Audio: Up to 50MB

Optimizing Assets

For best performance, we recommend the following:

• Images: Use PNG for logos and graphics with transparency, JPEG for photos
• Videos: Use MP4 with H.264 encoding at a reasonable bitrate (2-5 Mbps)
• Audio: Use MP3 format at 192-320 kbps for music, 128 kbps for voice