REST API v1.2 (Latest)

Developer Registry

High-fidelity programmatic interface. Optimized for automated migrations and massive ingestion pipelines.

Video Ingestion

The modelId field is polymorphic: it accepts either the creator's Internal UUID or their Unique Slug.

POST /api/v1/upload

Field	Type	Description
modelId	string	UUID or slug of the creator.
video_url	url	Direct MP4 link.

CURL Example

curl -X POST https://freeof.qzz.io/api/v1/upload \
  -H "Content-Type: application/json" \
  -d '{
    "title": "4K Cinematic Forest Walk",
    "description": "High-fidelity drone footage...",
    "modelId": "riley-reid",
    "video_url": "https://cdn.example.com/vid.mp4",
    "thumbnail_url": "https://cdn.example.com/thumb.jpg",
    "duration": 630,
    "resolution": "4K",
    "orientation": "landscape",
    "type": "normal",
    "tags": ["nature", "4k"]
  }'