Skip to main content
POST
Upload media to collection
Upload videos, audio files, or images to a collection from URLs or local files.
  • Supports video, audio, and image files
  • Use media_type parameter to specify type explicitly
  • Large files should use callback_url for async processing

Upload Guide

Supported formats and upload methods

Production Patterns

Batch uploads, webhooks, and retry logic

Authorizations

x-access-token
string
header
required

API key for authentication (sk-xxx format)

Path Parameters

collection_id
string
required
Example:

"default"

Body

application/json
url
string
required
Example:

"https://example.com/video.mp4"

name
string
Example:

"My Video"

media_type
enum<string>
Available options:
video,
audio,
image
Example:

"video"

callback_url
string
Example:

"https://webhook.example.com/callback"

Response

200 - application/json

Upload initiated

success
boolean
Example:

true

status
enum<string>
Available options:
processing,
done,
failed
Example:

"processing"

data
object