Content Onboarding
Register your media assets with the Sureel Registry. The foundation for attribution analysis, opt-in/opt-out management, and IP protection.
Prepare Media
Gather audio, lyrics, images & metadata
Select Method
Choose how to submit your content
Register
Upload content with rights declarations
Manage
Monitor, update & track attribution
What is Content Onboarding?
Content onboarding is how artists, labels, and publishers register their media assets with the Sureel Registry. It is the foundation for attribution analysis, opt-in/opt-out management, and IP protection. The process covers:
- Preparing media: audio, lyrics, images and associated metadata
- Choosing an onboarding method: Frontend, API, OpenPlay, CSV/JSON, or DDEX
- Registering content: with rights declarations and training preferences
- Post-onboarding management: ongoing uploads, monitoring, and attribution
Supported Media & Metadata
What you can onboard and the data we need to register it properly.
Supported Media Types
Audio
Formats: MP3, WAV
Examples: Songs, stems, instrumentals, a cappella
Lyrics
Formats: Text, time-synced
Examples: Song lyrics with optional timing data
Images
Formats: JPG, PNG
Examples: Album art, promotional images, artist photos
Required Metadata
These fields are mandatory for every asset you onboard.
Title
The title of the track, composition, or media asset
Creators
Artist, lyricist, and/or composer names associated with the work
Optional Identifiers
Providing these helps improve matching accuracy and rights tracking.
ISRC
International Standard Recording Code - unique identifier for sound recordings
ISWC
International Standard Musical Work Code - unique identifier for musical works
UPC
Universal Product Code - barcode identifier for the physical/digital release
Release Date
The original or planned release date of the work
Supplementary Metadata
Additional metadata that enriches your catalog and enables more precise attribution.
Rights Splits
Ownership percentages between contributors
Genre
Musical genre classification
Tempo / Key
BPM and musical key of the recording
Publishing Splits
Publishing ownership percentages
Onboarding Methods
Choose the method that best fits your catalog size, technical setup, and workflow.
| Method | Best For | Details |
|---|---|---|
| Frontend Release | Individual artists or small catalogs | Upload via the Sureel web app |
| API Integration | Large catalogs / automation | Token-based auth, bulk upload via REST |
| OpenPlay Integration | OpenPlay users | Fully managed integration by Sureel |
| CSV / JSON | Small/medium catalogs | Download template, populate, upload with media |
| DDEX | Industry-standard workflows | Upload ZIP with DDEX XML + media files |
The simplest way to onboard content. Use the Sureel web app to create a release, upload your media files, and fill in metadata through a guided form.
Steps
- Navigate to Releases → Create New Release
- Enter your release metadata (title, artists, release date, etc.)
- Upload audio files (MP3 or WAV), cover art, and optional lyrics
- Set your rights declarations and AI training preferences
- Review and submit your release for processing
Best for:
Artists managing their own releases, small labels with a handful of releases, or anyone who prefers a visual interface over technical integration.
For programmatic access to content onboarding. Use the Sureel REST API to automate uploads, manage metadata, and handle large catalogs at scale.
Step 1: Authenticate
Obtain an access token using Auth0 client credentials:
curl --request POST \
--url https://sureel.eu.auth0.com/oauth/token \
--header 'content-type: application/json' \
--data '{
"client_id": "<Your-Client-Id>",
"client_secret": "<Your-Client-Secret>",
"audience": "https://api.sureel.ai",
"grant_type": "client_credentials"
}'Step 2: Generate Upload URLs
Request signed upload URLs for your media files:
curl -X POST https://api.sureel.ai/v1/files/generate-upload-urls \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"files": [
{ "fileName": "track-01.wav", "contentType": "audio/wav" },
{ "fileName": "cover-art.jpg", "contentType": "image/jpeg" }
]
}'Step 3: Upload Files
Upload each file to its signed URL:
# Upload file to the signed URL returned from generate-upload-urls
curl -X PUT "<signed-upload-url>" \
--header 'Content-Type: audio/wav' \
--data-binary @track-01.wavStep 4: Create Collection
Create a collection (album/single/EP) with your uploaded files and metadata:
curl -X POST https://api.sureel.ai/v1/ai/artist/upload-artwork \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"collectionName": "My Album",
"releaseDate": "2025-06-15",
"tracks": [
{
"trackTitle": "Track One",
"isrc": "USRC12345678",
"artists": ["Artist Name"],
"labels": ["Label Name"],
"genres": ["Electronic"],
"fileId": "<file-id-from-upload>"
}
],
"coverArt": "<cover-file-id>",
"aiInfluence": "Generated without AI"
}'Step 5: Verify
Check your collections to confirm the upload:
# Check upload/processing status
curl https://api.sureel.ai/v1/ai/artist/collections \
--header 'Authorization: Bearer <token>'If you already use OpenPlay for your catalog management, Sureel offers a fully managed integration. Your existing catalog flows directly into the Sureel Registry with no additional work.
Steps
- Contact Sureel to set up your OpenPlay integration (info@sureel.ai)
- Select which OpenPlay content you want to register with Sureel
- Generate OpenPlay API keys to grant Sureel access to your catalog
- Your catalog is automatically synced to the Sureel Registry
- Ongoing updates are handled automatically, with no manual uploads needed
Fully Managed
The OpenPlay integration is fully managed by Sureel. Once configured, your catalog stays in sync automatically with no ongoing maintenance required.
Download a CSV or JSON template, populate it with your metadata, and upload it along with your media files. Ideal for catalogs where you have metadata in spreadsheets.
Steps
- Download the CSV or JSON template
- Populate the template with your catalog metadata (one row/object per track)
- Prepare your media files in a folder with filenames matching the template
- Send the completed template and media files to Sureel (info@sureel.ai)
- Sureel processes and ingests your catalog into the registry
Template downloads will be available soon. Contact us for the latest template files.
For organizations using the DDEX standard for digital supply chain metadata. Upload a ZIP archive containing DDEX-compliant XML metadata alongside your media files.
Steps
- Prepare your DDEX-compliant XML metadata files following the ERN (Electronic Release Notification) standard
- Package your XML metadata and media files into a ZIP archive
- Ensure file references in the XML match the actual filenames in the archive
- Send the ZIP archive to Sureel (info@sureel.ai)
- Sureel validates and ingests your DDEX submission into the registry
DDEX Standards Supported
We support ERN (Electronic Release Notification) for new releases. Contact us if you use other DDEX message types such as MLC (Musical Works Licensing) or DSR (Sales Reporting).
Label vs Publisher Requirements
Labels and publishers have different content types and metadata needs. Here's what to prepare for each.
| Aspect | Labels | Publishers |
|---|---|---|
| Primary Content | Full tracks + optional stems (vocals, instrumentals, bass, drums) | Composition data (song title, composers with IPI, publishing splits) |
| Required Metadata | Title, artists, ISRC, release date, label name | Song title, composers with IPI numbers, publishing splits, PRO affiliations |
| Supplementary Data | Genre, tempo/key, album art, rights splits | ISWC, territory rights, sub-publisher information |
| Preferred Formats | WAV or MP3 for audio; JPG/PNG for artwork | MIDI, MusicXML, DDEX preferred over PDFs |
| Onboarding Methods | All methods available (Frontend, API, CSV/JSON, DDEX, OpenPlay) | API for bulk automation, DDEX, or CSV/JSON |
For Labels
- Full tracks + optional stems (vocals, instrumentals, bass, drums)
- Core metadata: title, artists, ISRC, release date
- Supplementary: genre, tempo/key, album art, rights splits
For Publishers
- Composition data: song title, composers with IPI numbers
- Publishing splits and PRO affiliations
- Preferred formats: MIDI, MusicXML, DDEX (over PDFs)
Rights & Training Preferences
Declare your rights and control how your content is used in AI training and synthesis.
Rights Declarations
- Master ownership and licensing terms
- Territorial restrictions for distribution
- Exclusive vs. non-exclusive rights declarations
- Songwriter and composer credits with IPI numbers
- Publishing splits between multiple parties
- Mechanical and synchronization rights
- Original work references and licensing
- Derivative work classifications
- Attribution requirements for source material
- Name: stage name and legal name
- Image: photos, album art, brand assets
- Voice: spoken recordings, vocal stems, full tracks
- Video: music videos, performances, interviews
- Persona: biography, lyrics, social handles, interview transcripts
AI Training Preferences
Control whether and how your content is used for AI model training.
Opt-In for AI Training
Allow your content to be used for training AI models. When opted in, your content is eligible for AI training with full attribution tracking, ensuring you receive credit and compensation when your work influences AI outputs.
Opt-Out of AI Training
Prevent your content from being used in AI model training. Your assets are registered in the Do-Not-Train registry, and AI developers can check this registry before training to ensure compliance with your wishes.
Synthesis Rules
Define granular rules for how your content can be used in AI synthesis. Set attribution thresholds (minimum credit percentage), genre restrictions (e.g., only allow use in specific genres), and artist restrictions (exclude specific artists from shared attribution).
Knowledge Acquisition Ratio
The knowledge acquisition ratio measures how much of your original content's characteristics are absorbed by an AI model during training. A higher ratio means the model has learned more from your work, which directly impacts attribution percentages and compensation calculations.
Post-Onboarding
What happens after you upload your content, and how to manage it going forward.
Processing Pipeline
After your content is submitted, it goes through these stages:
Content Validation
Your uploaded media and metadata are validated for format compliance, completeness, and data integrity.
Secure Migration
Validated content is securely transferred to the Sureel Registry with encryption at rest and in transit.
Registry Indexing
Your content is fingerprinted and indexed in the 12M+ asset registry, enabling attribution analysis and rights tracking.
Ongoing Management
After onboarding, you can continue uploading new content and managing your catalog:
- Scheduled API calls: Automate ongoing uploads with cron jobs or CI/CD pipelines
- Manual uploads: Use the web app or CSV/JSON for ad-hoc additions
- Metadata updates: Update rights, splits, and preferences via the API or web app
Explore Sureel Features
With your content in the registry, unlock the full power of Sureel:
Attribution Analysis
Discover which AI outputs were influenced by your content with similarity-based and causal attribution.
Go to Attribution Analysis →Registry Metrics
Monitor your catalog's presence in the registry and track how your content is being used.
View Registry Metrics →Attribution Metrics
Track attribution events and see when your content influences AI outputs across the ecosystem.
View Attribution Metrics →AI Detection
Determine whether audio is AI-generated, human-created, or mixed. Identify which specific AI generator was used.
Try AI Detection →Stem Split
Separate tracks into individual stems (vocals, instrumentals, bass, drums) for per-stem attribution.
Try Stem Split →