Media Onboarding

The simplest way to onboard media. Use the Sureel web app to create a release, upload your media files, and fill in metadata through a guided form.

Steps

1. Navigate to Releases → Create New Release
2. Enter your release metadata (title, artists, release date, etc.)
3. Upload audio files (MP3 or WAV), cover art, and optional lyrics
4. Declare whether any track is a cover song, and set your rights declarations and AI permissions
5. Review and submit your release for processing

For programmatic access to media onboarding. Use the Sureel REST API to automate uploads, manage metadata, and handle large catalogs at scale.

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"
  }'

curl -X POST https://api.sureel.ai/v1/files/generate-upload-urls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "files": [
      { "fileName": "rising_tempest_master.wav", "contentType": "audio/wav" },
      { "fileName": "cover-art.jpg", "contentType": "image/jpeg" }
    ]
  }'

# Upload file to the signed URL returned from generate-upload-urls
curl -X PUT "<signed-upload-url>" \
  --header 'Content-Type: audio/wav' \
  --data-binary @rising_tempest_master.wav

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": "Rising Tempest",
        "isrc": "USRC12345678",
        "artists": ["Artist Name"],
        "labels": ["Label Name"],
        "genres": ["Electronic"],
        "fileId": "<file-id-from-upload>"
      }
    ],
    "coverArt": "<cover-file-id>",
    "aiInfluence": "Generated without AI"
  }'

# 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

1. Contact Sureel to set up your OpenPlay integration (info@sureel.ai)
2. Select which OpenPlay media you want to register with Sureel
3. Generate OpenPlay API keys to grant Sureel access to your catalog
4. Your catalog is automatically synced to the Sureel Registry
5. Ongoing updates are handled automatically, with no manual uploads needed

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

1. Download the CSV or JSON template
2. Populate the template with your catalog metadata (one row/object per track)
3. Prepare your media files in a folder with filenames matching the template
4. Send the completed template and media files to Sureel (info@sureel.ai)
5. Sureel processes and ingests your catalog into the registry

For organizations using the DDEX standard for digital supply chain metadata. Share your DDEX-compliant XML metadata alongside your media files with us via email or directly through our DDEX API endpoint.

Steps

1. Prepare your DDEX-compliant XML metadata files following the ERN (Electronic Release Notification) standard
2. Ensure file references in the XML match the actual filenames of your media files
3. Share your submission with Sureel via email (info@sureel.ai) or via the DDEX API endpoint
4. Sureel validates and ingests your DDEX submission into the registry