Skip to main content
​
url
string
required
Public URL of the media file (image or video)
​
title
string
Asset title
​
description
string
Asset description
​
tags
string[]
Tags for organizing the asset
curl -X POST https://api.usenaive.ai/v1/media/upload/url \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://cdn.example.com/hero-video.mp4",
    "title": "Hero Video",
    "tags": ["hero", "campaign"]
  }'

{
  "id": "asset-uuid",
  "upload_id": "url-1716201600000",
  "url": "https://bucket.fly.storage.tigris.dev/uploads/company-uuid/file-uuid.mp4",
  "filename": "hero-video.mp4",
  "content_type": "video/mp4",
  "size_bytes": 15234567,
  "thumbnail_url": null,
  "source_type": "url_import",
  "source_job_id": null,
  "title": "Hero Video",
  "description": null,
  "tags": ["hero", "campaign"],
  "created_at": "2026-05-20T10:00:00Z",
  "updated_at": "2026-05-20T10:00:00Z"
}
Cost: Free