{"openapi":"3.0.0","info":{"title":"Sureel API","description":"### 🔐 OAuth Authentication\nTo access the Sureel API, the following set of variables will be necessary:\n\n {\n \"auth_url\": \"https://sureel.eu.auth0.com/oauth/token\",\n \"client_id\": \"\",\n \"client_secret\": \"\",\n \"audience\": \"https://api.sureel.ai\"\n }\n\nNote: We provide the `client_id` and `client_secret` separately.\n\n**Token Request Example:**\n\n curl --request POST \\\n --url https://sureel.eu.auth0.com/oauth/token \\\n --header 'content-type: application/json' \\\n --data '{\n \"client_id\": \"\",\n \"client_secret\": \"\",\n \"audience\": \"https://api.sureel.ai\",\n \"grant_type\": \"client_credentials\"\n }'\n\nInclude the token in your API requests:\n\n Authorization: Bearer \n\n**Troubleshooting**\n- Ensure your token hasn’t expired\n- Check the Authorization header format\n- Confirm you're using the correct audience\n\n\n### 📥 Getting the Request Result\nYou can retrieve processing results in two ways:\n\n- **Polling**:\n For audio requests, retrieve results from the /v1/ai/audio-ldm/{requestId} endpoint; for image requests, use the /v1/ai/ldm/{requestId} endpoint.\nMake sure the `requestId` is obtained from the POST response. Processing time may vary.\n\n- **Webhooks**:\nInclude a `webhook_url` (and optional `webhook_key`) in your POST body to receive results asynchronously.\n\n**Troubleshooting**\n- Verify the webhook URL is publicly accessible\n- Check that your server handles the webhook key\n- Ensure the request is fully processed\n\n\n### 📦 Using the SDK\nIf you're building with Node.js or TypeScript, you can use our official SDK for easier integration: @sureel/sdk on npm.\n\n### 🧠 Reading Temporal Attribution Results\n- `duration`: Length (in seconds) of each analysis window\n- `period`: Interval (in seconds) between segment starts\n\nIf `duration > period`, the analysis uses overlapping segments to improve accuracy.\nIf both values are `-1`, the full song is analyzed in one pass.","version":""},"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://sureel.eu.auth0.com/oauth/token","scopes":{"read:ldm":"read:ldm"}}}}},"schemas":{}},"paths":{"/v1/ai/ai-model-artifacts/track-ai-training-artifacts":{"post":{"operationId":"trackTrainingArtifacts","summary":"Track training artifacts","tags":["ai-model-artifacts"],"description":"Track training artifacts for audio AI models.","requestBody":{"content":{"application/json":{"schema":{"title":"TrackTrainingArtifactsBody","type":"object","properties":{"model_name":{"description":"Name of the model including version.","type":"string"},"audio_id":{"description":"ID of the audio file.","type":"string"},"captions_file":{"description":"File path to the captions file. The 'captions_file' can either be a file URL or the key returned from the `/files/upload-files` endpoint. Supported formats include .JSON.","type":"string"},"training_artifacts":{"title":"TrainingArtifact","description":"List of training artifacts.","type":"array","items":{"title":"TrainingArtifactEntry","type":"object","properties":{"stem_combination":{"description":"Stem combination used for training.","default":"master","type":"string"},"stem_input_association_file":{"description":"File path to the stem input association file. The 'stem_input_association_file' can either be a file URL or the key returned from the `/files/upload-files` endpoint. Supported formats include .JSON.","type":"string"},"conditioning_file":{"description":"File path to the conditioning file. The 'conditioning_file' can either be a file URL or the key returned from the `/files/upload-files` endpoint. Supported formats include .NPY.","type":"string"},"artifacts_per_epoch":{"title":"ArtifactsPerEpoch","description":"List of artifacts per epoch.","type":"array","items":{"title":"ArtifactsPerEpochEntry","type":"object","properties":{"epoch":{"description":"Epoch number.","type":"number"},"artifacts_file":{"description":"File path to the artifacts file. The 'artifacts_file' can either be a file URL or the key returned from the `/files/upload-files` endpoint. Supported formats include .NPY.","type":"string"}},"required":["epoch","artifacts_file"]}}},"required":["stem_combination","conditioning_file","artifacts_per_epoch"]}}},"required":["model_name","audio_id","captions_file","training_artifacts"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/ai-model-artifacts/track-ai-inference-artifacts":{"post":{"operationId":"trackInferenceArtifacts","summary":"Track inference artifacts","tags":["ai-model-artifacts"],"description":"Track inference artifacts for audio AI models.","requestBody":{"content":{"application/json":{"schema":{"title":"TrackInferenceArtifactsBody","type":"object","properties":{"model_name":{"description":"Name of the model including version.","type":"string"},"inference_request_id":{"description":"Unique identifier for the inference request, used to track the process.","type":"string"},"text_inputs_file":{"description":"File path to the text inputs file. The 'text_inputs_file' can either be a file URL or the key returned from the `/files/upload-files` endpoint. Supported formats include .JSON.","type":"string"},"content_audios":{"title":"ContentAudios","description":"List of input content audio files. Each item can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"array","items":{"type":"string"}},"style_audios":{"title":"StyleAudios","description":"List of input style audio files. Each item can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"array","items":{"type":"string"}},"output_audios":{"title":"OutputAudios","description":"List of the resulting output audio files from inference. Each item can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"array","items":{"type":"string"}},"artifacts_file":{"description":"File path to the artifacts file. The 'artifacts_file' can either be a file URL or the key returned from the `/files/upload-files` endpoint. Supported formats include .NPY.","type":"string"},"conditioning_file":{"description":"File path to the conditioning file. The 'conditioning_file' can either be a file URL or the key returned from the `/files/upload-files` endpoint. Supported formats include .NPY.","type":"string"}},"required":["model_name","inference_request_id","text_inputs_file","content_audios","style_audios","output_audios","artifacts_file","conditioning_file"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/asset-metadata/":{"get":{"operationId":"getAssetMetadata","summary":"Get asset metadata","tags":["asset-metadata"],"description":"Retrieve asset metadata by using fileId.","parameters":[{"schema":{"type":"string"},"in":"query","name":"fileId","required":true,"description":"File ID is use to get the metadata of the file."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetAssetMetadataResponse","type":"object","properties":{"files":{"title":"Files","type":"array","items":{"title":"AssetMetadataRecord","type":"object","properties":{"original_filename":{"type":"string"},"file_id":{"type":"string"},"isrc":{"type":"string"},"collection_uuid":{"type":"string"},"username":{"type":"string"},"created_at":{"type":"number"},"updated_at":{"type":"number"},"file_path":{"type":"string"},"track_title":{"type":"string"},"external_track_id":{"type":"string"},"external_url":{"type":"string"},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"artist_names":{"deprecated":true,"title":"ArtistNames","type":"array","items":{"type":"string"}},"labels":{"title":"Labels","type":"array","items":{"type":"string"}},"cover":{"type":"boolean"},"instrumental":{"type":"boolean"},"acapella":{"type":"boolean"},"is_stem":{"type":"boolean"},"stem_type":{"type":"string"},"external_stems":{"title":"ExternalStems","type":"array","items":{"title":"ExternalStem","type":"object","properties":{"stem_file_path":{"type":"string"},"stem_type":{"type":"string"},"original_stem_filename":{"type":"string"}},"required":["stem_file_path","stem_type","original_stem_filename"]}},"genres":{"title":"Genres","type":"array","items":{"type":"string"}},"duration":{"type":"number"},"bpm":{"type":"number"},"key":{"type":"string"},"pitch":{"type":"string"},"mood":{"type":"string"},"danceability":{"type":"number"},"instruments":{"title":"Instruments","type":"array","items":{"type":"string"}},"time_signature":{"type":"string"},"song_characteristics":{"type":"string"},"themes":{"title":"Themes","type":"array","items":{"type":"string"}},"age_group":{"type":"string"},"gender":{"type":"string"},"personality":{"type":"string"},"audio_language":{"type":"string"},"release_date":{"type":"string"},"explicit":{"type":"boolean"},"lyrics":{"type":"string"},"recording_studio":{"type":"string"},"publisher":{"type":"string"},"producer":{"type":"string"},"composer":{"type":"string"},"song_writer":{"type":"string"},"rights_administrator":{"type":"string"},"rights_owner":{"type":"string"},"ai_influence":{"type":"string"},"content_rights":{"title":"ContentRights","type":"object","properties":{"recording_rights":{"type":"boolean"},"publishing_rights":{"type":"boolean"},"cover_or_derivative_work":{"type":"boolean"}},"required":["recording_rights","publishing_rights","cover_or_derivative_work"]},"spotify_url":{"type":"string"},"spotify_id":{"type":"string"},"is_spotify_url":{"type":"boolean"}},"required":["file_id"]}}},"required":["files"]}}}}}},"put":{"operationId":"updateAssetMetadata","summary":"Update asset metadata","tags":["asset-metadata"],"description":"Update asset metadata by using fileId.","requestBody":{"content":{"application/json":{"schema":{"title":"UpdateAssetMetadataBody","type":"object","properties":{"track_title":{"description":"The title of the song.","type":"string"},"isrc":{"description":"The ISRC (International Standard Recording Code) is a unique identifier for a sound recording.","type":"string"},"external_track_id":{"description":"The external ID is the ID of the collection/release/album/compilation in another system, e.g. OpenPlay. This ID can be used to reference the content.","type":"string"},"external_url":{"description":"The external URL of the song in another system.","type":"string"},"artist_names":{"title":"ArtistNames","deprecated":true,"description":"The name of the artists that contributed to the song.","type":"array","items":{"type":"string"}},"labels":{"title":"Labels","description":"The name of the label that published the song.","type":"array","items":{"type":"string"}},"cover":{"description":"Indicates whether the song is a cover.","type":"boolean"},"instrumental":{"description":"Indicates whether the song is instrumental.","type":"boolean"},"acapella":{"description":"Indicates whether the song is acapella.","type":"boolean"},"is_stem":{"description":"Indicates whether the file provided under `filePath` is a stem (e.g., a single instrument or vocal track).","type":"boolean"},"stem_type":{"description":"Specifies the type of stem if `isStem` is true (e.g., vocals, bass, drums).","type":"string"},"genres":{"title":"Genres","description":"The genres and subgenres of the song.","type":"array","items":{"type":"string"}},"duration":{"description":"The duration of the song in seconds.","type":"number"},"bpm":{"description":"The tempo of the song in beats per minute.","type":"number"},"key":{"description":"The key of the song.","type":"string"},"pitch":{"description":"The pitch of the song.","type":"string"},"mood":{"description":"The mood of the song.","type":"string"},"danceability":{"description":"The danceability of the song.","type":"number"},"instruments":{"title":"Instruments","description":"The instruments used in the song.","type":"array","items":{"type":"string"}},"time_signature":{"description":"The time signature of the song.","type":"string"},"song_characteristics":{"description":"The characteristics of the song.","type":"string"},"themes":{"title":"Themes","description":"The themes of the song.","type":"array","items":{"type":"string"}},"age_group":{"description":"The age group the song is intended for.","type":"string"},"gender":{"description":"The gender the song is intended for.","type":"string"},"personality":{"description":"The personality of the song.","type":"string"},"audio_language":{"description":"For music, you can set the audio language of the songs.","type":"string"},"release_date":{"description":"The release date of the song. The format is YYYY-MM-DD.","type":"string"},"explicit":{"description":"Indicates whether the song contains explicit content.","type":"boolean"},"lyrics":{"description":"The lyrics of a song.","type":"string"},"recording_studio":{"description":"For music, you can set the recording studio.","type":"string"},"publisher":{"description":"For music, you can set the publisher.","type":"string"},"producer":{"description":"For music, you can set the producer.","type":"string"},"composer":{"description":"The person who writes the music for a song.","type":"string"},"song_writer":{"description":"The person who writes the lyrics and melody of a song.","type":"string"},"rights_administrator":{"description":"A publishing administrator or specialized entity responsible for handling administrative tasks related to rights.","type":"string"},"rights_owner":{"description":"The owner of a copyrighted work who has rights to reproduce, distribute, publicly perform, display, and adapt the copyrighted material.","type":"string"},"ai_influence":{"description":"Whether the uploaded images are completely generated without AI, refined with AI, AI generated, or the AI influnce is unknown.","title":"aiInfluence","anyOf":[{"type":"string","enum":["Generated without AI"]},{"type":"string","enum":["AI refined"]},{"type":"string","enum":["AI generated"]},{"type":"string","enum":["Unknown"]}]},"content_rights":{"title":"ContentRights","description":"The content rights for the file. ","type":"object","properties":{"recording_rights":{"description":"Set to true if the recording rights are owned by the artist.","type":"boolean"},"publishing_rights":{"description":"Set to true if the publishing rights are owned by the artist.","type":"boolean"},"cover_or_derivative_work":{"description":"Set to true if the song is a cover or derivative work.","type":"boolean"}},"required":["recording_rights","publishing_rights","cover_or_derivative_work"]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"query","name":"fileId","required":true,"description":"File ID is use to update the metadata of object"}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PutAssetMetadataResponse","type":"object","properties":{"file":{"title":"AssetMetadataRecord","type":"object","properties":{"original_filename":{"type":"string"},"file_id":{"type":"string"},"isrc":{"type":"string"},"collection_uuid":{"type":"string"},"username":{"type":"string"},"created_at":{"type":"number"},"updated_at":{"type":"number"},"file_path":{"type":"string"},"track_title":{"type":"string"},"external_track_id":{"type":"string"},"external_url":{"type":"string"},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"artist_names":{"deprecated":true,"title":"ArtistNames","type":"array","items":{"type":"string"}},"labels":{"title":"Labels","type":"array","items":{"type":"string"}},"cover":{"type":"boolean"},"instrumental":{"type":"boolean"},"acapella":{"type":"boolean"},"is_stem":{"type":"boolean"},"stem_type":{"type":"string"},"external_stems":{"title":"ExternalStems","type":"array","items":{"title":"ExternalStem","type":"object","properties":{"stem_file_path":{"type":"string"},"stem_type":{"type":"string"},"original_stem_filename":{"type":"string"}},"required":["stem_file_path","stem_type","original_stem_filename"]}},"genres":{"title":"Genres","type":"array","items":{"type":"string"}},"duration":{"type":"number"},"bpm":{"type":"number"},"key":{"type":"string"},"pitch":{"type":"string"},"mood":{"type":"string"},"danceability":{"type":"number"},"instruments":{"title":"Instruments","type":"array","items":{"type":"string"}},"time_signature":{"type":"string"},"song_characteristics":{"type":"string"},"themes":{"title":"Themes","type":"array","items":{"type":"string"}},"age_group":{"type":"string"},"gender":{"type":"string"},"personality":{"type":"string"},"audio_language":{"type":"string"},"release_date":{"type":"string"},"explicit":{"type":"boolean"},"lyrics":{"type":"string"},"recording_studio":{"type":"string"},"publisher":{"type":"string"},"producer":{"type":"string"},"composer":{"type":"string"},"song_writer":{"type":"string"},"rights_administrator":{"type":"string"},"rights_owner":{"type":"string"},"ai_influence":{"type":"string"},"content_rights":{"title":"ContentRights","type":"object","properties":{"recording_rights":{"type":"boolean"},"publishing_rights":{"type":"boolean"},"cover_or_derivative_work":{"type":"boolean"}},"required":["recording_rights","publishing_rights","cover_or_derivative_work"]},"spotify_url":{"type":"string"},"spotify_id":{"type":"string"},"is_spotify_url":{"type":"boolean"}},"required":["file_id"]}},"required":["file"]}}}}}}},"/v1/ai/analysis-history/":{"get":{"operationId":"getAnalysisHistory","summary":"Analysis history","tags":["analysis-history"],"description":"Retrieve the history of previous analysis requests (such as attribution analysis or AI detection) by using cursor-based pagination.","parameters":[{"schema":{"type":"number"},"in":"query","name":"take","required":true,"description":"The 'take' parameter is the number of items to be returned per page."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"The optional `cursor` parameter is the `lastEvaluatedKey` in the previous page."},{"schema":{"type":"number"},"in":"query","name":"maxTimestamp","required":false,"description":"The optional `maxTimestamp` parameter, expressed in milliseconds, can be used to filter transactions up to a certain timestamp."},{"schema":{"title":"AnalysisRequestType","anyOf":[{"type":"string","enum":["/audio-attribution-analysis"]},{"type":"string","enum":["/calculate-audio-attribution"]},{"type":"string","enum":["/opt-out-analysis"]},{"type":"string","enum":["/accidental-infringement-check"]},{"type":"string","enum":["/ai-generated-audio-detection"]},{"type":"string","enum":["/lyrics-analysis"]},{"type":"string","enum":["/similar-song-finder"]},{"type":"string","enum":["/song-analysis"]},{"type":"string","enum":["/stem-split"]},{"type":"string","enum":["/attribution-analysis"]},{"type":"string","enum":["/calculate-image-attribution"]},{"type":"string","enum":["/calculate-provenance"]}]},"in":"query","name":"requestType","required":false,"description":"Specifies the type of the request to retrieve. Possible values: `/audio-attribution-analysis`, `/calculate-audio-attribution`, `/opt-out-analysis`, `/accidental-infringement-check`, `/ai-generated-audio-detection`, `/lyrics-analysis`, `/similar-song-finder`, `/song-analysis`, `/stem-split`, `/attribution-analysis`, `/calculate-image-attribution`, `/calculate-provenance`."},{"schema":{"default":5,"minimum":-1,"type":"integer"},"in":"query","name":"topNAttributionResults","required":false,"description":"Specifies the number of top attribution results to be returned. A value of -1 indicates that all attribution results should be returned."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetAnalysisHistoryResponse","type":"object","properties":{"analysisHistory":{"title":"AnalysisHistory","type":"array","items":{"title":"AnalysisHistoryEntry","type":"object","properties":{"status":{"anyOf":[{"title":"UserRequestStatus","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]}]},{"title":"UserRequestStatus","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]}]}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"string"}]},"endpoint":{"anyOf":[{"type":"string"},{"type":"string"}]},"requestId":{"anyOf":[{"type":"string"},{"type":"string"}]},"request_body":{"anyOf":[{},{}]},"createdAt":{"anyOf":[{"type":"number"},{"type":"number"}]},"imagesSignedUrls":{"title":"ImagesSignedUrls","type":"array","items":{"type":"string"}},"previewImagesSignedUrls":{"title":"PreviewImagesSignedUrls","type":"array","items":{"type":"string"}},"attribution":{"anyOf":[{"title":"Attribution","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","anyOf":[{"type":"null"},{"title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}]},{"title":"Attribution","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","anyOf":[{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}},{"type":"null"}]}]},"provenance":{"anyOf":[{"title":"Provenance","anyOf":[{"type":"null"},{"title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}]},{"title":"Provenance","anyOf":[{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}},{"type":"null"}]}]},"contentImage":{"type":"string"},"styleImage":{"type":"string"},"maskImage":{"type":"string"},"artistProfilePictures":{"anyOf":[{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"}},"required":["artistName","picture"]}}]},{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"}},"required":["artistName","picture"]}}]}]},"seed":{"anyOf":[{"type":"number"},{"type":"number"}]},"requestData":{"anyOf":[{"title":"GetLdmRequestData","type":"object","properties":{"user_id":{"type":"string"},"request_id":{"type":"string"},"apply_watermark":{"type":"boolean"},"custom_watermark":{"title":"CustomWatermark","anyOf":[{"type":"null"},{"type":"string"}]},"artist_preset":{"title":"ArtistPresets","type":"array","items":{"title":"ArtistPresetsInner","type":"object","properties":{"collection_uuid":{"type":"string"},"preset_attribution":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"artist":{"type":"string"}}}},"batch_size":{"type":"number"},"negative_prompt":{"type":"string"},"remove_bg":{"type":"boolean"},"resolution":{"type":"string"},"seed":{"title":"Seed","anyOf":[{"type":"number"},{"type":"null"}]},"style_preset":{"title":"StylePreset","anyOf":[{"type":"null"},{"type":"string"}]},"upscale":{"title":"Upscale","anyOf":[{"type":"null"},{"type":"number"}]},"controlnet":{"title":"ControlNetData","type":"object","properties":{"conditioning_scale":{"title":"ConditioningScale","anyOf":[{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"},{"title":"ConditioningScaleArray","type":"array","items":{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"}},{"type":"null"}]},"guidance_start":{"type":"number"},"guidance_end":{"type":"number"}}},"artist_uuid":{"type":"string"},"train_text_encoder":{"type":"boolean"},"num_train_steps":{"type":"integer"},"learning_rate":{"type":"number"},"creative_inpainting":{"type":"boolean"},"text_prompt":{"title":"TextPrompt","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["user_id","request_id"]},{"title":"AudioLdmRequestData","type":"object","properties":{"user_id":{"type":"string"},"request_id":{"type":"string"},"batch_size":{"type":"number"},"seed":{"title":"Seed","anyOf":[{"type":"number"},{"type":"null"}]},"num_train_steps":{"type":"integer"},"text_prompt":{"title":"TextPrompt","anyOf":[{"type":"string"},{"type":"null"}]},"artist_preset":{"title":"ArtistPresetInRequestData","type":"array","items":{"title":"ArtistPresetInRequestData","type":"object","properties":{"collection_uuid":{"type":"string"},"preset_attribution":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"artist":{"type":"string"}}}}},"required":["user_id","request_id"]}]},"imageAttributionAnalysis":{"title":"ImageAttributionAnalysis","description":"Image attribution analysis extracts the analysis metrics for a given image. Metrics are as follows: Attribution likelihood describes the probability that a piece of content from the registry had an influence on the creation of a new piece of content. Cross-correlation describes how similar the images are, independent of spatial shifts. Color match describes how similar the color distributions of RGB are. And pixel-wise average difference gives the average distance in between images.","type":"object","properties":{"similarFiles":{"title":"SimilarImageFilesWithMetrics","type":"array","items":{"title":"SimilarImageFile","type":"object","properties":{"attribution_likelihood":{"type":"number"},"cross_correlation":{"type":"number"},"color_matching":{"title":"ColorMatching","type":"object","properties":{"g_channel":{"type":"number"},"r_channel":{"type":"number"},"b_channel":{"type":"number"}},"required":["g_channel","r_channel","b_channel"]},"color_matching_combined":{"type":"number"},"pixelwise_similarity":{"type":"number"},"filename":{"type":"string"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}},"required":["attribution_likelihood","color_matching","pixelwise_similarity"]}},"topMetrics":{"title":"TopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"cross_correlation":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"color_matching":{"title":"TopColorMatching","type":"object","properties":{"g_channel":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"r_channel":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"b_channel":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["g_channel","r_channel","b_channel"]},"color_matching_combined":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"pixelwise_similarity":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"IdenticalMatchSignedUrls","type":"array","items":{"title":"IdenticalMatchSignedUrlsInner","anyOf":[{"type":"string"},{"type":"null"}]}},"signed_urls_thumbnails":{"title":"IdenticalMatchSignedUrlsThumbnails","type":"array","items":{"title":"IdenticalMatchSignedUrlsThumbnailsInner","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls","signed_urls_thumbnails"]}},"required":["attribution_likelihood","cross_correlation","color_matching","color_matching_combined","pixelwise_similarity","identical_matches"]}},"required":["similarFiles","topMetrics"]},"originalFilename":{"anyOf":[{"type":"string"},{"type":"string"}]},"audiosSignedUrls":{"title":"AudiosSignedUrls","type":"array","items":{"type":"string"}},"stemSplittedAudiosSignedUrls":{"title":"StemSplittedAudiosSignedUrls","type":"array","items":{"type":"string"}},"contentAudio":{"type":"string"},"attributionPerCollection":{"title":"AttributionWithStems","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content. The attribution is returned for the master audio as well as for each individual stem. Additionally, attribution is calculated for multiple segments of the entire song. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"attributionPerTrack":{"title":"AttributionWithStems","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content. The attribution is returned for the master audio as well as for each individual stem. Additionally, attribution is calculated for multiple segments of the entire song. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"audioAttributionAnalysis":{"title":"SimilarAudioFilesPerStem","description":"Audio attribution analysis extracts the analysis metrics for a given audio file. Metrics are as follows: Attribution likelihood describes the probability that a piece of content from the registry had an influence on the creation of a new piece of content. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"instrumentals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"vocals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"bass":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"drums":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}}},"required":["master","instrumentals","vocals","bass","drums"]},"optOutAnalysis":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"musicalityAnalysis":{"title":"Musicality Analysis","description":"Detailed analysis of musicality, including metadata and scoring for various segments.","type":"object","properties":{"master":{"title":"ChunkWiseMusicalityAnalysis","type":"array","items":{"title":"ChunkWiseMusicalityAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The musical analysis values for the given responses.","title":"MusicalityArray","type":"array","items":{"title":"MusicalityInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"MusicalityValues","type":"object","properties":{"sampling_rate":{"type":"number"},"song_length":{"type":"number"},"key":{"type":"string"},"key_confidence":{"type":"number"},"tempo":{"type":"number"},"pitch":{"type":"number"},"genre_analysis":{"title":"GenreAnalysisValues","type":"array","items":{"title":"GenreAnalysisValuesInner","type":"object","properties":{"genre":{"type":"string"},"values":{"title":"GenreAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}},"required":["genre","values"]}},"mood_analysis":{"title":"MoodAnalysisValues","type":"array","items":{"title":"MoodAnalysisValuesInner","type":"object","properties":{"mood":{"type":"string"},"values":{"title":"MoodAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}},"required":["mood","values"]}}},"required":["genre_analysis","mood_analysis"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"aiDnaVisualization":{"title":"VisualizationS3KeysResponse","type":"array","items":{"title":"AI DNA Visualization","description":"Images for the AI DNA Visualization","type":"object","properties":{"master":{"title":"ChunkWiseVisualizationS3keysResponse","type":"array","items":{"title":"VisualizationS3keysResponseInner","type":"object","properties":{"filename":{"type":"string"},"signedUrls":{"title":"SignedUrls","type":"array","items":{"type":"string"}}},"required":["signedUrls"]}}},"required":["master"]}},"lyricsAnalysis":{"title":"LyricsAnalysis","description":"The result of the lyrics analysis.","type":"object","properties":{"filename":{"description":"The name of the file containing the uploaded lyrics.","type":"string"},"lyrics":{"description":"The input lyrics.","type":"string"},"lyrics_attribution":{"description":"The lyrics attribution values for the (translated) input lyrics.","title":"LyricsAttribution","type":"array","items":{"title":"LyricsAttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration (in number of words) of the inspected segment, representing the length of each analyzed time window.","type":"number"},"period":{"description":"The period (in number of words) of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis.","type":"number"},"values":{"title":"LyricsAttribution","type":"array","items":{"title":"LyricsAttributionInner","type":"object","properties":{"score":{"description":"The degree of copyright infringement per chunk related to the lyrics.","title":"LyricsAttributionInnerScore","type":"array","items":{"type":"number"}},"mean_score":{"description":"The mean degree of copyright infringement over the whole lyrics.","type":"number"},"similar_lyrics_inspected":{"description":"The corresponding lyrics from the new song that match the original lyrics.","title":"LyricsAttributionInnerSimilarLyricsInspected","type":"array","items":{"type":"string"}},"similar_lyrics_original":{"description":"The most similar lyrics from the original song.","title":"LyricsAttributionInnerSimilarLyricsOriginal","type":"array","items":{"type":"string"}},"track_name":{"description":"The name of the song.","type":"string"},"track":{"description":"The track associated with the original lyrics.","type":"string"},"is_spotify_url":{"description":"Whether the returned track URL is a Spotify URL or not.","type":"boolean"}},"required":["score","similar_lyrics_inspected","similar_lyrics_original","track","is_spotify_url"]}}},"required":["duration","period","values"]}},"translated_lyrics":{"description":"The translated version of the lyrics, if applicable.","type":"string"}}},"aiGeneratedLikelihood":{"description":"AI detection results are provided for each stem. The master stem delivers the most reliable results, while results for individual stems are available in beta.","title":"AIDetectionResultsWithStem","type":"object","properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}}},"required":["master","instrumentals","vocals","bass","drums"]},"similarTracks":{"title":"SimilarTracks","type":"array","items":{"title":"SimilarTracksInner","type":"object","properties":{"track":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["track","signed_url","is_spotify_url"]}},"artist_uuid":{"type":"string"}},"required":["requestId"]}},"lastEvaluatedKey":{"title":"LastEvaluatedKey","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["analysisHistory","lastEvaluatedKey"]}}}}}}},"/v1/ai/artist/upload-artwork":{"post":{"operationId":"createCollection","summary":"Upload audio or images to create a collection","tags":["artist"],"description":"Add audio or images and create a new collection. A collection can be any kind of release, such as an album, a single, EP, compilation, or any other mix of audio files or image files. Each collection has a `collectionUuid`. Every artist/label can create multiple collections of artworks. New collections can be created with the `/artist/upload-artwork` endpoint and existing collections can be obtained with the `/artist/collections` endpoint.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"CreateCollectionRequest","type":"object","properties":{"files":{"title":"Files","minItems":1,"maxItems":100,"description":"The `files` parameter is a list of metadata of the audio, image, or video files.","type":"array","items":{"title":"File","type":"object","properties":{"filePath":{"description":"The file path can either be an image/audio/video URL or a file path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG & PNG for image; WAV, MP3, M4A, and FLAC for audio; and MP4 for video.","type":"string"},"trackTitle":{"description":"The title of the song.","type":"string"},"isrc":{"description":"The ISRC (International Standard Recording Code) is a unique identifier for a sound recording.","type":"string"},"externalTrackId":{"description":"The external ID is the ID of the collection/release/album/compilation in another system, e.g. OpenPlay. This ID can be used to reference the content.","type":"string"},"externalUrl":{"description":"The external URL of the song in another system.","type":"string"},"artists":{"title":"Artists","description":"An array of artists that contributed to the collection.","type":"array","items":{"title":"ArtistObject","type":"object","properties":{"artistName":{"description":"The name of one artist that contributed to the collection.","type":"string"},"artistExternalId":{"description":"The external ID of one artist that contributed to the collection.","type":"string"}}}},"artistNames":{"title":"ArtistNames","deprecated":true,"description":"The name of the artists that contributed to the song.","type":"array","items":{"type":"string"}},"labels":{"title":"Labels","description":"The name of the label that published the song.","type":"array","items":{"type":"string"}},"cover":{"description":"Indicates whether the song is a cover.","type":"boolean"},"instrumental":{"description":"Indicates whether the song is instrumental.","type":"boolean"},"acapella":{"description":"Indicates whether the song is acapella.","type":"boolean"},"isStem":{"description":"Indicates whether the file provided under `filePath` is a stem (e.g., a single instrument or vocal track).","type":"boolean"},"stemType":{"description":"Specifies the type of stem if `isStem` is true (e.g., vocals, bass, drums).","type":"string"},"externalStems":{"title":"ExternalStems","description":"Provide additional stem files alongside the original master using this field if `isStem` is false.","type":"array","items":{"title":"ExternalStem","type":"object","properties":{"stemFilePath":{"description":"The stems can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"stemType":{"description":"Specifies the type of stem (e.g., vocals, bass, drums).","type":"string"}},"required":["stemFilePath","stemType"]}},"genres":{"title":"Genres","description":"The genres and subgenres of the song.","type":"array","items":{"type":"string"}},"duration":{"description":"The duration of the song in seconds.","type":"number"},"bpm":{"description":"The tempo of the song in beats per minute.","type":"number"},"key":{"description":"The key of the song.","type":"string"},"pitch":{"description":"The pitch of the song.","type":"string"},"mood":{"description":"The mood of the song.","type":"string"},"danceability":{"description":"The danceability of the song.","type":"number"},"instruments":{"title":"Instruments","description":"The instruments used in the song.","type":"array","items":{"type":"string"}},"timeSignature":{"description":"The time signature of the song.","type":"string"},"songCharacteristics":{"description":"The characteristics of the song.","type":"string"},"themes":{"title":"Themes","description":"The themes of the song.","type":"array","items":{"type":"string"}},"ageGroup":{"description":"The age group the song is intended for.","type":"string"},"gender":{"description":"The gender the song is intended for.","type":"string"},"personality":{"description":"The personality of the song.","type":"string"},"audioLanguage":{"description":"For music, you can set the audio language of the songs.","type":"string"},"releaseDate":{"description":"The release date of the song. The format is YYYY-MM-DD.","type":"string"},"explicit":{"description":"Indicates whether the song contains explicit content.","type":"boolean"},"lyrics":{"description":"The lyrics of a song.","type":"string"},"recordingStudio":{"description":"For music, you can set the recording studio.","type":"string"},"publisher":{"description":"For music, you can set the publisher.","type":"string"},"producer":{"description":"For music, you can set the producer.","type":"string"},"composer":{"description":"The person who writes the music for a song.","type":"string"},"songWriter":{"description":"The person who writes the lyrics and melody of a song.","type":"string"},"rightsAdministrator":{"description":"A publishing administrator or specialized entity responsible for handling administrative tasks related to rights.","type":"string"},"rightsOwner":{"description":"The owner of a copyrighted work who has rights to reproduce, distribute, publicly perform, display, and adapt the copyrighted material.","type":"string"},"aiInfluence":{"description":"Whether the uploaded images are completely generated without AI, refined with AI, AI generated, or the AI influnce is unknown.","title":"aiInfluence","anyOf":[{"type":"string","enum":["Generated without AI"]},{"type":"string","enum":["AI refined"]},{"type":"string","enum":["AI generated"]},{"type":"string","enum":["Unknown"]}]}}}},"filePaths":{"title":"FilePaths","deprecated":true,"minItems":1,"maxItems":100,"description":"This field is deprecated as it was replaced with the `files` parameter. It may be removed in future versions.\n\n The `filePaths` can either be an array of image/audio/video URLs or file paths returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG & PNG for image; WAV, MP3, M4A, and FLAC for audio; and MP4 for video.","type":"array","items":{"type":"string"}},"upc":{"description":"The UPC (Universal Product Code) is a 12-digit barcode that uniquely identifies products like albums, aiding in sales tracking and inventory management across retail and online platforms.","type":"string"},"collection_name":{"description":"Name for the artwork collection.","type":"string"},"collection_description":{"description":"A description of the images in this collection. Please describe your Collection as appropriate as possible. This helps to train our AI to get the best results.","type":"string"},"artists":{"title":"Artists","description":"An array of artists that contributed to the collection. Only user accounts connected to a label can use this field.","type":"array","items":{"title":"ArtistObject","type":"object","properties":{"artistName":{"description":"The name of one artist that contributed to the collection.","type":"string"},"artistExternalId":{"description":"The external ID of one artist that contributed to the collection.","type":"string"}}}},"artistName":{"deprecated":true,"description":"The name of the artist for which you want to create the collection. Only user accounts connected to a label can use the artistName field.","type":"string"},"createNewArtist":{"description":"If the artist does not exist yet in the Sureel registry, you can automatically create one here. Only user accounts connected to a label can use the createNewArtist field.","default":false,"type":"boolean"},"styles":{"description":"Genre of the songs or styles of the images, such as “painting”, “photography”, “anime” or “digital art”. It must be a comma-separated list of styles.","type":"string"},"contentType":{"enum":["audio","image","video"],"title":"ContentType","type":"string"},"useForTraining":{"description":"Indicates whether to opt in to AI training or opt out. Set to true to allow data to be used for training, or false to decline.","type":"boolean"},"noAudioFilesAvailable":{"description":"Set to true if no audio files are currently available for the collection and none are expected to be added in the near future.","type":"boolean"},"knowledgeAcquisitionRatio":{"minimum":-0.2,"maximum":0.2,"default":0,"description":"If `useForTraining` is set to true, the `knowledgeAcquisitionRatio` parameter can be used to adapt the AI model’s knowledge acquisition based on your data.","type":"number"},"aiInfluence":{"description":"Whether the uploaded images are completely generated without AI, refined with AI, AI generated, or the AI influnce is unknown.","title":"aiInfluence","anyOf":[{"type":"string","enum":["Generated without AI"]},{"type":"string","enum":["AI refined"]},{"type":"string","enum":["AI generated"]},{"type":"string","enum":["Unknown"]}]},"externalId":{"description":"The external ID is the ID of the collection/release/album/single/compilation in another system, e.g. OpenPlay. This ID can be used to reference the content.","type":"string"},"externalUrl":{"description":"The external URL of the song in another system.","type":"string"},"originalCoverArt":{"description":"The `originalCoverArt` can either be an image URL or an image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG & PNG.","type":"string"},"audioLanguage":{"description":"For music, you can set the audio language of the songs.","type":"string"},"releaseDate":{"description":"The release date of the album/single/release/compilation. The format is YYYY-MM-DD.","type":"string"},"recordingStudio":{"description":"For music, you can set the recording studio.","type":"string"},"publisher":{"description":"For music, you can set the publisher.","type":"string"},"producer":{"description":"For music, you can set the producer.","type":"string"},"composer":{"description":"The person who writes the music for a song.","type":"string"},"songWriter":{"description":"The person who writes the lyrics and melody of a song.","type":"string"},"rightsAdministrator":{"description":"A publishing administrator or specialized entity responsible for handling administrative tasks related to rights.","type":"string"},"rightsOwner":{"description":"The owner of a copyrighted work who has rights to reproduce, distribute, publicly perform, display, and adapt the copyrighted material.","type":"string"},"subLabel":{"description":"The sub-label of the artist.","type":"string"},"enableAutomaticAttributionSetup":{"description":"Enable or disable automatic attribution setup.","default":true,"type":"boolean"},"synthesisRules":{"title":"SynthesisRules","type":"object","properties":{"noAttributionGreaterThan":{"description":"No attribution greater than x% for any Al generated music.","type":"number"},"noAttributionSmallerThan":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"noSharedAttributionWithArtist":{"description":"No shared attribution with artist xyz","type":"string"},"noSharedAttributionWithGenre":{"description":"No shared attribution with genre xyz","type":"string"}}}},"required":["collection_name","contentType"]},"example":{"files":[{"filePath":"https://example.com/track1.wav","trackTitle":"Midnight Dreams","isrc":"USUM71703861","externalTrackId":"spotify-track-123456","externalUrl":"https://open.spotify.com/track/example","artists":[{"artistName":"John Doe","artistExternalId":"artist-ext-789"}],"artistNames":["John Doe","Jane Smith"],"labels":["Electronic Music Records","Ambient Sounds"],"cover":false,"instrumental":false,"acapella":false,"isStem":false,"stemType":"master","externalStems":[{"stemFilePath":"https://example.com/stems/vocals.wav","stemType":"vocals"}],"genres":["Electronic","Ambient"],"duration":240,"bpm":120,"key":"Am","pitch":"A440","mood":"Dreamy","danceability":0.7,"instruments":["Synthesizer","Drum Machine","Bass"],"timeSignature":"4/4","songCharacteristics":"Atmospheric, layered synths with rhythmic elements","themes":["Dreams","Night","Meditation"],"ageGroup":"Adult","gender":"Unisex","personality":"Introspective","audioLanguage":"en","releaseDate":"2024-12-01","explicit":false,"lyrics":"Floating through the midnight sky, dreams that never die...","recordingStudio":"Abbey Road Studios","publisher":"Universal Music Publishing","producer":"Rick Rubin","composer":"John Williams","songWriter":"Bob Dylan","rightsAdministrator":"ASCAP","rightsOwner":"Universal Music Group","aiInfluence":"AI refined"}],"filePaths":["https://example.com/track1.wav","https://example.com/track2.wav"],"upc":"123456789012","collection_name":"My First Collection","collection_description":"A collection of my original music tracks with electronic and ambient influences","artists":[{"artistName":"John Doe","artistExternalId":"artist-123"}],"artistName":"John Doe","createNewArtist":false,"styles":"electronic, ambient, downtempo","contentType":"audio","useForTraining":true,"noAudioFilesAvailable":false,"knowledgeAcquisitionRatio":0.05,"aiInfluence":"AI refined","externalId":"ext-album-456","externalUrl":"https://music.example.com/album/my-first-collection","originalCoverArt":"https://example.com/cover-art.jpg","audioLanguage":"en","releaseDate":"2024-12-01","recordingStudio":"Abbey Road Studios","publisher":"Universal Music Publishing","producer":"Rick Rubin","composer":"John Williams","songWriter":"Bob Dylan","rightsAdministrator":"ASCAP","rightsOwner":"Universal Music Group","subLabel":"Interscope Records","enableAutomaticAttributionSetup":true,"synthesisRules":{"noAttributionGreaterThan":25,"noAttributionSmallerThan":3,"noSharedAttributionWithArtist":"Example artist","noSharedAttributionWithGenre":"Classical"}}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostCreateCollectionResponse","type":"object","properties":{"collectionUuid":{"description":"The UUID of the collection.","type":"string"},"files":{"title":"UploadedFiles","description":"The file IDs and track names of the uploaded files.","type":"array","items":{"title":"UploadedFile","type":"object","properties":{"fileId":{"description":"The file ID of the uploaded files.","type":"string"},"trackTitle":{"description":"The name of the track.","type":"string"}},"required":["fileId"]}}},"required":["collectionUuid","files"]}}}}}}},"/v1/ai/artist/set-filepaths":{"put":{"operationId":"setFilepaths","summary":"Set filepaths for a collection","tags":["artist"],"description":"Set the file paths for a collection in the draft status. It can be used to set the file paths when the files were not available during the creation of the collection.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"SetFilepathsRequest","type":"object","properties":{"collectionUuid":{"description":"The UUID of the collection.","type":"string"},"files":{"title":"SetFilepathsFiles","minItems":1,"maxItems":100,"description":"List of file IDs and file paths to set for the collection.","type":"array","items":{"title":"SetFilepathFile","type":"object","properties":{"fileId":{"description":"The file ID as returned from the `/artist/upload-artwork` endpoint.","type":"string"},"filePath":{"description":"The file path can either be an image/audio/video URL or a file path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG & PNG for image; WAV, MP3, M4A, and FLAC for audio; and MP4 for video.","type":"string"}},"required":["fileId","filePath"]}},"enableAutomaticAttributionSetup":{"description":"Enable or disable automatic attribution setup.","default":true,"type":"boolean"}},"required":["collectionUuid","files"]},"example":{"collectionUuid":"550e8400-e29b-41d4-a716-446655440000","files":[{"fileId":"file_12345","filePath":"https://example.com/audio/track1.wav"},{"fileId":"file_67890","filePath":"https://example.com/audio/track2.wav"}],"enableAutomaticAttributionSetup":true}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/artist/update-ip-rights":{"put":{"operationId":"updateIpRights","summary":"Update IP rights","tags":["artist"],"description":"Update the intellectual property rights for your songs.","requestBody":{"content":{"application/json":{"schema":{"title":"IpRights","type":"object","properties":{"collectionUuid":{"description":"The UUID of the collection.","type":"string"},"files":{"title":"IpRightsFiles","minItems":1,"maxItems":100,"description":"List of file IDs and content rights to set for the collection.","type":"array","items":{"title":"IpRightsFile","type":"object","properties":{"fileId":{"description":"The file ID as returned from the `/artist/upload-artwork` endpoint.","type":"string"},"contentRights":{"title":"ContentRights","description":"The content rights for the file. ","type":"object","properties":{"recordingRights":{"description":"Set to true if the recording rights are owned by the artist.","type":"boolean"},"publishingRights":{"description":"Set to true if the publishing rights are owned by the artist.","type":"boolean"},"coverOrDerivativeWork":{"description":"Set to true if the song is a cover or derivative work.","type":"boolean"}},"required":["recordingRights","publishingRights","coverOrDerivativeWork"]}},"required":["fileId","contentRights"]}}},"required":["collectionUuid","files"]},"example":{"collectionUuid":"550e8400-e29b-41d4-a716-446655440000","files":[{"fileId":"file_12345","contentRights":{"recordingRights":true,"publishingRights":true,"coverOrDerivativeWork":false}},{"fileId":"file_67890","contentRights":{"recordingRights":false,"publishingRights":true,"coverOrDerivativeWork":true}}]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/artist/collections":{"get":{"operationId":"getOwnCollections","summary":"Get own collections","tags":["artist"],"description":"Get all own collections, including non-published.","parameters":[{"schema":{"type":"string"},"in":"query","name":"include_artworks","required":true},{"schema":{"type":"string"},"in":"query","name":"include_original_songs","required":false},{"schema":{"type":"string"},"in":"query","name":"include_full_res_artworks","required":false},{"schema":{"default":20,"minimum":1,"maximum":100,"type":"number"},"in":"query","name":"take","required":false,"description":"The 'take' parameter is the number of items to be returned per page."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"The optional `cursor` parameter is the `lastEvaluatedKey` in the previous page."},{"schema":{"enum":["collection_name"],"type":"string"},"in":"query","name":"collection_search_field","required":false,"description":"Field to search collections by."},{"schema":{"type":"string"},"in":"query","name":"collection_search_value","required":false,"description":"Value to match against the specified collection search field. Supports case-insensitive partial matching."},{"schema":{"enum":["release_date","collection_name","number_of_assets"],"type":"string"},"in":"query","name":"sort_by","required":false,"description":"Specifies the sorting criteria."},{"schema":{"enum":["asc","desc"],"type":"string"},"in":"query","name":"sort_order","required":false,"description":"Specifies the sorting order."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistProfileData","type":"object","properties":{"username":{"type":"string"},"auth0_id":{"type":"string"},"profile_picture_s3_key":{"type":"string"},"cover_image_s3_key":{"type":"string"},"picture":{"type":"string"},"cover_image":{"type":"string"},"family_name":{"type":"string"},"given_name":{"type":"string"},"email":{"type":"string"},"profile_description":{"type":"string"},"url_external_website":{"type":"string"},"updated_at":{"title":"UpdatedAt","anyOf":[{"type":"string"},{"type":"number"}]},"user_role":{"anyOf":[{"title":"UserRole","anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["ai-company"]}]},{"title":"ArtistOnlyRole","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]}]}]},"stripe_customer_id":{"type":"string"},"subscription_tier":{"title":"SubscriptionTier","anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["pro"]},{"type":"string","enum":["ultra"]}]},"customer_name":{"type":"string"},"connected_api_user":{"type":"string"},"logo":{"type":"string"},"api_terms_and_conditions":{"type":"boolean"},"created_at":{"type":"number"},"zero_balance_email_sent":{"type":"boolean"},"low_balance_email_sent":{"type":"boolean"},"balance_treshold":{"type":"number"},"sub_labels":{"title":"SubLabels","type":"array","items":{"type":"string"}},"metrics":{"title":"Metrics","type":"object","properties":{"registry":{"title":"GetRegistryOptInOutMetricsResponse","type":"object","properties":{"optOutPercentage":{"type":"number"},"optInPercentage":{"type":"number"},"optOutAmount":{"type":"number"},"optInAmount":{"type":"number"},"numberOfReleases":{"type":"number"},"numberOfAssets":{"type":"number"},"numberOfArtists":{"type":"number"},"collectionWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"collectionWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"artistsWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"artistsWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"genreWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"genreWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"rulesForOptIn":{"type":"string"}},"required":["optOutPercentage","optInPercentage","optOutAmount","optInAmount","numberOfReleases","numberOfAssets"]}},"required":["registry"]},"spotify_user_id":{"type":"string"},"spotify_display_name":{"type":"string"},"verified":{"type":"boolean"},"tutorial_completed_at":{"type":"number"},"terms_and_conditions":{"type":"boolean"},"show_in_frontend":{"type":"boolean"},"collection_uuids":{"title":"CollectionUUIDs","type":"array","items":{"type":"string"}},"collections":{"title":"ArtistCollections","type":"array","items":{"title":"ArtistCollectionRecordIntersection","type":"object","properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"status":{"title":"CollectionStatus","anyOf":[{"type":"string","enum":["Draft"]},{"type":"string","enum":["Pending"]},{"type":"string","enum":["In training"]},{"type":"string","enum":["Opted-in"]},{"type":"string","enum":["Opted-out"]},{"type":"string","enum":["Denied"]}]},"status_description":{"type":"string"},"file_ids":{"title":"FileIds","type":"array","items":{"type":"string"}},"files":{"type":"array","items":{"title":"AssetMetadataRecordForDisplay","type":"object","properties":{"file_id":{"type":"string"},"isrc":{"type":"string"},"track_title":{"type":"string"},"file_path":{"type":"string"},"duration":{"type":"number"},"spotify_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"artist_names":{"deprecated":true,"title":"ArtistNames","type":"array","items":{"type":"string"}},"labels":{"title":"Labels","type":"array","items":{"type":"string"}}}}},"artworks_s3_keys":{"title":"ArtworksS3Keys","type":"array","items":{"type":"string"}},"artworks":{"title":"Artworks","type":"array","items":{"type":"string"}},"artworksFullRes":{"title":"ArtworksFullRes","type":"array","items":{"type":"string"}},"is_spotify_url":{"type":"boolean"},"prompt_guidance":{"type":"string"},"show_in_frontend":{"type":"boolean"},"styles":{"title":"Styles","type":"array","items":{"type":"string"}},"use_for_finetuning":{"type":"boolean"},"use_for_training":{"type":"boolean"},"no_audio_files_available":{"type":"boolean"},"knowledge_acquisition_ratio":{"type":"number"},"ai_influence":{"type":"string"},"external_id":{"type":"string"},"external_url":{"type":"string"},"original_cover_art_s3_key":{"type":"string"},"original_cover_art":{"type":"string"},"original_cover_art_filename":{"type":"string"},"original_cover_art_thumbnail":{"type":"string"},"audio_language":{"type":"string"},"spotify_id":{"type":"string"},"release_date":{"type":"string"},"release_date_precision":{"type":"string"},"popularity":{"type":"number"},"release_type":{"type":"string"},"recording_studio":{"type":"string"},"publisher":{"type":"string"},"producer":{"type":"string"},"composer":{"type":"string"},"song_writer":{"type":"string"},"rights_administrator":{"type":"string"},"rights_owner":{"type":"string"},"sub_label":{"type":"string"},"created_at":{"type":"number"},"updated_at":{"type":"number"},"collection_published_email_sent":{"type":"number"},"customer_name":{"type":"string"},"lora_weights_s3_key":{"type":"string"},"content_type":{"type":"string"},"attribution_setup_status":{"type":"string"},"suno_analysis_request_ids":{"title":"SunoAnalysisRequestIds","type":"array","items":{"type":"string"}},"suno_analysis_result":{"title":"GetExternalAiMonitoringResponse","description":"The external AI monitoring results for the given collection or user.","type":"array","items":{"title":"ExternalAiMonitoringObject","type":"object","properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"HistogramValues","type":"array","items":{"title":"HistogramValuesInner","type":"object","properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}},"required":["binStart","binEnd","count"]}}},"required":["duration","period","values"]}}},"required":["master"]}},"required":["trackName","histogramValues"]}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"SynthesisRules","type":"object","properties":{"no_attribution_greater_than":{"type":"number"},"no_attribution_smaller_than":{"type":"number"},"no_shared_attribution_with_artist":{"type":"string"},"no_shared_attribution_with_genre":{"type":"string"}}},"label":{"type":"string"},"use_for_training_timestamp":{"type":"number"},"ai_company_notifications":{"title":"AiCompanyNotifications","type":"object","properties":{"notifications_status":{"type":"string"},"notification_time":{"type":"number"},"number_of_contacted_ai_companies":{"type":"number"},"contacted_ai_companies":{"title":"AiCompanyNotifications","type":"array","items":{"title":"AiCompanyNotification","type":"object","properties":{"ai_company_name":{"type":"string"},"ai_company_email":{"type":"string"},"status":{"type":"string"},"notification_time":{"type":"number"},"acknowledged":{"type":"boolean"}}}}}},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"},"audio_embeddings_s3_keys":{"title":"AudioEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"midi_embeddings_s3_keys":{"title":"MIDIEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"lyrics_embeddings_s3_key":{"type":"string"},"fingerprint_db_s3_key":{"type":"string"},"lyrics_s3_key":{"type":"string"},"external_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"internal_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"ai_check_results":{"description":"AI detection results are provided for each stem. The master stem delivers the most reliable results, while results for individual stems are available in beta.","title":"AIDetectionResultsWithStem","type":"object","properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}}},"required":["master","instrumentals","vocals","bass","drums"]}},"required":["collection_uuid","username","status"]}},"attribution_setup_status":{"type":"string"},"suno_analysis_request_ids":{"title":"SunoAnalysisRequestIds","type":"array","items":{"type":"string"}},"suno_analysis_result":{"title":"GetExternalAiMonitoringResponse","description":"The external AI monitoring results for the given collection or user.","type":"array","items":{"title":"ExternalAiMonitoringObject","type":"object","properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"HistogramValues","type":"array","items":{"title":"HistogramValuesInner","type":"object","properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}},"required":["binStart","binEnd","count"]}}},"required":["duration","period","values"]}}},"required":["master"]}},"required":["trackName","histogramValues"]}},"company_name":{"description":"The name of the company/record label associated with the artist.","type":"string"},"lastEvaluatedKey":{"type":"string"}},"required":["username"]}}}}}}},"/v1/ai/artist/collections/opted-out":{"get":{"operationId":"getOptedOutCollections","summary":"Get opted-out collections","tags":["artist"],"description":"Get all collections that are opted-out.","parameters":[{"schema":{"type":"number"},"in":"query","name":"take","required":true,"description":"The `take` parameter is the number of collections to return per page."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"The optional `cursor` parameter is the `lastEvaluatedKey` in the previous page."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetOptedOutCollectionsResponse","type":"object","properties":{"collections":{"title":"Opted-out collections","type":"array","items":{"title":"ArtistCollectionRecordIntersection","type":"object","properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"status":{"title":"CollectionStatus","anyOf":[{"type":"string","enum":["Draft"]},{"type":"string","enum":["Pending"]},{"type":"string","enum":["In training"]},{"type":"string","enum":["Opted-in"]},{"type":"string","enum":["Opted-out"]},{"type":"string","enum":["Denied"]}]},"status_description":{"type":"string"},"file_ids":{"title":"FileIds","type":"array","items":{"type":"string"}},"files":{"type":"array","items":{"title":"AssetMetadataRecordForDisplay","type":"object","properties":{"file_id":{"type":"string"},"isrc":{"type":"string"},"track_title":{"type":"string"},"file_path":{"type":"string"},"duration":{"type":"number"},"spotify_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"artist_names":{"deprecated":true,"title":"ArtistNames","type":"array","items":{"type":"string"}},"labels":{"title":"Labels","type":"array","items":{"type":"string"}}}}},"artworks_s3_keys":{"title":"ArtworksS3Keys","type":"array","items":{"type":"string"}},"artworks":{"title":"Artworks","type":"array","items":{"type":"string"}},"artworksFullRes":{"title":"ArtworksFullRes","type":"array","items":{"type":"string"}},"is_spotify_url":{"type":"boolean"},"prompt_guidance":{"type":"string"},"show_in_frontend":{"type":"boolean"},"styles":{"title":"Styles","type":"array","items":{"type":"string"}},"use_for_finetuning":{"type":"boolean"},"use_for_training":{"type":"boolean"},"no_audio_files_available":{"type":"boolean"},"knowledge_acquisition_ratio":{"type":"number"},"ai_influence":{"type":"string"},"external_id":{"type":"string"},"external_url":{"type":"string"},"original_cover_art_s3_key":{"type":"string"},"original_cover_art":{"type":"string"},"original_cover_art_filename":{"type":"string"},"original_cover_art_thumbnail":{"type":"string"},"audio_language":{"type":"string"},"spotify_id":{"type":"string"},"release_date":{"type":"string"},"release_date_precision":{"type":"string"},"popularity":{"type":"number"},"release_type":{"type":"string"},"recording_studio":{"type":"string"},"publisher":{"type":"string"},"producer":{"type":"string"},"composer":{"type":"string"},"song_writer":{"type":"string"},"rights_administrator":{"type":"string"},"rights_owner":{"type":"string"},"sub_label":{"type":"string"},"created_at":{"type":"number"},"updated_at":{"type":"number"},"collection_published_email_sent":{"type":"number"},"customer_name":{"type":"string"},"lora_weights_s3_key":{"type":"string"},"content_type":{"type":"string"},"attribution_setup_status":{"type":"string"},"suno_analysis_request_ids":{"title":"SunoAnalysisRequestIds","type":"array","items":{"type":"string"}},"suno_analysis_result":{"title":"GetExternalAiMonitoringResponse","description":"The external AI monitoring results for the given collection or user.","type":"array","items":{"title":"ExternalAiMonitoringObject","type":"object","properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"HistogramValues","type":"array","items":{"title":"HistogramValuesInner","type":"object","properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}},"required":["binStart","binEnd","count"]}}},"required":["duration","period","values"]}}},"required":["master"]}},"required":["trackName","histogramValues"]}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"SynthesisRules","type":"object","properties":{"no_attribution_greater_than":{"type":"number"},"no_attribution_smaller_than":{"type":"number"},"no_shared_attribution_with_artist":{"type":"string"},"no_shared_attribution_with_genre":{"type":"string"}}},"label":{"type":"string"},"use_for_training_timestamp":{"type":"number"},"ai_company_notifications":{"title":"AiCompanyNotifications","type":"object","properties":{"notifications_status":{"type":"string"},"notification_time":{"type":"number"},"number_of_contacted_ai_companies":{"type":"number"},"contacted_ai_companies":{"title":"AiCompanyNotifications","type":"array","items":{"title":"AiCompanyNotification","type":"object","properties":{"ai_company_name":{"type":"string"},"ai_company_email":{"type":"string"},"status":{"type":"string"},"notification_time":{"type":"number"},"acknowledged":{"type":"boolean"}}}}}},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"},"audio_embeddings_s3_keys":{"title":"AudioEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"midi_embeddings_s3_keys":{"title":"MIDIEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"lyrics_embeddings_s3_key":{"type":"string"},"fingerprint_db_s3_key":{"type":"string"},"lyrics_s3_key":{"type":"string"},"external_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"internal_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"ai_check_results":{"description":"AI detection results are provided for each stem. The master stem delivers the most reliable results, while results for individual stems are available in beta.","title":"AIDetectionResultsWithStem","type":"object","properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}}},"required":["master","instrumentals","vocals","bass","drums"]}},"required":["collection_uuid","username","status"]}},"lastEvaluatedKey":{"type":"string"}}}}}}}}},"/v1/ai/artist/collection/{collectionUuid}":{"get":{"operationId":"getCollection","summary":"Get collection (with lyrics and stems)","tags":["artist"],"description":"Retrieve a collection including lyrics and stems if already extracted.","parameters":[{"schema":{"minLength":1,"type":"string"},"in":"path","name":"collectionUuid","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetCollectionWithLyricsAndStemsResponse","type":"object","properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"status":{"title":"CollectionStatus","anyOf":[{"type":"string","enum":["Draft"]},{"type":"string","enum":["Pending"]},{"type":"string","enum":["In training"]},{"type":"string","enum":["Opted-in"]},{"type":"string","enum":["Opted-out"]},{"type":"string","enum":["Denied"]}]},"status_description":{"type":"string"},"file_ids":{"title":"FileIds","type":"array","items":{"type":"string"}},"files":{"type":"array","items":{"title":"AssetMetadataRecordForDisplay","type":"object","properties":{"file_id":{"type":"string"},"isrc":{"type":"string"},"track_title":{"type":"string"},"file_path":{"type":"string"},"duration":{"type":"number"},"spotify_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"artist_names":{"deprecated":true,"title":"ArtistNames","type":"array","items":{"type":"string"}},"labels":{"title":"Labels","type":"array","items":{"type":"string"}}}}},"artworks_s3_keys":{"title":"ArtworksS3Keys","type":"array","items":{"type":"string"}},"artworks":{"title":"Artworks","type":"array","items":{"type":"string"}},"artworksFullRes":{"title":"ArtworksFullRes","type":"array","items":{"type":"string"}},"is_spotify_url":{"type":"boolean"},"prompt_guidance":{"type":"string"},"show_in_frontend":{"type":"boolean"},"styles":{"title":"Styles","type":"array","items":{"type":"string"}},"use_for_finetuning":{"type":"boolean"},"use_for_training":{"type":"boolean"},"no_audio_files_available":{"type":"boolean"},"knowledge_acquisition_ratio":{"type":"number"},"ai_influence":{"type":"string"},"external_id":{"type":"string"},"external_url":{"type":"string"},"original_cover_art_s3_key":{"type":"string"},"original_cover_art":{"type":"string"},"original_cover_art_filename":{"type":"string"},"original_cover_art_thumbnail":{"type":"string"},"audio_language":{"type":"string"},"spotify_id":{"type":"string"},"release_date":{"type":"string"},"release_date_precision":{"type":"string"},"popularity":{"type":"number"},"release_type":{"type":"string"},"recording_studio":{"type":"string"},"publisher":{"type":"string"},"producer":{"type":"string"},"composer":{"type":"string"},"song_writer":{"type":"string"},"rights_administrator":{"type":"string"},"rights_owner":{"type":"string"},"sub_label":{"type":"string"},"created_at":{"type":"number"},"updated_at":{"type":"number"},"collection_published_email_sent":{"type":"number"},"customer_name":{"type":"string"},"lora_weights_s3_key":{"type":"string"},"content_type":{"type":"string"},"attribution_setup_status":{"type":"string"},"suno_analysis_request_ids":{"title":"SunoAnalysisRequestIds","type":"array","items":{"type":"string"}},"suno_analysis_result":{"title":"GetExternalAiMonitoringResponse","description":"The external AI monitoring results for the given collection or user.","type":"array","items":{"title":"ExternalAiMonitoringObject","type":"object","properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"HistogramValues","type":"array","items":{"title":"HistogramValuesInner","type":"object","properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}},"required":["binStart","binEnd","count"]}}},"required":["duration","period","values"]}}},"required":["master"]}},"required":["trackName","histogramValues"]}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"SynthesisRules","type":"object","properties":{"no_attribution_greater_than":{"type":"number"},"no_attribution_smaller_than":{"type":"number"},"no_shared_attribution_with_artist":{"type":"string"},"no_shared_attribution_with_genre":{"type":"string"}}},"label":{"type":"string"},"use_for_training_timestamp":{"type":"number"},"ai_company_notifications":{"title":"AiCompanyNotifications","type":"object","properties":{"notifications_status":{"type":"string"},"notification_time":{"type":"number"},"number_of_contacted_ai_companies":{"type":"number"},"contacted_ai_companies":{"title":"AiCompanyNotifications","type":"array","items":{"title":"AiCompanyNotification","type":"object","properties":{"ai_company_name":{"type":"string"},"ai_company_email":{"type":"string"},"status":{"type":"string"},"notification_time":{"type":"number"},"acknowledged":{"type":"boolean"}}}}}},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"},"audio_embeddings_s3_keys":{"title":"AudioEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"midi_embeddings_s3_keys":{"title":"MIDIEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"lyrics_embeddings_s3_key":{"type":"string"},"fingerprint_db_s3_key":{"type":"string"},"lyrics_s3_key":{"type":"string"},"external_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"internal_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"ai_check_results":{"description":"AI detection results are provided for each stem. The master stem delivers the most reliable results, while results for individual stems are available in beta.","title":"AIDetectionResultsWithStem","type":"object","properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}}},"required":["master","instrumentals","vocals","bass","drums"]},"stems":{"title":"Stems","type":"object","properties":{"instrumentals":{"title":"Instrumentals","type":"array","items":{"type":"string"}},"vocals":{"title":"Vocals","type":"array","items":{"type":"string"}},"drums":{"title":"Drums","type":"array","items":{"type":"string"}},"bass":{"title":"Bass","type":"array","items":{"type":"string"}}}},"lyrics":{"title":"LyricsResponse","type":"array","items":{"title":"LyricsFile","type":"object","properties":{"filename":{"type":"string"},"lyrics":{"type":"string"}},"required":["filename","lyrics"]}}},"required":["collection_uuid","username","status","stems","lyrics"]}}}}}}},"/v1/ai/artist/update-collection/{collectionUuid}":{"put":{"operationId":"updateCollection","summary":"Update collection details","tags":["artist"],"description":"Update an artist's collection with optional fields that can be modified via the request body. These fields include: collectionName, collectionDescription, and styles. The 'styles' field should be a comma-separated list of styles.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"UpdateCollectionRequest","type":"object","properties":{"collectionName":{"description":"Name for the artwork collection.","type":"string"},"collectionDescription":{"description":"A description of the images in this collection. Please describe your Collection as appropriate as possible. This helps to train our AI to get the best results.","type":"string"},"styles":{"description":"Genre of the songs or styles of the images, such as “painting”, “photography”, “anime” or “digital art”. It must be a comma-separated list of styles.","type":"string"},"useForTraining":{"description":"Indicates whether to opt in to AI training or opt out. Set to true to allow data to be used for training, or false to decline.","type":"boolean"},"audioLanguage":{"description":"For music, you can set the audio language of the songs.","type":"string"},"releaseDate":{"description":"The release date of the album/single/release/compilation. The format is YYYY-MM-DD.","type":"string"},"recordingStudio":{"description":"For music, you can set the recording studio.","type":"string"},"publisher":{"description":"For music, you can set the publisher.","type":"string"},"producer":{"description":"For music, you can set the producer.","type":"string"},"composer":{"description":"The person who writes the music for a song.","type":"string"},"songWriter":{"description":"The person who writes the lyrics and melody of a song.","type":"string"},"rightsAdministrator":{"description":"A publishing administrator or specialized entity responsible for handling administrative tasks related to rights.","type":"string"},"rightsOwner":{"description":"The owner of a copyrighted work who has rights to reproduce, distribute, publicly perform, display, and adapt the copyrighted material.","type":"string"},"subLabel":{"description":"The sub-label of the artist.","type":"string"},"originalCoverArt":{"description":"The `originalCoverArt` can either be an image URL or an image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG & PNG.","type":"string"},"aiInfluence":{"description":"Whether the uploaded images are completely generated without AI, refined with AI, AI generated, or the AI influnce is unknown.","title":"aiInfluence","anyOf":[{"type":"string","enum":["Generated without AI"]},{"type":"string","enum":["AI refined"]},{"type":"string","enum":["AI generated"]},{"type":"string","enum":["Unknown"]}]},"knowledgeAcquisitionRatio":{"description":"If `useForTraining` is set to true, the `knowledgeAcquisitionRatio` parameter can be used to adapt the AI model’s knowledge acquisition based on your data.","type":"number"},"synthesisRules":{"title":"SynthesisRules","type":"object","properties":{"noAttributionGreaterThan":{"description":"No attribution greater than x% for any Al generated music.","type":"number"},"noAttributionSmallerThan":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"noSharedAttributionWithArtist":{"description":"No shared attribution with artist xyz","type":"string"},"noSharedAttributionWithGenre":{"description":"No shared attribution with genre xyz","type":"string"}}}}},"example":{"collectionName":"Summer Vibes 2024","collectionDescription":"A description of the music and audio in this collection. Please describe your collection as clearly and accurately as possible, including genres, moods, instruments, or production styles.","styles":"pop, rock, jazz, digital art, painting, photography","useForTraining":false,"audioLanguage":"en","releaseDate":"2024-08-15","recordingStudio":"Abbey Road Studios","publisher":"Universal Music Publishing","producer":"Rick Rubin","composer":"John Williams","songWriter":"Bob Dylan","rightsAdministrator":"ASCAP","rightsOwner":"Universal Music Group","subLabel":"Interscope Records","originalCoverArt":"https://example.com/cover-art.jpg","aiInfluence":"AI refined","knowledgeAcquisitionRatio":0.1,"synthesisRules":{"noAttributionGreaterThan":30,"noAttributionSmallerThan":5,"noSharedAttributionWithArtist":"Example artist","noSharedAttributionWithGenre":"Heavy Metal"}}}}},"parameters":[{"schema":{"minLength":1,"type":"string"},"in":"path","name":"collectionUuid","required":true},{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/artist/delete-collection/{collectionUuid}":{"delete":{"operationId":"deleteCollection","summary":"Delete collection","tags":["artist"],"description":"Delete an artist's collection. This will also delete all associated artworks and attribution setup files.","parameters":[{"schema":{"minLength":1,"type":"string"},"in":"path","name":"collectionUuid","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/artist/":{"get":{"operationId":"getAllArtists","summary":"Get all artists","tags":["artist"],"description":"Get a list of all artists including their published collections. By default, each user has a limit of 60 requests per minute.","parameters":[{"schema":{"type":"string"},"in":"query","name":"include_artworks","required":true},{"schema":{"type":"string"},"in":"query","name":"include_original_songs","required":false},{"schema":{"type":"string"},"in":"query","name":"include_full_res_artworks","required":false},{"schema":{"default":20,"minimum":1,"maximum":100,"type":"number"},"in":"query","name":"take","required":false,"description":"The 'take' parameter is the number of items to be returned per page."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"The optional `cursor` parameter is the `lastEvaluatedKey` in the previous page."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetAllArtistsResponse","type":"array","items":{"title":"ArtistProfileData","type":"object","properties":{"username":{"type":"string"},"auth0_id":{"type":"string"},"profile_picture_s3_key":{"type":"string"},"cover_image_s3_key":{"type":"string"},"picture":{"type":"string"},"cover_image":{"type":"string"},"family_name":{"type":"string"},"given_name":{"type":"string"},"email":{"type":"string"},"profile_description":{"type":"string"},"url_external_website":{"type":"string"},"updated_at":{"title":"UpdatedAt","anyOf":[{"type":"string"},{"type":"number"}]},"user_role":{"anyOf":[{"title":"UserRole","anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["ai-company"]}]},{"title":"ArtistOnlyRole","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]}]}]},"stripe_customer_id":{"type":"string"},"subscription_tier":{"title":"SubscriptionTier","anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["pro"]},{"type":"string","enum":["ultra"]}]},"customer_name":{"type":"string"},"connected_api_user":{"type":"string"},"logo":{"type":"string"},"api_terms_and_conditions":{"type":"boolean"},"created_at":{"type":"number"},"zero_balance_email_sent":{"type":"boolean"},"low_balance_email_sent":{"type":"boolean"},"balance_treshold":{"type":"number"},"sub_labels":{"title":"SubLabels","type":"array","items":{"type":"string"}},"metrics":{"title":"Metrics","type":"object","properties":{"registry":{"title":"GetRegistryOptInOutMetricsResponse","type":"object","properties":{"optOutPercentage":{"type":"number"},"optInPercentage":{"type":"number"},"optOutAmount":{"type":"number"},"optInAmount":{"type":"number"},"numberOfReleases":{"type":"number"},"numberOfAssets":{"type":"number"},"numberOfArtists":{"type":"number"},"collectionWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"collectionWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"artistsWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"artistsWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"genreWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"genreWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"rulesForOptIn":{"type":"string"}},"required":["optOutPercentage","optInPercentage","optOutAmount","optInAmount","numberOfReleases","numberOfAssets"]}},"required":["registry"]},"spotify_user_id":{"type":"string"},"spotify_display_name":{"type":"string"},"verified":{"type":"boolean"},"tutorial_completed_at":{"type":"number"},"terms_and_conditions":{"type":"boolean"},"show_in_frontend":{"type":"boolean"},"collection_uuids":{"title":"CollectionUUIDs","type":"array","items":{"type":"string"}},"collections":{"title":"ArtistCollections","type":"array","items":{"title":"ArtistCollectionRecordIntersection","type":"object","properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"status":{"title":"CollectionStatus","anyOf":[{"type":"string","enum":["Draft"]},{"type":"string","enum":["Pending"]},{"type":"string","enum":["In training"]},{"type":"string","enum":["Opted-in"]},{"type":"string","enum":["Opted-out"]},{"type":"string","enum":["Denied"]}]},"status_description":{"type":"string"},"file_ids":{"title":"FileIds","type":"array","items":{"type":"string"}},"files":{"type":"array","items":{"title":"AssetMetadataRecordForDisplay","type":"object","properties":{"file_id":{"type":"string"},"isrc":{"type":"string"},"track_title":{"type":"string"},"file_path":{"type":"string"},"duration":{"type":"number"},"spotify_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"artist_names":{"deprecated":true,"title":"ArtistNames","type":"array","items":{"type":"string"}},"labels":{"title":"Labels","type":"array","items":{"type":"string"}}}}},"artworks_s3_keys":{"title":"ArtworksS3Keys","type":"array","items":{"type":"string"}},"artworks":{"title":"Artworks","type":"array","items":{"type":"string"}},"artworksFullRes":{"title":"ArtworksFullRes","type":"array","items":{"type":"string"}},"is_spotify_url":{"type":"boolean"},"prompt_guidance":{"type":"string"},"show_in_frontend":{"type":"boolean"},"styles":{"title":"Styles","type":"array","items":{"type":"string"}},"use_for_finetuning":{"type":"boolean"},"use_for_training":{"type":"boolean"},"no_audio_files_available":{"type":"boolean"},"knowledge_acquisition_ratio":{"type":"number"},"ai_influence":{"type":"string"},"external_id":{"type":"string"},"external_url":{"type":"string"},"original_cover_art_s3_key":{"type":"string"},"original_cover_art":{"type":"string"},"original_cover_art_filename":{"type":"string"},"original_cover_art_thumbnail":{"type":"string"},"audio_language":{"type":"string"},"spotify_id":{"type":"string"},"release_date":{"type":"string"},"release_date_precision":{"type":"string"},"popularity":{"type":"number"},"release_type":{"type":"string"},"recording_studio":{"type":"string"},"publisher":{"type":"string"},"producer":{"type":"string"},"composer":{"type":"string"},"song_writer":{"type":"string"},"rights_administrator":{"type":"string"},"rights_owner":{"type":"string"},"sub_label":{"type":"string"},"created_at":{"type":"number"},"updated_at":{"type":"number"},"collection_published_email_sent":{"type":"number"},"customer_name":{"type":"string"},"lora_weights_s3_key":{"type":"string"},"content_type":{"type":"string"},"attribution_setup_status":{"type":"string"},"suno_analysis_request_ids":{"title":"SunoAnalysisRequestIds","type":"array","items":{"type":"string"}},"suno_analysis_result":{"title":"GetExternalAiMonitoringResponse","description":"The external AI monitoring results for the given collection or user.","type":"array","items":{"title":"ExternalAiMonitoringObject","type":"object","properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"HistogramValues","type":"array","items":{"title":"HistogramValuesInner","type":"object","properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}},"required":["binStart","binEnd","count"]}}},"required":["duration","period","values"]}}},"required":["master"]}},"required":["trackName","histogramValues"]}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"SynthesisRules","type":"object","properties":{"no_attribution_greater_than":{"type":"number"},"no_attribution_smaller_than":{"type":"number"},"no_shared_attribution_with_artist":{"type":"string"},"no_shared_attribution_with_genre":{"type":"string"}}},"label":{"type":"string"},"use_for_training_timestamp":{"type":"number"},"ai_company_notifications":{"title":"AiCompanyNotifications","type":"object","properties":{"notifications_status":{"type":"string"},"notification_time":{"type":"number"},"number_of_contacted_ai_companies":{"type":"number"},"contacted_ai_companies":{"title":"AiCompanyNotifications","type":"array","items":{"title":"AiCompanyNotification","type":"object","properties":{"ai_company_name":{"type":"string"},"ai_company_email":{"type":"string"},"status":{"type":"string"},"notification_time":{"type":"number"},"acknowledged":{"type":"boolean"}}}}}},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"},"audio_embeddings_s3_keys":{"title":"AudioEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"midi_embeddings_s3_keys":{"title":"MIDIEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"lyrics_embeddings_s3_key":{"type":"string"},"fingerprint_db_s3_key":{"type":"string"},"lyrics_s3_key":{"type":"string"},"external_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"internal_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"ai_check_results":{"description":"AI detection results are provided for each stem. The master stem delivers the most reliable results, while results for individual stems are available in beta.","title":"AIDetectionResultsWithStem","type":"object","properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}}},"required":["master","instrumentals","vocals","bass","drums"]}},"required":["collection_uuid","username","status"]}},"attribution_setup_status":{"type":"string"},"suno_analysis_request_ids":{"title":"SunoAnalysisRequestIds","type":"array","items":{"type":"string"}},"suno_analysis_result":{"title":"GetExternalAiMonitoringResponse","description":"The external AI monitoring results for the given collection or user.","type":"array","items":{"title":"ExternalAiMonitoringObject","type":"object","properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"HistogramValues","type":"array","items":{"title":"HistogramValuesInner","type":"object","properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}},"required":["binStart","binEnd","count"]}}},"required":["duration","period","values"]}}},"required":["master"]}},"required":["trackName","histogramValues"]}},"company_name":{"description":"The name of the company/record label associated with the artist.","type":"string"},"lastEvaluatedKey":{"type":"string"}},"required":["username"]}}}}}}}},"/v1/ai/artist/{username}":{"get":{"operationId":"getArtistByUsername","summary":"Get artist by username","tags":["artist"],"description":"Get the data of one artist by the username including their published collections. By default, each user has a limit of 60 requests per minute.","parameters":[{"schema":{"type":"string"},"in":"query","name":"include_artworks","required":true},{"schema":{"type":"string"},"in":"query","name":"include_original_songs","required":false},{"schema":{"type":"string"},"in":"query","name":"include_full_res_artworks","required":false},{"schema":{"default":20,"minimum":1,"maximum":100,"type":"number"},"in":"query","name":"take","required":false,"description":"The 'take' parameter is the number of items to be returned per page."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"The optional `cursor` parameter is the `lastEvaluatedKey` in the previous page."},{"schema":{"enum":["collection_name"],"type":"string"},"in":"query","name":"collection_search_field","required":false,"description":"Field to search collections by."},{"schema":{"type":"string"},"in":"query","name":"collection_search_value","required":false,"description":"Value to match against the specified collection search field. Supports case-insensitive partial matching."},{"schema":{"enum":["release_date","collection_name","number_of_assets"],"type":"string"},"in":"query","name":"sort_by","required":false,"description":"Specifies the sorting criteria."},{"schema":{"enum":["asc","desc"],"type":"string"},"in":"query","name":"sort_order","required":false,"description":"Specifies the sorting order."},{"schema":{"minLength":1,"type":"string"},"in":"path","name":"username","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistProfileData","type":"object","properties":{"username":{"type":"string"},"auth0_id":{"type":"string"},"profile_picture_s3_key":{"type":"string"},"cover_image_s3_key":{"type":"string"},"picture":{"type":"string"},"cover_image":{"type":"string"},"family_name":{"type":"string"},"given_name":{"type":"string"},"email":{"type":"string"},"profile_description":{"type":"string"},"url_external_website":{"type":"string"},"updated_at":{"title":"UpdatedAt","anyOf":[{"type":"string"},{"type":"number"}]},"user_role":{"anyOf":[{"title":"UserRole","anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["ai-company"]}]},{"title":"ArtistOnlyRole","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]}]}]},"stripe_customer_id":{"type":"string"},"subscription_tier":{"title":"SubscriptionTier","anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["pro"]},{"type":"string","enum":["ultra"]}]},"customer_name":{"type":"string"},"connected_api_user":{"type":"string"},"logo":{"type":"string"},"api_terms_and_conditions":{"type":"boolean"},"created_at":{"type":"number"},"zero_balance_email_sent":{"type":"boolean"},"low_balance_email_sent":{"type":"boolean"},"balance_treshold":{"type":"number"},"sub_labels":{"title":"SubLabels","type":"array","items":{"type":"string"}},"metrics":{"title":"Metrics","type":"object","properties":{"registry":{"title":"GetRegistryOptInOutMetricsResponse","type":"object","properties":{"optOutPercentage":{"type":"number"},"optInPercentage":{"type":"number"},"optOutAmount":{"type":"number"},"optInAmount":{"type":"number"},"numberOfReleases":{"type":"number"},"numberOfAssets":{"type":"number"},"numberOfArtists":{"type":"number"},"collectionWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"collectionWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"artistsWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"artistsWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"genreWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"genreWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"rulesForOptIn":{"type":"string"}},"required":["optOutPercentage","optInPercentage","optOutAmount","optInAmount","numberOfReleases","numberOfAssets"]}},"required":["registry"]},"spotify_user_id":{"type":"string"},"spotify_display_name":{"type":"string"},"verified":{"type":"boolean"},"tutorial_completed_at":{"type":"number"},"terms_and_conditions":{"type":"boolean"},"show_in_frontend":{"type":"boolean"},"collection_uuids":{"title":"CollectionUUIDs","type":"array","items":{"type":"string"}},"collections":{"title":"ArtistCollections","type":"array","items":{"title":"ArtistCollectionRecordIntersection","type":"object","properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"status":{"title":"CollectionStatus","anyOf":[{"type":"string","enum":["Draft"]},{"type":"string","enum":["Pending"]},{"type":"string","enum":["In training"]},{"type":"string","enum":["Opted-in"]},{"type":"string","enum":["Opted-out"]},{"type":"string","enum":["Denied"]}]},"status_description":{"type":"string"},"file_ids":{"title":"FileIds","type":"array","items":{"type":"string"}},"files":{"type":"array","items":{"title":"AssetMetadataRecordForDisplay","type":"object","properties":{"file_id":{"type":"string"},"isrc":{"type":"string"},"track_title":{"type":"string"},"file_path":{"type":"string"},"duration":{"type":"number"},"spotify_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"artist_names":{"deprecated":true,"title":"ArtistNames","type":"array","items":{"type":"string"}},"labels":{"title":"Labels","type":"array","items":{"type":"string"}}}}},"artworks_s3_keys":{"title":"ArtworksS3Keys","type":"array","items":{"type":"string"}},"artworks":{"title":"Artworks","type":"array","items":{"type":"string"}},"artworksFullRes":{"title":"ArtworksFullRes","type":"array","items":{"type":"string"}},"is_spotify_url":{"type":"boolean"},"prompt_guidance":{"type":"string"},"show_in_frontend":{"type":"boolean"},"styles":{"title":"Styles","type":"array","items":{"type":"string"}},"use_for_finetuning":{"type":"boolean"},"use_for_training":{"type":"boolean"},"no_audio_files_available":{"type":"boolean"},"knowledge_acquisition_ratio":{"type":"number"},"ai_influence":{"type":"string"},"external_id":{"type":"string"},"external_url":{"type":"string"},"original_cover_art_s3_key":{"type":"string"},"original_cover_art":{"type":"string"},"original_cover_art_filename":{"type":"string"},"original_cover_art_thumbnail":{"type":"string"},"audio_language":{"type":"string"},"spotify_id":{"type":"string"},"release_date":{"type":"string"},"release_date_precision":{"type":"string"},"popularity":{"type":"number"},"release_type":{"type":"string"},"recording_studio":{"type":"string"},"publisher":{"type":"string"},"producer":{"type":"string"},"composer":{"type":"string"},"song_writer":{"type":"string"},"rights_administrator":{"type":"string"},"rights_owner":{"type":"string"},"sub_label":{"type":"string"},"created_at":{"type":"number"},"updated_at":{"type":"number"},"collection_published_email_sent":{"type":"number"},"customer_name":{"type":"string"},"lora_weights_s3_key":{"type":"string"},"content_type":{"type":"string"},"attribution_setup_status":{"type":"string"},"suno_analysis_request_ids":{"title":"SunoAnalysisRequestIds","type":"array","items":{"type":"string"}},"suno_analysis_result":{"title":"GetExternalAiMonitoringResponse","description":"The external AI monitoring results for the given collection or user.","type":"array","items":{"title":"ExternalAiMonitoringObject","type":"object","properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"HistogramValues","type":"array","items":{"title":"HistogramValuesInner","type":"object","properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}},"required":["binStart","binEnd","count"]}}},"required":["duration","period","values"]}}},"required":["master"]}},"required":["trackName","histogramValues"]}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"SynthesisRules","type":"object","properties":{"no_attribution_greater_than":{"type":"number"},"no_attribution_smaller_than":{"type":"number"},"no_shared_attribution_with_artist":{"type":"string"},"no_shared_attribution_with_genre":{"type":"string"}}},"label":{"type":"string"},"use_for_training_timestamp":{"type":"number"},"ai_company_notifications":{"title":"AiCompanyNotifications","type":"object","properties":{"notifications_status":{"type":"string"},"notification_time":{"type":"number"},"number_of_contacted_ai_companies":{"type":"number"},"contacted_ai_companies":{"title":"AiCompanyNotifications","type":"array","items":{"title":"AiCompanyNotification","type":"object","properties":{"ai_company_name":{"type":"string"},"ai_company_email":{"type":"string"},"status":{"type":"string"},"notification_time":{"type":"number"},"acknowledged":{"type":"boolean"}}}}}},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"},"audio_embeddings_s3_keys":{"title":"AudioEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"midi_embeddings_s3_keys":{"title":"MIDIEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"lyrics_embeddings_s3_key":{"type":"string"},"fingerprint_db_s3_key":{"type":"string"},"lyrics_s3_key":{"type":"string"},"external_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"internal_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"ai_check_results":{"description":"AI detection results are provided for each stem. The master stem delivers the most reliable results, while results for individual stems are available in beta.","title":"AIDetectionResultsWithStem","type":"object","properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}}},"required":["master","instrumentals","vocals","bass","drums"]}},"required":["collection_uuid","username","status"]}},"attribution_setup_status":{"type":"string"},"suno_analysis_request_ids":{"title":"SunoAnalysisRequestIds","type":"array","items":{"type":"string"}},"suno_analysis_result":{"title":"GetExternalAiMonitoringResponse","description":"The external AI monitoring results for the given collection or user.","type":"array","items":{"title":"ExternalAiMonitoringObject","type":"object","properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"HistogramValues","type":"array","items":{"title":"HistogramValuesInner","type":"object","properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}},"required":["binStart","binEnd","count"]}}},"required":["duration","period","values"]}}},"required":["master"]}},"required":["trackName","histogramValues"]}},"company_name":{"description":"The name of the company/record label associated with the artist.","type":"string"},"lastEvaluatedKey":{"type":"string"}},"required":["username"]}}}}}}},"/v1/ai/files/upload-files":{"post":{"operationId":"uploadFiles","summary":"Upload files as form-data","tags":["files"],"description":"Upload audio, image, video, or metadata files as form-data for use with other endpoints.\nAllowed file extensions:\n- Audio: .wav, .mp3, .m4a, .flac\n- Image: .jpeg, .jpg, .png\n- Video: .mp4\n- Metadata: .json, .npy\n\nAll uploads are securely stored on the server for a limited time.\nMaximum file size: 200MB.","parameters":[{"schema":{"enum":["audio","image","video","metadata"],"title":"ContentType","type":"string"},"in":"query","name":"contentType","required":true},{"schema":{"type":"string","pattern":"^multipart\\/form-data"},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostUploadFilesResponse","type":"object","properties":{"filePaths":{"title":"FilePaths","type":"array","items":{"type":"string"}}},"required":["filePaths"]}}}}}}},"/v1/ai/files/generate-upload-urls":{"post":{"operationId":"generatePutUploadUrls","summary":"Generate signed URLs to put files to S3","tags":["files"],"description":"Returns the signed url for the given filenames.","requestBody":{"content":{"application/json":{"schema":{"title":"UploadUrlRequest","type":"object","properties":{"filenames":{"title":"Filenames","type":"array","items":{"type":"string"}}},"required":["filenames"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostUploadUrlResponse","type":"array","items":{"title":"UploadUrl","type":"object","properties":{"originalFilename":{"description":"The original name of the file.","type":"string"},"url":{"description":"A pre-signed URL that allows the client to securely upload the file to S3.","type":"string"},"key":{"description":"A unique identifier for the file used to identify and retrieve it in storage.","type":"string"}},"required":["originalFilename","url","key"]}}}}}}}},"/v1/ai/files/get-uploaded-files":{"get":{"operationId":"getUploadedFiles","summary":"Get signed URLs of previously uploaded files","tags":["files"],"description":"Get signed URLs for files that were previously uploaded with a PUT signed URL generated from the `/generate-upload-urls` endpoint.","parameters":[{"schema":{"title":"FileKeys","type":"array","items":{"type":"string"}},"in":"query","name":"keys","required":true,"description":"The S3 key of the file retrieved from the `/generate-upload-urls` endpoint. Multiple keys can be added to the query string simultaneouly like this: `/get-uploaded-files?keys=key1.mp3&keys=key2.mp3`"}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetUploadedFilesResponse","type":"array","items":{"title":"GetUploadedFilesResponseInner","type":"object","properties":{"key":{"description":"S3 key to identify the file","type":"string"},"url":{"description":"Signed URL that can be used to GET the previously uploaded file","type":"string"},"originalFilename":{"description":"Original filename of the uploaded file","type":"string"}},"required":["key","url"]}}}}}}}},"/v1/ai/audio-ldm/{requestId}":{"get":{"operationId":"getAudioLdmResults","summary":"Audio LDM request results","tags":["audio-ai"],"description":"Get the result for a queued Audio LDM request by providing the corresponding `requestId` obtained from other Audio LDM endpoints.","parameters":[{"schema":{"default":5,"minimum":-1,"type":"integer"},"in":"query","name":"topNAttributionResults","required":false,"description":"Specifies the number of top attribution results to be returned. A value of -1 indicates that all attribution results should be returned."},{"schema":{"minLength":1,"type":"string"},"in":"path","name":"requestId","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetAudioLdmResponse","type":"object","properties":{"status":{"title":"UserRequestStatus","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]}]},"errorMessage":{"type":"string"},"endpoint":{"type":"string"},"requestId":{"type":"string"},"request_body":{},"createdAt":{"type":"number"},"audiosSignedUrls":{"title":"AudiosSignedUrls","type":"array","items":{"type":"string"}},"stemSplittedAudiosSignedUrls":{"title":"StemSplittedAudiosSignedUrls","type":"array","items":{"type":"string"}},"contentAudio":{"type":"string"},"seed":{"type":"number"},"attribution":{"title":"Attribution","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","anyOf":[{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}},{"type":"null"}]},"attributionPerCollection":{"title":"AttributionWithStems","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content. The attribution is returned for the master audio as well as for each individual stem. Additionally, attribution is calculated for multiple segments of the entire song. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"attributionPerTrack":{"title":"AttributionWithStems","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content. The attribution is returned for the master audio as well as for each individual stem. Additionally, attribution is calculated for multiple segments of the entire song. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"provenance":{"title":"Provenance","anyOf":[{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}},{"type":"null"}]},"artistProfilePictures":{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"}},"required":["artistName","picture"]}}]},"requestData":{"title":"AudioLdmRequestData","type":"object","properties":{"user_id":{"type":"string"},"request_id":{"type":"string"},"batch_size":{"type":"number"},"seed":{"title":"Seed","anyOf":[{"type":"number"},{"type":"null"}]},"num_train_steps":{"type":"integer"},"text_prompt":{"title":"TextPrompt","anyOf":[{"type":"string"},{"type":"null"}]},"artist_preset":{"title":"ArtistPresetInRequestData","type":"array","items":{"title":"ArtistPresetInRequestData","type":"object","properties":{"collection_uuid":{"type":"string"},"preset_attribution":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"artist":{"type":"string"}}}}},"required":["user_id","request_id"]},"audioAttributionAnalysis":{"title":"SimilarAudioFilesPerStem","description":"Audio attribution analysis extracts the analysis metrics for a given audio file. Metrics are as follows: Attribution likelihood describes the probability that a piece of content from the registry had an influence on the creation of a new piece of content. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"instrumentals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"vocals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"bass":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"drums":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}}},"required":["master","instrumentals","vocals","bass","drums"]},"optOutAnalysis":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"musicalityAnalysis":{"title":"Musicality Analysis","description":"Detailed analysis of musicality, including metadata and scoring for various segments.","type":"object","properties":{"master":{"title":"ChunkWiseMusicalityAnalysis","type":"array","items":{"title":"ChunkWiseMusicalityAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The musical analysis values for the given responses.","title":"MusicalityArray","type":"array","items":{"title":"MusicalityInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"MusicalityValues","type":"object","properties":{"sampling_rate":{"type":"number"},"song_length":{"type":"number"},"key":{"type":"string"},"key_confidence":{"type":"number"},"tempo":{"type":"number"},"pitch":{"type":"number"},"genre_analysis":{"title":"GenreAnalysisValues","type":"array","items":{"title":"GenreAnalysisValuesInner","type":"object","properties":{"genre":{"type":"string"},"values":{"title":"GenreAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}},"required":["genre","values"]}},"mood_analysis":{"title":"MoodAnalysisValues","type":"array","items":{"title":"MoodAnalysisValuesInner","type":"object","properties":{"mood":{"type":"string"},"values":{"title":"MoodAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}},"required":["mood","values"]}}},"required":["genre_analysis","mood_analysis"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"aiDnaVisualization":{"title":"VisualizationS3KeysResponse","type":"array","items":{"title":"AI DNA Visualization","description":"Images for the AI DNA Visualization","type":"object","properties":{"master":{"title":"ChunkWiseVisualizationS3keysResponse","type":"array","items":{"title":"VisualizationS3keysResponseInner","type":"object","properties":{"filename":{"type":"string"},"signedUrls":{"title":"SignedUrls","type":"array","items":{"type":"string"}}},"required":["signedUrls"]}}},"required":["master"]}},"lyricsAnalysis":{"title":"LyricsAnalysis","description":"The result of the lyrics analysis.","type":"object","properties":{"filename":{"description":"The name of the file containing the uploaded lyrics.","type":"string"},"lyrics":{"description":"The input lyrics.","type":"string"},"lyrics_attribution":{"description":"The lyrics attribution values for the (translated) input lyrics.","title":"LyricsAttribution","type":"array","items":{"title":"LyricsAttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration (in number of words) of the inspected segment, representing the length of each analyzed time window.","type":"number"},"period":{"description":"The period (in number of words) of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis.","type":"number"},"values":{"title":"LyricsAttribution","type":"array","items":{"title":"LyricsAttributionInner","type":"object","properties":{"score":{"description":"The degree of copyright infringement per chunk related to the lyrics.","title":"LyricsAttributionInnerScore","type":"array","items":{"type":"number"}},"mean_score":{"description":"The mean degree of copyright infringement over the whole lyrics.","type":"number"},"similar_lyrics_inspected":{"description":"The corresponding lyrics from the new song that match the original lyrics.","title":"LyricsAttributionInnerSimilarLyricsInspected","type":"array","items":{"type":"string"}},"similar_lyrics_original":{"description":"The most similar lyrics from the original song.","title":"LyricsAttributionInnerSimilarLyricsOriginal","type":"array","items":{"type":"string"}},"track_name":{"description":"The name of the song.","type":"string"},"track":{"description":"The track associated with the original lyrics.","type":"string"},"is_spotify_url":{"description":"Whether the returned track URL is a Spotify URL or not.","type":"boolean"}},"required":["score","similar_lyrics_inspected","similar_lyrics_original","track","is_spotify_url"]}}},"required":["duration","period","values"]}},"translated_lyrics":{"description":"The translated version of the lyrics, if applicable.","type":"string"}}},"aiGeneratedLikelihood":{"description":"AI detection results are provided for each stem. The master stem delivers the most reliable results, while results for individual stems are available in beta.","title":"AIDetectionResultsWithStem","type":"object","properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}}},"required":["master","instrumentals","vocals","bass","drums"]},"similarTracks":{"title":"SimilarTracks","type":"array","items":{"title":"SimilarTracksInner","type":"object","properties":{"track":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["track","signed_url","is_spotify_url"]}},"artist_uuid":{"type":"string"},"originalFilename":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/external-ai-monitoring":{"get":{"operationId":"getExternalAIMonitoring","summary":"External AI monitoring","tags":["audio-ai"],"description":"Get the result of the external AI monitoring.","parameters":[{"schema":{"type":"string"},"in":"query","name":"collectionUuid","required":false}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"The external AI monitoring results for the given collection or user.","content":{"application/json":{"schema":{"title":"GetExternalAiMonitoringResponse","description":"The external AI monitoring results for the given collection or user.","type":"array","items":{"title":"ExternalAiMonitoringObject","type":"object","properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"HistogramValues","type":"array","items":{"title":"HistogramValuesInner","type":"object","properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}},"required":["binStart","binEnd","count"]}}},"required":["duration","period","values"]}}},"required":["master"]}},"required":["trackName","histogramValues"]}}}}}}}},"/v1/ai/audio-ldm/text-to-audio":{"post":{"operationId":"textToAudio","summary":"Text to audio","tags":["audio-ai"],"description":"Text to audio synthesis. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostTextToAudioBody","type":"object","properties":{"prompt":{"description":"Text input to condition the audio synthesis. More details improve the resulting audio quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"audioLength":{"minimum":5,"maximum":60,"description":"Length of generated audio in seconds.","type":"integer"},"genre":{"description":"The main category of music that the song belongs to, such as Rock, Jazz, Pop, etc.","type":"string"},"subGenre":{"description":"A more specific classification within the main genre, such as Hard Rock, Bebop, Trap, etc.","type":"string"},"mood":{"description":"The emotional tone or atmosphere of the song, such as happy, sad, energetic, mellow, etc.","type":"string"},"songKey":{"description":"The key in which the song is composed, indicating the scale and tonal center, such as G major, A minor, etc.","type":"string"},"tempo":{"description":"The speed or pace of the song, typically measured in beats per minute (BPM).","type":"string"},"negativePrompt":{"description":"A list of negative attributes or undesired features that describes what the desired audio should **not** look like.","type":"string"},"splitStem":{"description":"Flag to split the audio into stems or not.","type":"boolean"},"inferenceSteps":{"minimum":10,"maximum":50,"description":"Number of diffusion steps that iteratively improve the audio files generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the audio closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"batchSize":{"minimum":1,"maximum":4,"description":"Number of audio files that are generated in a single request.","type":"integer"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"surpriseMe":{"description":"Flag whether to create a surprise text description fitting any given presets.","type":"boolean"},"modelName":{"description":"modelName is an optional parameter that lets you choose between available models (baseline_model or sony_csl_diff_a_riff) for prompt-guided audio synthesis.","anyOf":[{"type":"string","enum":["baseline_model"]},{"type":"string","enum":["sony_csl_diff_a_riff"]}]}},"required":["prompt","audioLength"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/text-to-artist-audio":{"post":{"operationId":"textToArtistAudio","summary":"Text to Artist Audio","tags":["audio-ai"],"description":"Artist-based text-to-audio synthesis. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostTextToArtistAudioBody","type":"object","properties":{"prompt":{"description":"Text input to condition the audio synthesis. More details improve the resulting audio quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"audioLength":{"minimum":5,"maximum":60,"description":"Length of generated audio in seconds.","type":"integer"},"artistPreset":{"minItems":1,"maxItems":2,"description":"List of artist collections who should contribute to the generated data.","type":"array","items":{"title":"ArtistPresetObject","type":"object","properties":{"collectionUuid":{"description":"A collection can be any kind of release, such as an album, a single, EP, compilation, or any other mix of audio files or image files. Each collection has a `collectionUuid`. Every artist/label can create multiple collections of artworks. New collections can be created with the `/artist/upload-artwork` endpoint and existing collections can be obtained with the `/artist/collections` endpoint.","type":"string"},"presetAttribution":{"minimum":0,"maximum":1,"description":"Percentage of how much the artist collection should contribute to the generated data.","type":"number"}},"required":["collectionUuid"]}},"genre":{"description":"The main category of music that the song belongs to, such as Rock, Jazz, Pop, etc.","type":"string"},"subGenre":{"description":"A more specific classification within the main genre, such as Hard Rock, Bebop, Trap, etc.","type":"string"},"mood":{"description":"The emotional tone or atmosphere of the song, such as happy, sad, energetic, mellow, etc.","type":"string"},"songKey":{"description":"The key in which the song is composed, indicating the scale and tonal center, such as G major, A minor, etc.","type":"string"},"tempo":{"description":"The speed or pace of the song, typically measured in beats per minute (BPM).","type":"string"},"negativePrompt":{"description":"A list of negative attributes or undesired features that describes what the desired audio should **not** look like.","type":"string"},"splitStem":{"description":"Flag to split the audio into stems or not.","type":"boolean"},"inferenceSteps":{"minimum":10,"maximum":50,"description":"Number of diffusion steps that iteratively improve the audio files generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the audio closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"batchSize":{"minimum":1,"maximum":4,"description":"Number of audio files that are generated in a single request.","type":"integer"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"surpriseMe":{"description":"Flag whether to create a surprise text description fitting any given presets.","type":"boolean"},"modelName":{"description":"modelName is an optional parameter that lets you choose between available models (baseline_model or sony_csl_diff_a_riff) for prompt-guided audio synthesis.","anyOf":[{"type":"string","enum":["baseline_model"]},{"type":"string","enum":["sony_csl_diff_a_riff"]}]}},"required":["prompt","audioLength","artistPreset"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/audio-to-audio":{"post":{"operationId":"audioToAudio","summary":"Audio to audio","tags":["audio-ai"],"description":"Prompt guided audio to audio synthesis. Use the audio to audio endpoint when aiming to adjust the style of an audio file based on the prompt. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostAudioToAudioBody","type":"object","properties":{"prompt":{"description":"Text input to condition the audio synthesis. More details improve the resulting audio quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"contentAudioPath":{"description":" The `contentAudioPath` can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"audioLength":{"minimum":5,"maximum":60,"description":"Length of generated audio in seconds.","type":"integer"},"genre":{"description":"The main category of music that the song belongs to, such as Rock, Jazz, Pop, etc.","type":"string"},"subGenre":{"description":"A more specific classification within the main genre, such as Hard Rock, Bebop, Trap, etc.","type":"string"},"mood":{"description":"The emotional tone or atmosphere of the song, such as happy, sad, energetic, mellow, etc.","type":"string"},"songKey":{"description":"The key in which the song is composed, indicating the scale and tonal center, such as G major, A minor, etc.","type":"string"},"tempo":{"description":"The speed or pace of the song, typically measured in beats per minute (BPM).","type":"string"},"splitStem":{"description":"Flag to split the audio into stems or not.","type":"boolean"},"inferenceSteps":{"minimum":10,"maximum":50,"description":"Number of diffusion steps that iteratively improve the audio files generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the audio closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"batchSize":{"minimum":1,"maximum":4,"description":"Number of audio files that are generated in a single request.","type":"integer"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"generateProvenance":{"description":"Flag whether to enable the provenance calculation. Provenance describes the entire influence history of a piece of content generated using AI. It can be seen as the content's attribution over time. Whenever any data is used to generate new content using AI, the provenance of that new content is extended to include the influence of that data. In summary, the provenance of a piece of content is obtained by computing the full attribution to all training and input data each time AI is used to generate or alter that piece of content.","type":"boolean"},"surpriseMe":{"description":"Flag whether to create a surprise text description fitting any given presets.","type":"boolean"},"OptOutAnalysis":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"modelName":{"description":"modelName is an optional parameter that lets you choose between available models (baseline_model or sony_csl_diff_a_riff) for prompt-guided audio synthesis.","anyOf":[{"type":"string","enum":["baseline_model"]},{"type":"string","enum":["sony_csl_diff_a_riff"]}]}},"required":["prompt","contentAudioPath","audioLength"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/stem-split":{"post":{"operationId":"stemSplit","summary":"Stem split","tags":["audio-ai"],"description":"Split an audio file into stems. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostStemSplitBody","type":"object","properties":{"contentAudioPath":{"description":" The `contentAudioPath` can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentAudioPath"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/calculate-audio-attribution":{"post":{"operationId":"attributionCalculation","summary":"Attribution calculation","tags":["audio-ai"],"description":"Calculate the attribution of a given audio. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostCalculateAttributionBodyAudio","type":"object","properties":{"contentAudioPath":{"description":" The `contentAudioPath` can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"prompt":{"description":"Text input to condition the audio synthesis. More details improve the resulting audio quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentAudioPath","prompt"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/audio-attribution-analysis":{"post":{"operationId":"audioAttributionAnalysis","summary":"Audio attribution analysis","tags":["audio-ai"],"description":"Audio attribution analysis extracts the analysis metrics for a given audio file. Metrics are as follows: Attribution likelihood describes the probability that a piece of content from the registry had an influence on the creation of a new piece of content.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostAudioAttributionAnalysisBody","type":"object","properties":{"contentAudioPath":{"description":" The `contentAudioPath` can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"lyricsAnalysis":{"additionalProperties":false,"title":"PostLyricsAnalysisInfo","description":"Lyrics analysis provides insights into the influence of lyrics from other songs.","type":"object","properties":{"getAttribution":{"description":"Flag whether to get attribution for lyrics. ","default":true,"type":"boolean"},"desiredLanguage":{"description":"Whether to translate lyrics to given language. Choices: English, Spanish, French, Italian, German, Portuguese, Chinese, Korean, Japanese, Arabic","type":"string"}}},"topNMatches":{"minimum":1,"maximum":100,"default":3,"description":"`topNMatches` refers to the number of highest-ranking N audios that are most similar to the input audio provided for comparison.","type":"integer"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentAudioPath","topNMatches"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/opt-out-analysis":{"post":{"operationId":"optOutAnalysis","summary":"Opt out analysis","tags":["audio-ai"],"description":"Verify whether the provided audio is eligible for AI training or if it has been opted out of such use.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostOptOutAnalysisBody","type":"object","properties":{"contentAudioPath":{"description":" The `contentAudioPath` can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentAudioPath"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/accidental-infringement-check":{"post":{"operationId":"accidentalInfringementCheck","summary":"Accidental infringement check","tags":["audio-ai"],"description":"Verify whether the provided audio has potential accidental infringements based on the external Shazam flag","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostAccidentalInfringementCheckBody","type":"object","properties":{"contentAudioPath":{"description":" The `contentAudioPath` can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentAudioPath"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/lyrics-analysis":{"post":{"operationId":"lyricsAnalysis","summary":"Lyrics analysis","tags":["audio-ai"],"description":"Lyrics analysis involves transcribing, translating, and calculating attribution for the lyrics.","requestBody":{"content":{"application/json":{"schema":{"title":"PostLyricsAnalysisBody","type":"object","properties":{"contentAudioPath":{"description":" The `contentAudioPath` can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"lyricsAnalysis":{"additionalProperties":false,"title":"PostLyricsAnalysisInfoWithInputLyrics","description":"Lyrics analysis provides insights into the influence of lyrics from other songs.","type":"object","properties":{"getAttribution":{"description":"Flag whether to get attribution for lyrics. ","default":true,"type":"boolean"},"desiredLanguage":{"description":"Whether to translate lyrics to given language. Choices: English, Spanish, French, Italian, German, Portuguese, Chinese, Korean, Japanese, Arabic","type":"string"},"inputLyrics":{"description":"Input lyrics to translate or attribute.","type":"string"}}},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["lyricsAnalysis"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/ai-generated-audio-detection":{"post":{"operationId":"aiDetection","summary":"AI Generated Audio Detection","tags":["audio-ai"],"description":"Detect if a song was created or altered with AI. Ensure authenticity and originality in your catalog by identifying synthetic audio content.","requestBody":{"content":{"application/json":{"schema":{"title":"PostDetectAIGeneratedAudioBody","type":"object","properties":{"contentAudioPath":{"description":" The `contentAudioPath` can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"enableGeneratorDetection":{"default":true,"description":"Enable generator detection to identify specific AI models used in audio generation. When enabled, class probabilities for different generators are returned. Currently available in beta.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentAudioPath"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/similar-song-finder":{"post":{"operationId":"similarSongFinder","summary":"Similar song finder","tags":["audio-ai"],"description":"The Similar Song Finder endpoint analyzes the entire duration of a song to identify tracks that sound most similar.​","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostSimilarSongFinderBody","type":"object","properties":{"contentAudioPath":{"description":" The `contentAudioPath` can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"topNMatches":{"minimum":1,"maximum":100,"default":3,"description":"`topNMatches` refers to the number of highest-ranking N audios that are most similar to the input audio provided for comparison.","type":"integer"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentAudioPath","topNMatches"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/song-analysis":{"post":{"operationId":"songAnalysis","summary":"Song Analysis","tags":["audio-ai"],"description":"Song analysis involves stem split, similar song finder, AI detection, lyrics transcription for the song.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostSongAnalysis","type":"object","properties":{"contentAudioPath":{"description":" The `contentAudioPath` can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"musicalityAnalysisMode":{"default":"combined","description":"Specifies if the musicality analysis should be done separately, combined with other parts, or not at all.","title":"MusicalityAnalysisMode","anyOf":[{"type":"string","enum":["separate"]},{"type":"string","enum":["combined"]},{"type":"string","enum":["none"]}]},"lyricsAnalysis":{"additionalProperties":false,"title":"PostLyricsAnalysisInfo","description":"Lyrics analysis provides insights into the influence of lyrics from other songs.","type":"object","properties":{"getAttribution":{"description":"Flag whether to get attribution for lyrics. ","default":true,"type":"boolean"},"desiredLanguage":{"description":"Whether to translate lyrics to given language. Choices: English, Spanish, French, Italian, German, Portuguese, Chinese, Korean, Japanese, Arabic","type":"string"}}},"enableGeneratorDetection":{"default":true,"description":"Enable generator detection to identify specific AI models used in audio generation. When enabled, class probabilities for different generators are returned. Currently available in beta.","type":"boolean"},"topNMatches":{"minimum":1,"maximum":100,"default":3,"description":"`topNMatches` refers to the number of highest-ranking N audios that are most similar to the input audio provided for comparison.","type":"integer"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentAudioPath","topNMatches"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/audio-ldm/audio-attribution-setup":{"post":{"operationId":"audioAttributionSetup","summary":"Audio Attribution setup","tags":["audio-ai"],"description":"Prepares the attribution environment and embeddings from specified prefix.","requestBody":{"content":{"application/json":{"schema":{"title":"PostAudioAttributionSetupBody","type":"object","properties":{"collectionUuid":{"description":"A collection can be any kind of release, such as an album, a single, EP, compilation, or any other mix of audio files or image files. Each collection has a `collectionUuid`. Every artist/label can create multiple collections of artworks. New collections can be created with the `/artist/upload-artwork` endpoint and existing collections can be obtained with the `/artist/collections` endpoint.","type":"string"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["collectionUuid"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostAudioLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/{requestId}":{"get":{"operationId":"getResultByRequestId","summary":"LDM request results","tags":["image-ai"],"description":"Get the result for a queued LDM request by providing the corresponding `requestId` obtained from other LDM endpoints.","parameters":[{"schema":{"default":5,"minimum":-1,"type":"integer"},"in":"query","name":"topNAttributionResults","required":false,"description":"Specifies the number of top attribution results to be returned. A value of -1 indicates that all attribution results should be returned."},{"schema":{"minLength":1,"type":"string"},"in":"path","name":"requestId","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetLdmResponse","type":"object","properties":{"status":{"title":"UserRequestStatus","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]}]},"errorMessage":{"type":"string"},"endpoint":{"type":"string"},"requestId":{"type":"string"},"request_body":{},"createdAt":{"type":"number"},"imagesSignedUrls":{"title":"ImagesSignedUrls","type":"array","items":{"type":"string"}},"previewImagesSignedUrls":{"title":"PreviewImagesSignedUrls","type":"array","items":{"type":"string"}},"attribution":{"title":"Attribution","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","anyOf":[{"type":"null"},{"title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}]},"provenance":{"title":"Provenance","anyOf":[{"type":"null"},{"title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}]},"contentImage":{"type":"string"},"styleImage":{"type":"string"},"maskImage":{"type":"string"},"artistProfilePictures":{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"}},"required":["artistName","picture"]}}]},"seed":{"type":"number"},"requestData":{"title":"GetLdmRequestData","type":"object","properties":{"user_id":{"type":"string"},"request_id":{"type":"string"},"apply_watermark":{"type":"boolean"},"custom_watermark":{"title":"CustomWatermark","anyOf":[{"type":"null"},{"type":"string"}]},"artist_preset":{"title":"ArtistPresets","type":"array","items":{"title":"ArtistPresetsInner","type":"object","properties":{"collection_uuid":{"type":"string"},"preset_attribution":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"artist":{"type":"string"}}}},"batch_size":{"type":"number"},"negative_prompt":{"type":"string"},"remove_bg":{"type":"boolean"},"resolution":{"type":"string"},"seed":{"title":"Seed","anyOf":[{"type":"number"},{"type":"null"}]},"style_preset":{"title":"StylePreset","anyOf":[{"type":"null"},{"type":"string"}]},"upscale":{"title":"Upscale","anyOf":[{"type":"null"},{"type":"number"}]},"controlnet":{"title":"ControlNetData","type":"object","properties":{"conditioning_scale":{"title":"ConditioningScale","anyOf":[{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"},{"title":"ConditioningScaleArray","type":"array","items":{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"}},{"type":"null"}]},"guidance_start":{"type":"number"},"guidance_end":{"type":"number"}}},"artist_uuid":{"type":"string"},"train_text_encoder":{"type":"boolean"},"num_train_steps":{"type":"integer"},"learning_rate":{"type":"number"},"creative_inpainting":{"type":"boolean"},"text_prompt":{"title":"TextPrompt","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["user_id","request_id"]},"imageAttributionAnalysis":{"title":"ImageAttributionAnalysis","description":"Image attribution analysis extracts the analysis metrics for a given image. Metrics are as follows: Attribution likelihood describes the probability that a piece of content from the registry had an influence on the creation of a new piece of content. Cross-correlation describes how similar the images are, independent of spatial shifts. Color match describes how similar the color distributions of RGB are. And pixel-wise average difference gives the average distance in between images.","type":"object","properties":{"similarFiles":{"title":"SimilarImageFilesWithMetrics","type":"array","items":{"title":"SimilarImageFile","type":"object","properties":{"attribution_likelihood":{"type":"number"},"cross_correlation":{"type":"number"},"color_matching":{"title":"ColorMatching","type":"object","properties":{"g_channel":{"type":"number"},"r_channel":{"type":"number"},"b_channel":{"type":"number"}},"required":["g_channel","r_channel","b_channel"]},"color_matching_combined":{"type":"number"},"pixelwise_similarity":{"type":"number"},"filename":{"type":"string"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}},"required":["attribution_likelihood","color_matching","pixelwise_similarity"]}},"topMetrics":{"title":"TopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"cross_correlation":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"color_matching":{"title":"TopColorMatching","type":"object","properties":{"g_channel":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"r_channel":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"b_channel":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["g_channel","r_channel","b_channel"]},"color_matching_combined":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"pixelwise_similarity":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"IdenticalMatchSignedUrls","type":"array","items":{"title":"IdenticalMatchSignedUrlsInner","anyOf":[{"type":"string"},{"type":"null"}]}},"signed_urls_thumbnails":{"title":"IdenticalMatchSignedUrlsThumbnails","type":"array","items":{"title":"IdenticalMatchSignedUrlsThumbnailsInner","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls","signed_urls_thumbnails"]}},"required":["attribution_likelihood","cross_correlation","color_matching","color_matching_combined","pixelwise_similarity","identical_matches"]}},"required":["similarFiles","topMetrics"]},"originalFilename":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/style-presets":{"get":{"operationId":"getStylePresets","summary":"Style presets for ldm","tags":["image-ai"],"description":"Get the style preset parameters for ldm.","security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetStylePresetResponse","type":"object","properties":{"Painting":{},"Digital Art":{},"Photography":{},"Anime":{}},"required":["Painting","Digital Art","Photography","Anime"]}}}}}}},"/v1/ai/ldm/queue":{"post":{"operationId":"textToImage","summary":"Text to Image","tags":["image-ai"],"description":"Text to image synthesis. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"TextToImageRequest","type":"object","properties":{"prompt":{"description":"Text input to condition the image synthesis. More details improve the resulting image quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"resolution":{"description":"Desired resolution of the output image in the format {width}x{height}.","title":"Resolution","anyOf":[{"type":"string","enum":["512x512"]},{"type":"string","enum":["1024x1024"]},{"type":"string","enum":["1280x720"]},{"type":"string","enum":["1280x800"]},{"type":"string","enum":["1200x800"]},{"type":"string","enum":["1024x768"]},{"type":"string","enum":["720x1280"]},{"type":"string","enum":["800x1280"]},{"type":"string","enum":["800x1200"]},{"type":"string","enum":["768x1024"]},{"type":"string","enum":["592x1280"]},{"type":"string","enum":["576x1280"]}]},"negativePrompt":{"description":"A list of negative attributes or undesired features that describes what the desired image should **not** look like.","type":"string"},"applyWatermark":{"description":"Flag whether to apply a watermark to the images or not. The watermark can be either the Sureel watermark or a custom watermark provided through the `customWatermark` parameter.","type":"boolean"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"stylePreset":{"description":"Preset styles for image generation that describe the desired style of the image, such as “painting”, “photography”, “anime” or “digital art”. It must be a comma-separated list of styles.","title":"StylePreset","type":"string"},"artistPreset":{"maxItems":2,"description":"List of artist collections who should contribute to the generated data.","title":"ArtistPresetLengthMax2","type":"array","items":{"title":"ArtistPresetObject","type":"object","properties":{"collectionUuid":{"description":"A collection can be any kind of release, such as an album, a single, EP, compilation, or any other mix of audio files or image files. Each collection has a `collectionUuid`. Every artist/label can create multiple collections of artworks. New collections can be created with the `/artist/upload-artwork` endpoint and existing collections can be obtained with the `/artist/collections` endpoint.","type":"string"},"presetAttribution":{"minimum":0,"maximum":1,"description":"Percentage of how much the artist collection should contribute to the generated data.","type":"number"}},"required":["collectionUuid"]}},"upscale":{"description":"Factor by which the generated images should be upscaled. If undefined, no upscaling will be applied.","title":"Upscale","anyOf":[{"type":"number","enum":[2]},{"type":"number","enum":[4]}]},"inferenceSteps":{"minimum":10,"maximum":100,"description":"Number of diffusion steps that iteratively improve the images generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the image closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"batchSize":{"minimum":1,"maximum":12,"description":"Number of images that are generated in a single request.","type":"integer"},"removeBg":{"description":"Flag whether to remove the semantic background of the image.","type":"boolean"},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["prompt","resolution"]}}},"required":true},"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/reimagine":{"post":{"operationId":"reimagine","summary":"Reimagine image","tags":["image-ai"],"description":"Prompt-guided image-to-image synthesis. Use the reimagine endpoint when aiming to adjust an image based on the prompt. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ReimagineRequest","type":"object","properties":{"prompt":{"description":"Text input to condition the image synthesis. More details improve the resulting image quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"negativePrompt":{"description":"A list of negative attributes or undesired features that describes what the desired image should **not** look like.","type":"string"},"applyWatermark":{"description":"Flag whether to apply a watermark to the images or not. The watermark can be either the Sureel watermark or a custom watermark provided through the `customWatermark` parameter.","type":"boolean"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"stylePreset":{"description":"Preset styles for image generation that describe the desired style of the image, such as “painting”, “photography”, “anime” or “digital art”. It must be a comma-separated list of styles.","title":"StylePreset","type":"string"},"artistPreset":{"title":"ArtistPresetObjectArray","type":"array","items":{"title":"ArtistPresetObject","type":"object","properties":{"collectionUuid":{"description":"A collection can be any kind of release, such as an album, a single, EP, compilation, or any other mix of audio files or image files. Each collection has a `collectionUuid`. Every artist/label can create multiple collections of artworks. New collections can be created with the `/artist/upload-artwork` endpoint and existing collections can be obtained with the `/artist/collections` endpoint.","type":"string"},"presetAttribution":{"minimum":0,"maximum":1,"description":"Percentage of how much the artist collection should contribute to the generated data.","type":"number"}},"required":["collectionUuid"]}},"upscale":{"description":"Factor by which the generated images should be upscaled. If undefined, no upscaling will be applied.","title":"Upscale","anyOf":[{"type":"number","enum":[2]},{"type":"number","enum":[4]}]},"inferenceSteps":{"minimum":10,"maximum":100,"description":"Number of diffusion steps that iteratively improve the images generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the image closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"strength":{"description":"The `strength` influences the generation's creativity. Higher values lead to a larger divergence from the content image. If given as an array, it has to have the same length as the batch size.","title":"Strength","anyOf":[{"minimum":0,"maximum":1,"type":"number"},{"minItems":1,"maxItems":12,"title":"StrengthArray","type":"array","items":{"minimum":0,"maximum":1,"type":"number"}}]},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"batchSize":{"minimum":1,"maximum":12,"description":"Number of images that are generated in a single request.","type":"integer"},"removeBg":{"description":"Flag whether to remove the semantic background of the image.","type":"boolean"},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["prompt","contentImagePath"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/style-transfer":{"post":{"operationId":"styleTransfer","summary":"Style transfer","tags":["image-ai"],"description":"Prompt- and image-guided style transfer. Use the style transfer endpoint when aiming to transform an image into the artistic style of a specific artist's collection. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"StyleTransferRequest","type":"object","properties":{"prompt":{"description":"Optional text input to condition the image synthesis. If provided, it should be brief, otherwise the prompt can overwrite the influence of the desired style specified in `artistPreset`.","type":"string"},"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"negativePrompt":{"description":"A list of negative attributes or undesired features that describes what the desired image should **not** look like.","type":"string"},"applyWatermark":{"description":"Flag whether to apply a watermark to the images or not. The watermark can be either the Sureel watermark or a custom watermark provided through the `customWatermark` parameter.","type":"boolean"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"stylePreset":{"description":"Preset styles for image generation that describe the desired style of the image, such as “painting”, “photography”, “anime” or “digital art”. It must be a comma-separated list of styles.","title":"StylePreset","type":"string"},"artistPreset":{"minItems":1,"maxItems":1,"description":"List of artist collections who should contribute to the generated data.","title":"ArtistPresetLength1","type":"array","items":{"title":"ArtistPresetObject","type":"object","properties":{"collectionUuid":{"description":"A collection can be any kind of release, such as an album, a single, EP, compilation, or any other mix of audio files or image files. Each collection has a `collectionUuid`. Every artist/label can create multiple collections of artworks. New collections can be created with the `/artist/upload-artwork` endpoint and existing collections can be obtained with the `/artist/collections` endpoint.","type":"string"},"presetAttribution":{"minimum":0,"maximum":1,"description":"Percentage of how much the artist collection should contribute to the generated data.","type":"number"}},"required":["collectionUuid"]}},"upscale":{"description":"Factor by which the generated images should be upscaled. If undefined, no upscaling will be applied.","title":"Upscale","anyOf":[{"type":"number","enum":[2]},{"type":"number","enum":[4]}]},"inferenceSteps":{"minimum":10,"maximum":100,"description":"Number of diffusion steps that iteratively improve the images generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the image closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"strength":{"description":"The `strength` influences the generation's creativity. Higher values lead to a larger divergence from the content image. If given as an array, it has to have the same length as the batch size.","title":"Strength","anyOf":[{"minimum":0,"maximum":1,"type":"number"},{"minItems":1,"maxItems":12,"title":"StrengthArray","type":"array","items":{"minimum":0,"maximum":1,"type":"number"}}]},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"batchSize":{"minimum":1,"maximum":12,"description":"Number of images that are generated in a single request.","type":"integer"},"removeBg":{"description":"Flag whether to remove the semantic background of the image.","type":"boolean"},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentImagePath","artistPreset"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/control-net":{"post":{"operationId":"controlNet","summary":"ControlNet","tags":["image-ai"],"description":"Prompt-guided image-to-image synthesis conditioned by a canny edge ControlNet. ControlNet preserves the semantic structure of a given content image, making it useful for applications such as style transfer. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ControlNetRequest","type":"object","properties":{"prompt":{"description":"Text input to condition the image synthesis. More details improve the resulting image quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"controlNet":{"title":"ControlNet","type":"object","properties":{"conditioningScale":{"description":"Scale factor for ControlNet conditioning. It influences the extent to which the structure of the input image is preserved during the process. If given as an array, it has to have the same length as the batch size.","title":"ConditioningScale","anyOf":[{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"},{"minItems":1,"maxItems":12,"title":"ConditioningScaleArray","type":"array","items":{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"}}]},"guidanceStart":{"minimum":0,"maximum":1,"description":"Percentage of inference steps at which to begin conditioning the inference with the ControlNet.","title":"GuidanceStart","type":"number"},"guidanceEnd":{"minimum":0,"maximum":1,"description":"Percentage of inference steps at which to stop conditioning the inference with the ControlNet.","title":"GuidanceEnd","type":"number"}}},"negativePrompt":{"description":"A list of negative attributes or undesired features that describes what the desired image should **not** look like.","type":"string"},"applyWatermark":{"description":"Flag whether to apply a watermark to the images or not. The watermark can be either the Sureel watermark or a custom watermark provided through the `customWatermark` parameter.","type":"boolean"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"stylePreset":{"description":"Preset styles for image generation that describe the desired style of the image, such as “painting”, “photography”, “anime” or “digital art”. It must be a comma-separated list of styles.","title":"StylePreset","type":"string"},"artistPreset":{"maxItems":1,"description":"List of artist collections who should contribute to the generated data.","title":"ArtistPresetLengthMax1","type":"array","items":{"title":"ArtistPresetObject","type":"object","properties":{"collectionUuid":{"description":"A collection can be any kind of release, such as an album, a single, EP, compilation, or any other mix of audio files or image files. Each collection has a `collectionUuid`. Every artist/label can create multiple collections of artworks. New collections can be created with the `/artist/upload-artwork` endpoint and existing collections can be obtained with the `/artist/collections` endpoint.","type":"string"},"presetAttribution":{"minimum":0,"maximum":1,"description":"Percentage of how much the artist collection should contribute to the generated data.","type":"number"}},"required":["collectionUuid"]}},"inferenceSteps":{"minimum":10,"maximum":100,"description":"Number of diffusion steps that iteratively improve the images generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the image closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"batchSize":{"minimum":1,"maximum":12,"description":"Number of images that are generated in a single request.","type":"integer"},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["prompt","contentImagePath"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/face-swap":{"post":{"operationId":"faceSwap","summary":"Face swap","tags":["image-ai"],"description":"Prompt-guided face swap. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ControlNetRequest","type":"object","properties":{"prompt":{"description":"Text input to condition the image synthesis. More details improve the resulting image quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"controlNet":{"title":"ControlNet","type":"object","properties":{"conditioningScale":{"description":"Scale factor for ControlNet conditioning. It influences the extent to which the structure of the input image is preserved during the process. If given as an array, it has to have the same length as the batch size.","title":"ConditioningScale","anyOf":[{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"},{"minItems":1,"maxItems":12,"title":"ConditioningScaleArray","type":"array","items":{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"}}]},"guidanceStart":{"minimum":0,"maximum":1,"description":"Percentage of inference steps at which to begin conditioning the inference with the ControlNet.","title":"GuidanceStart","type":"number"},"guidanceEnd":{"minimum":0,"maximum":1,"description":"Percentage of inference steps at which to stop conditioning the inference with the ControlNet.","title":"GuidanceEnd","type":"number"}}},"negativePrompt":{"description":"A list of negative attributes or undesired features that describes what the desired image should **not** look like.","type":"string"},"applyWatermark":{"description":"Flag whether to apply a watermark to the images or not. The watermark can be either the Sureel watermark or a custom watermark provided through the `customWatermark` parameter.","type":"boolean"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"stylePreset":{"description":"Preset styles for image generation that describe the desired style of the image, such as “painting”, “photography”, “anime” or “digital art”. It must be a comma-separated list of styles.","title":"StylePreset","type":"string"},"artistPreset":{"maxItems":1,"description":"List of artist collections who should contribute to the generated data.","title":"ArtistPresetLengthMax1","type":"array","items":{"title":"ArtistPresetObject","type":"object","properties":{"collectionUuid":{"description":"A collection can be any kind of release, such as an album, a single, EP, compilation, or any other mix of audio files or image files. Each collection has a `collectionUuid`. Every artist/label can create multiple collections of artworks. New collections can be created with the `/artist/upload-artwork` endpoint and existing collections can be obtained with the `/artist/collections` endpoint.","type":"string"},"presetAttribution":{"minimum":0,"maximum":1,"description":"Percentage of how much the artist collection should contribute to the generated data.","type":"number"}},"required":["collectionUuid"]}},"inferenceSteps":{"minimum":10,"maximum":100,"description":"Number of diffusion steps that iteratively improve the images generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the image closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"batchSize":{"minimum":1,"maximum":12,"description":"Number of images that are generated in a single request.","type":"integer"},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["prompt","contentImagePath"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/avatar-image-blending":{"post":{"operationId":"avatarImageBlending","summary":"Avatar image blending","tags":["image-ai"],"description":"Prompt- and style-image-guided image-to-image synthesis conditioned by a ControlNet specialized on preserving faces. The image is conditioned by the prompt, by the style image, and by the facial structure of the content image. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"AvatarImageBlendingRequest","type":"object","properties":{"prompt":{"description":"Text input to condition the image synthesis. More details improve the resulting image quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"styleImages":{"minItems":1,"maxItems":1,"title":"StyleImageArray","type":"array","items":{"title":"StyleImage","type":"object","properties":{"styleImagePath":{"description":"The `styleImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","type":"string"},"styleImageWeight":{"description":"The `styleImageWeight` sets the influence of the style image on the image generation. If given as an array, it has to have the same length as the batch size.","title":"StyleImageWeight","anyOf":[{"minimum":0,"maximum":1,"default":0.5,"title":"StyleImageWeight","type":"number"},{"minItems":1,"maxItems":12,"title":"StyleImageWeightArray","type":"array","items":{"minimum":0,"maximum":1,"default":0.5,"title":"StyleImageWeight","type":"number"}}]}},"required":["styleImagePath"]}},"controlNet":{"title":"ControlNet","type":"object","properties":{"conditioningScale":{"description":"Scale factor for ControlNet conditioning. It influences the extent to which the structure of the input image is preserved during the process. If given as an array, it has to have the same length as the batch size.","title":"ConditioningScale","anyOf":[{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"},{"minItems":1,"maxItems":12,"title":"ConditioningScaleArray","type":"array","items":{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"}}]},"guidanceStart":{"minimum":0,"maximum":1,"description":"Percentage of inference steps at which to begin conditioning the inference with the ControlNet.","title":"GuidanceStart","type":"number"},"guidanceEnd":{"minimum":0,"maximum":1,"description":"Percentage of inference steps at which to stop conditioning the inference with the ControlNet.","title":"GuidanceEnd","type":"number"}}},"negativePrompt":{"description":"A list of negative attributes or undesired features that describes what the desired image should **not** look like.","type":"string"},"applyWatermark":{"description":"Flag whether to apply a watermark to the images or not. The watermark can be either the Sureel watermark or a custom watermark provided through the `customWatermark` parameter.","type":"boolean"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"stylePreset":{"description":"Preset styles for image generation that describe the desired style of the image, such as “painting”, “photography”, “anime” or “digital art”. It must be a comma-separated list of styles.","title":"StylePreset","type":"string"},"inferenceSteps":{"minimum":10,"maximum":100,"description":"Number of diffusion steps that iteratively improve the images generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the image closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"generateProvenance":{"description":"Flag whether to enable the provenance calculation. Style image required. Provenance describes the entire influence history of a piece of content generated using AI. It can be seen as the content's attribution over time. Whenever any data is used to generate new content using AI, the provenance of that new content is extended to include the influence of that data. In summary, the provenance of a piece of content is obtained by computing the full attribution to all training and input data each time AI is used to generate or alter that piece of content.","type":"boolean"},"batchSize":{"minimum":1,"maximum":12,"description":"Number of images that are generated in a single request.","type":"integer"},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentImagePath","styleImages"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/image-blending":{"post":{"operationId":"imageBlending","summary":"Image blending","tags":["image-ai"],"description":"Blend two images into a combination of both. The content image influnces the content more and the style image influences the style more. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ImageBlendingRequest","type":"object","properties":{"prompt":{"description":"Text input to condition the image synthesis. More details improve the resulting image quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"contentImageWeight":{"description":"The `contentImageWeight` sets the influence of the content image on the image generation. If given as an array, it has to have the same length as the batch size.","title":"ContentImageWeight","anyOf":[{"minimum":0,"maximum":1,"type":"number"},{"minItems":1,"maxItems":12,"title":"StrengthArray","type":"array","items":{"minimum":0,"maximum":1,"type":"number"}}]},"styleImages":{"minItems":1,"maxItems":1,"title":"StyleImageArray","type":"array","items":{"title":"StyleImage","type":"object","properties":{"styleImagePath":{"description":"The `styleImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","type":"string"},"styleImageWeight":{"description":"The `styleImageWeight` sets the influence of the style image on the image generation. If given as an array, it has to have the same length as the batch size.","title":"StyleImageWeight","anyOf":[{"minimum":0,"maximum":1,"default":0.5,"title":"StyleImageWeight","type":"number"},{"minItems":1,"maxItems":12,"title":"StyleImageWeightArray","type":"array","items":{"minimum":0,"maximum":1,"default":0.5,"title":"StyleImageWeight","type":"number"}}]}},"required":["styleImagePath"]}},"negativePrompt":{"description":"A list of negative attributes or undesired features that describes what the desired image should **not** look like.","type":"string"},"applyWatermark":{"description":"Flag whether to apply a watermark to the images or not. The watermark can be either the Sureel watermark or a custom watermark provided through the `customWatermark` parameter.","type":"boolean"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"stylePreset":{"description":"Preset styles for image generation that describe the desired style of the image, such as “painting”, “photography”, “anime” or “digital art”. It must be a comma-separated list of styles.","title":"StylePreset","type":"string"},"upscale":{"description":"Factor by which the generated images should be upscaled. If undefined, no upscaling will be applied.","title":"Upscale","anyOf":[{"type":"number","enum":[2]},{"type":"number","enum":[4]}]},"inferenceSteps":{"minimum":10,"maximum":100,"description":"Number of diffusion steps that iteratively improve the images generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the image closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"generateProvenance":{"description":"Flag whether to enable the provenance calculation. Style image required. Provenance describes the entire influence history of a piece of content generated using AI. It can be seen as the content's attribution over time. Whenever any data is used to generate new content using AI, the provenance of that new content is extended to include the influence of that data. In summary, the provenance of a piece of content is obtained by computing the full attribution to all training and input data each time AI is used to generate or alter that piece of content.","type":"boolean"},"batchSize":{"minimum":1,"maximum":12,"description":"Number of images that are generated in a single request.","type":"integer"},"removeBg":{"description":"Flag whether to remove the semantic background of the image.","type":"boolean"},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentImagePath","styleImages"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/cover-art":{"post":{"operationId":"createCoverArt","summary":"Music cover art","tags":["image-ai"],"description":"Create cover art for your music album or single. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"CoverArtRequest","type":"object","properties":{"frame":{"description":"Optionally select a frame for the cover art.","title":"CoverArtFrame","anyOf":[{"type":"string","enum":["marble.png"]},{"type":"string","enum":["white.png"]}]},"textFirstLine":{"description":"The text that will appear in the first line on the cover art, e.g. artist name.","type":"string"},"textSecondLine":{"description":"The text that will appear in the second line on the cover art, e.g. album name.","type":"string"},"fontFirstLine":{"description":"The font type for the text in the first line on the cover art.","title":"CoverArtFontFirstLine","anyOf":[{"type":"string","enum":["anton.ttf"]},{"type":"string","enum":["nunito.ttf"]},{"type":"string","enum":["ariana_violeta.ttf"]},{"type":"string","enum":["to_the_point_regular.ttf"]}]},"fontSecondLine":{"description":"The font type for the text in the second line on the cover art.","title":"CoverArtFontSecondLine","anyOf":[{"type":"string","enum":["anton.ttf"]},{"type":"string","enum":["nunito.ttf"]},{"type":"string","enum":["ariana_violeta.ttf"]},{"type":"string","enum":["to_the_point_regular.ttf"]}]},"fontColorFirstLine":{"description":"The font color in RGB of the text in the first line.","minItems":3,"maxItems":3,"title":"FontColorFirstLine","type":"array","items":{"minimum":0,"maximum":256,"type":"integer"}},"fontColorSecondLine":{"description":"The font color in RGB of the text in the second line.","minItems":3,"maxItems":3,"title":"FontColorSecondLine","type":"array","items":{"minimum":0,"maximum":256,"type":"integer"}},"coverContent":{"description":"The content of the cover art.","type":"string"},"coverStyle":{"description":"The style of the cover art.","type":"string"},"coverColorScheme":{"description":"The color scheme of the cover art.","type":"string"},"albumGenre":{"description":"The album genre.","type":"string"},"albumSeasonality":{"description":"The album seasonality.","type":"string"},"referenceCoverArt":{"minItems":1,"maxItems":10,"title":"ReferenceCoverArtArray","type":"array","items":{"title":"StyleImage","type":"object","properties":{"styleImagePath":{"description":"The `styleImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","type":"string"},"styleImageWeight":{"description":"The `styleImageWeight` sets the influence of the style image on the image generation. If given as an array, it has to have the same length as the batch size.","title":"StyleImageWeight","anyOf":[{"minimum":0,"maximum":1,"default":0.5,"title":"StyleImageWeight","type":"number"},{"minItems":1,"maxItems":12,"title":"StyleImageWeightArray","type":"array","items":{"minimum":0,"maximum":1,"default":0.5,"title":"StyleImageWeight","type":"number"}}]}},"required":["styleImagePath"]}},"songTitles":{"description":"If you want to create a cover art for multiple songs, you can provide the song titles here.","type":"string"},"songPath":{"description":"If you want to create a cover art for a single song, you can provide this song here. The `songPath` can either be an audio URL or the audio path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include .MP3, .WAV, .M4A, and .FLAC.","type":"string"},"lyrics":{"description":"If you want to create a cover art for a single song, you can provide the lyrics of this song here.","type":"string"},"descriptionWeight":{"description":"The `descriptionWeight` sets the influence of the following parameters on the image generation: coverContent, coverStyle, coverColorScheme, albumGenre, and albumSeasonality. If given as an array, it has to have the same length as the batch size.","title":"DescriptionWeight","anyOf":[{"minimum":0,"maximum":1,"type":"number"},{"minItems":1,"maxItems":12,"title":"StrengthArray","type":"array","items":{"minimum":0,"maximum":1,"type":"number"}}]},"negativePrompt":{"description":"A list of negative attributes or undesired features that describes what the desired image should **not** look like.","type":"string"},"applyWatermark":{"description":"Flag whether to apply a watermark to the images or not. The watermark can be either the Sureel watermark or a custom watermark provided through the `customWatermark` parameter.","type":"boolean"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"upscale":{"description":"Factor by which the generated images should be upscaled. If undefined, no upscaling will be applied.","title":"Upscale","anyOf":[{"type":"number","enum":[2]},{"type":"number","enum":[4]}]},"inferenceSteps":{"minimum":10,"maximum":100,"description":"Number of diffusion steps that iteratively improve the images generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the image closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"batchSize":{"minimum":1,"maximum":12,"description":"Number of images that are generated in a single request.","type":"integer"},"removeBg":{"description":"Flag whether to remove the semantic background of the image.","type":"boolean"},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["coverContent","coverStyle","referenceCoverArt"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/inpaint":{"post":{"operationId":"inpaint","summary":"Inpaint image","tags":["image-ai"],"description":"Prompt- and mask-guided image-to-image synthesis. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"InpaintRequest","type":"object","properties":{"prompt":{"description":"Text input to condition the image synthesis. More details improve the resulting image quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"maskImagePath":{"description":"The `maskImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","type":"string"},"creativeInpainting":{"default":true,"description":"Flag whether to allow creative inpainting, where the masked part can also be slightly changed.","type":"boolean"},"negativePrompt":{"description":"A list of negative attributes or undesired features that describes what the desired image should **not** look like.","type":"string"},"applyWatermark":{"description":"Flag whether to apply a watermark to the images or not. The watermark can be either the Sureel watermark or a custom watermark provided through the `customWatermark` parameter.","type":"boolean"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"stylePreset":{"description":"Preset styles for image generation that describe the desired style of the image, such as “painting”, “photography”, “anime” or “digital art”. It must be a comma-separated list of styles.","title":"StylePreset","type":"string"},"artistPreset":{"maxItems":1,"description":"List of artist collections who should contribute to the generated data.","title":"ArtistPresetLengthMax1","type":"array","items":{"title":"ArtistPresetObject","type":"object","properties":{"collectionUuid":{"description":"A collection can be any kind of release, such as an album, a single, EP, compilation, or any other mix of audio files or image files. Each collection has a `collectionUuid`. Every artist/label can create multiple collections of artworks. New collections can be created with the `/artist/upload-artwork` endpoint and existing collections can be obtained with the `/artist/collections` endpoint.","type":"string"},"presetAttribution":{"minimum":0,"maximum":1,"description":"Percentage of how much the artist collection should contribute to the generated data.","type":"number"}},"required":["collectionUuid"]}},"upscale":{"description":"Factor by which the generated images should be upscaled. If undefined, no upscaling will be applied.","title":"Upscale","anyOf":[{"type":"number","enum":[2]},{"type":"number","enum":[4]}]},"inferenceSteps":{"minimum":10,"maximum":100,"description":"Number of diffusion steps that iteratively improve the images generated by the model.","type":"integer"},"cfg":{"minimum":0,"maximum":15,"description":"Classifier-free guidance: This scale determines how strictly the diffusion process adheres to the prompt. Higher values keep the image closer to the prompt.","type":"number"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the generation process and enable reproducibility. If not specified, the generation process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"strength":{"description":"The `strength` influences the generation's creativity. Higher values lead to a larger divergence from the content image. If given as an array, it has to have the same length as the batch size.","title":"Strength","anyOf":[{"minimum":0,"maximum":1,"type":"number"},{"minItems":1,"maxItems":12,"title":"StrengthArray","type":"array","items":{"minimum":0,"maximum":1,"type":"number"}}]},"generateAttribution":{"description":"Flag whether to enable the attribution calculation. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","type":"boolean"},"batchSize":{"minimum":1,"maximum":12,"description":"Number of images that are generated in a single request.","type":"integer"},"removeBg":{"description":"Flag whether to remove the semantic background of the image.","type":"boolean"},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["prompt","contentImagePath","maskImagePath"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/calculate-image-attribution":{"post":{"operationId":"calculateAttribution","summary":"Attribution calculation","tags":["image-ai"],"description":"Calculate the attribution of a given image. Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"CalculateAttributionRequest","type":"object","properties":{"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"prompt":{"description":"Text input to condition the image synthesis. More details improve the resulting image quality, although repeating concepts and overly long prompts should be avoided.","type":"string"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentImagePath","prompt"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/attribution-analysis":{"post":{"operationId":"imageAttributionAnalysis","summary":"Attribution analysis","tags":["image-ai"],"description":"Image attribution analysis extracts the analysis metrics for a given image. Metrics are as follows: Attribution likelihood describes the probability that a piece of content from the registry had an influence on the creation of a new piece of content. Cross-correlation describes how similar the images are, independent of spatial shifts. Color match describes how similar the color distributions of RGB are. And pixel-wise average difference gives the average distance in between images.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ImageAttributionAnalysisRequest","type":"object","properties":{"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"topNMatches":{"minimum":1,"maximum":100,"default":6,"description":"`topNMatches` refers to the number of highest-ranking N images that are most similar to the input image provided for comparison.","type":"integer"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentImagePath","topNMatches"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/upscale":{"post":{"operationId":"upscaleImage","summary":"Upscaling","tags":["image-ai"],"description":"Upscale a given image. The maximum allowed resolution for the content image is 1024x1024. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"UpscaleRequest","type":"object","properties":{"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"upscale":{"description":"Factor by which the generated images should be upscaled. If undefined, no upscaling will be applied.","title":"Upscale","anyOf":[{"type":"number","enum":[2]},{"type":"number","enum":[4]}]},"applyWatermark":{"description":"Flag whether to apply a watermark to the images or not. The watermark can be either the Sureel watermark or a custom watermark provided through the `customWatermark` parameter.","type":"boolean"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"removeBg":{"description":"Flag whether to remove the semantic background of the image.","type":"boolean"},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentImagePath","upscale"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/remove-background":{"post":{"operationId":"removeBackground","summary":"Background removal","tags":["image-ai"],"description":"Remove the background of a given image. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"RemoveBackgroundRequest","type":"object","properties":{"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"upscale":{"description":"Factor by which the generated images should be upscaled. If undefined, no upscaling will be applied.","title":"Upscale","anyOf":[{"type":"number","enum":[2]},{"type":"number","enum":[4]}]},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentImagePath"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/generate-preview":{"post":{"operationId":"generatePreview","summary":"Preview generation","tags":["image-ai"],"description":"Generate a low-res preview image of a given image. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"GeneratePreviewRequest","type":"object","properties":{"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"applyWatermark":{"description":"Flag whether to apply a watermark to the images or not. The watermark can be either the Sureel watermark or a custom watermark provided through the `customWatermark` parameter.","type":"boolean"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"removeBg":{"description":"Flag whether to remove the semantic background of the image.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentImagePath"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/apply-watermark":{"post":{"operationId":"applyWatermark","summary":"Watermarking","tags":["image-ai"],"description":"Add a watermark to a given image. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ApplyWatermarkRequest","type":"object","properties":{"contentImagePath":{"description":"The `contentImagePath` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include JPG and PNG.","title":"ContentImagePath","type":"string"},"customWatermark":{"description":"Define a custom watermark image to be applied to the images. It should be square and must have an alpha channel. The watermark should be oriented towards the lower left corner of the watermark image. The `customWatermark` can either be an image URL or the image path returned from the `/files/upload-files` or `/files/generate-upload-urls` endpoint. Supported formats include PNG.","type":"string"},"upscale":{"description":"Factor by which the generated images should be upscaled. If undefined, no upscaling will be applied.","title":"Upscale","anyOf":[{"type":"number","enum":[2]},{"type":"number","enum":[4]}]},"removeBg":{"description":"Flag whether to remove the semantic background of the image.","type":"boolean"},"generatePreview":{"description":"Flag whether to generate 256px and 512px preview images for lower resolution previews in a front-end.","type":"boolean"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["contentImagePath"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/image-fine-tuning":{"post":{"operationId":"finetuneModel","summary":"Fine-tuning","tags":["image-ai"],"description":"Fine-tunes the image synthesis model with user-provided images. Begin by uploading your images through the `/artist/upload-artwork` endpoint or retrieve the `collectionUuid` from the `/artist/collections` endpoint. By default, each user has a limit of 100 requests per minute.","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"title":"FinetuningRequest","type":"object","properties":{"collectionUuid":{"description":"A collection can be any kind of release, such as an album, a single, EP, compilation, or any other mix of audio files or image files. Each collection has a `collectionUuid`. Every artist/label can create multiple collections of artworks. New collections can be created with the `/artist/upload-artwork` endpoint and existing collections can be obtained with the `/artist/collections` endpoint. For the fine-tuning, the `collectionUuid` is used to condition the image captions and to associate with the training images.","type":"string"},"numTrainSteps":{"minimum":40,"maximum":1300,"description":"Number of backwards passes to perform in total for LDM fine-tuning. We recommend to set the `numTrainSteps` parameter to 60 times the number of images in the collection with a lower limit of 300 and an upper limit of 1000.","type":"integer"},"trainTextEncoder":{"default":true,"description":"Whether to also train the text encoder for stronger integration of the new visual concepts.","type":"boolean"},"learningRate":{"minimum":0.000001,"maximum":0.1,"default":0.00005,"description":"How strongly the model should change per step.","type":"number"},"capacity":{"minimum":1,"maximum":20,"description":"How much capacity the model will have for learning new features. Impacts the extent of modifications applied to a model's parameters. The higher the capacity, the higher the training steps should be.","type":"integer"},"seed":{"minimum":-2147483648,"maximum":2147483647,"description":"Seed to control randomness in the fine-tuning process and enable reproducibility. If not specified, the fine-tuning process is random. If the seed is fixed to the same number, the generation will always yield the same result.","type":"integer"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["collectionUuid","numTrainSteps"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/ldm/image-attribution-setup":{"post":{"operationId":"attributionSetup","summary":"Attribution setup","tags":["image-ai"],"description":"Prepares the attribution environment and embeddings from specified prefix.","requestBody":{"content":{"application/json":{"schema":{"title":"AttributionSetupRequest","type":"object","properties":{"collectionUuid":{"description":"A collection can be any kind of release, such as an album, a single, EP, compilation, or any other mix of audio files or image files. Each collection has a `collectionUuid`. Every artist/label can create multiple collections of artworks. New collections can be created with the `/artist/upload-artwork` endpoint and existing collections can be obtained with the `/artist/collections` endpoint. For the fine-tuning, the `collectionUuid` is used to condition the image captions and to associate with the training images.","type":"string"},"webhookUrl":{"description":"Webhook URL where you receive notifications regarding completed requests.","type":"string"},"webhookKey":{"description":"The optional webhook key is a private token that verifies the authenticity of any request sent to the webhook URL.","type":"string"}},"required":["collectionUuid"]}}},"required":true},"parameters":[{"schema":{"type":"string","enum":["application/json"]},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","properties":{"requestId":{"type":"string"}},"required":["requestId"]}}}}}}},"/v1/ai/prompt-history/":{"get":{"operationId":"getPromptHistory","summary":"Prompt history","tags":["prompt-history"],"description":"Retrieve the history of previous synthesis requests (like text-to-audio) by using cursor-based pagination.","parameters":[{"schema":{"type":"number"},"in":"query","name":"take","required":true,"description":"The `take` parameter is the number of prompts to return per page."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"The optional `cursor` parameter is the `lastEvaluatedKey` in the previous page."},{"schema":{"type":"number"},"in":"query","name":"maxTimestamp","required":false,"description":"The optional `maxTimestamp` parameter, expressed in milliseconds, can be used to filter transactions up to a certain timestamp."},{"schema":{"title":"SynthesisRequestType","anyOf":[{"type":"string","enum":["/text-to-audio"]},{"type":"string","enum":["/text-to-speech"]},{"type":"string","enum":["/audio-to-audio"]},{"type":"string","enum":["/voice-transfer"]},{"type":"string","enum":["/text-to-artist-audio"]},{"type":"string","enum":["/queue"]},{"type":"string","enum":["/cover-art"]},{"type":"string","enum":["/reimagine"]},{"type":"string","enum":["/style-transfer"]},{"type":"string","enum":["/control-net"]},{"type":"string","enum":["/face-swap"]},{"type":"string","enum":["/avatar-image-blending"]},{"type":"string","enum":["/image-blending"]},{"type":"string","enum":["/inpaint"]},{"type":"string","enum":["/upscale"]},{"type":"string","enum":["/refine-image"]},{"type":"string","enum":["/remove-background"]},{"type":"string","enum":["/generate-preview"]},{"type":"string","enum":["/apply-watermark"]}]},"in":"query","name":"requestType","required":false,"description":"Specifies the type of the request to retrieve. Possible values: `/text-to-audio`, `/text-to-speech`, `/audio-to-audio`, `/voice-transfer`, `/text-to-artist-audio`, `/queue`, `/cover-art`, `/reimagine`, `/style-transfer`, `/control-net`, `/face-swap`, `/avatar-image-blending`, `/image-blending`, `/inpaint`, `/upscale`, `/refine-image`, `/remove-background`, `/generate-preview`, `/apply-watermark`."},{"schema":{"default":5,"minimum":-1,"type":"integer"},"in":"query","name":"topNAttributionResults","required":false,"description":"Specifies the number of top attribution results to be returned. A value of -1 indicates that all attribution results should be returned."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetPromptHistoryResponse","type":"object","properties":{"promptHistory":{"title":"PromptHistory","type":"array","items":{"title":"PromptHistoryEntry","type":"object","properties":{"status":{"anyOf":[{"title":"UserRequestStatus","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]}]},{"title":"UserRequestStatus","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]}]}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"string"}]},"endpoint":{"anyOf":[{"type":"string"},{"type":"string"}]},"requestId":{"anyOf":[{"type":"string"},{"type":"string"}]},"request_body":{"anyOf":[{},{}]},"createdAt":{"anyOf":[{"type":"number"},{"type":"number"}]},"imagesSignedUrls":{"title":"ImagesSignedUrls","type":"array","items":{"type":"string"}},"previewImagesSignedUrls":{"title":"PreviewImagesSignedUrls","type":"array","items":{"type":"string"}},"attribution":{"anyOf":[{"title":"Attribution","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","anyOf":[{"type":"null"},{"title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}]},{"title":"Attribution","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content.","anyOf":[{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}},{"type":"null"}]}]},"provenance":{"anyOf":[{"title":"Provenance","anyOf":[{"type":"null"},{"title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}]},{"title":"Provenance","anyOf":[{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}},{"type":"null"}]}]},"contentImage":{"type":"string"},"styleImage":{"type":"string"},"maskImage":{"type":"string"},"artistProfilePictures":{"anyOf":[{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"}},"required":["artistName","picture"]}}]},{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"}},"required":["artistName","picture"]}}]}]},"seed":{"anyOf":[{"type":"number"},{"type":"number"}]},"requestData":{"anyOf":[{"title":"GetLdmRequestData","type":"object","properties":{"user_id":{"type":"string"},"request_id":{"type":"string"},"apply_watermark":{"type":"boolean"},"custom_watermark":{"title":"CustomWatermark","anyOf":[{"type":"null"},{"type":"string"}]},"artist_preset":{"title":"ArtistPresets","type":"array","items":{"title":"ArtistPresetsInner","type":"object","properties":{"collection_uuid":{"type":"string"},"preset_attribution":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"artist":{"type":"string"}}}},"batch_size":{"type":"number"},"negative_prompt":{"type":"string"},"remove_bg":{"type":"boolean"},"resolution":{"type":"string"},"seed":{"title":"Seed","anyOf":[{"type":"number"},{"type":"null"}]},"style_preset":{"title":"StylePreset","anyOf":[{"type":"null"},{"type":"string"}]},"upscale":{"title":"Upscale","anyOf":[{"type":"null"},{"type":"number"}]},"controlnet":{"title":"ControlNetData","type":"object","properties":{"conditioning_scale":{"title":"ConditioningScale","anyOf":[{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"},{"title":"ConditioningScaleArray","type":"array","items":{"minimum":0,"maximum":1,"title":"ConditioningScaleValue","type":"number"}},{"type":"null"}]},"guidance_start":{"type":"number"},"guidance_end":{"type":"number"}}},"artist_uuid":{"type":"string"},"train_text_encoder":{"type":"boolean"},"num_train_steps":{"type":"integer"},"learning_rate":{"type":"number"},"creative_inpainting":{"type":"boolean"},"text_prompt":{"title":"TextPrompt","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["user_id","request_id"]},{"title":"AudioLdmRequestData","type":"object","properties":{"user_id":{"type":"string"},"request_id":{"type":"string"},"batch_size":{"type":"number"},"seed":{"title":"Seed","anyOf":[{"type":"number"},{"type":"null"}]},"num_train_steps":{"type":"integer"},"text_prompt":{"title":"TextPrompt","anyOf":[{"type":"string"},{"type":"null"}]},"artist_preset":{"title":"ArtistPresetInRequestData","type":"array","items":{"title":"ArtistPresetInRequestData","type":"object","properties":{"collection_uuid":{"type":"string"},"preset_attribution":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"artist":{"type":"string"}}}}},"required":["user_id","request_id"]}]},"imageAttributionAnalysis":{"title":"ImageAttributionAnalysis","description":"Image attribution analysis extracts the analysis metrics for a given image. Metrics are as follows: Attribution likelihood describes the probability that a piece of content from the registry had an influence on the creation of a new piece of content. Cross-correlation describes how similar the images are, independent of spatial shifts. Color match describes how similar the color distributions of RGB are. And pixel-wise average difference gives the average distance in between images.","type":"object","properties":{"similarFiles":{"title":"SimilarImageFilesWithMetrics","type":"array","items":{"title":"SimilarImageFile","type":"object","properties":{"attribution_likelihood":{"type":"number"},"cross_correlation":{"type":"number"},"color_matching":{"title":"ColorMatching","type":"object","properties":{"g_channel":{"type":"number"},"r_channel":{"type":"number"},"b_channel":{"type":"number"}},"required":["g_channel","r_channel","b_channel"]},"color_matching_combined":{"type":"number"},"pixelwise_similarity":{"type":"number"},"filename":{"type":"string"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}},"required":["attribution_likelihood","color_matching","pixelwise_similarity"]}},"topMetrics":{"title":"TopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"cross_correlation":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"color_matching":{"title":"TopColorMatching","type":"object","properties":{"g_channel":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"r_channel":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"b_channel":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["g_channel","r_channel","b_channel"]},"color_matching_combined":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"pixelwise_similarity":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"IdenticalMatchSignedUrls","type":"array","items":{"title":"IdenticalMatchSignedUrlsInner","anyOf":[{"type":"string"},{"type":"null"}]}},"signed_urls_thumbnails":{"title":"IdenticalMatchSignedUrlsThumbnails","type":"array","items":{"title":"IdenticalMatchSignedUrlsThumbnailsInner","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls","signed_urls_thumbnails"]}},"required":["attribution_likelihood","cross_correlation","color_matching","color_matching_combined","pixelwise_similarity","identical_matches"]}},"required":["similarFiles","topMetrics"]},"originalFilename":{"anyOf":[{"type":"string"},{"type":"string"}]},"audiosSignedUrls":{"title":"AudiosSignedUrls","type":"array","items":{"type":"string"}},"stemSplittedAudiosSignedUrls":{"title":"StemSplittedAudiosSignedUrls","type":"array","items":{"type":"string"}},"contentAudio":{"type":"string"},"attributionPerCollection":{"title":"AttributionWithStems","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content. The attribution is returned for the master audio as well as for each individual stem. Additionally, attribution is calculated for multiple segments of the entire song. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"attributionPerTrack":{"title":"AttributionWithStems","description":"Attribution describes the influence of training data on content generated using AI. When training an AI model with different collections of data, each collection has a certain amount of influence on the resulting model. When generating new content with the resulting model, the influence each collection has on the new content is referred to as the attribution of the new content. The attribution is returned for the master audio as well as for each individual stem. Additionally, attribution is calculated for multiple segments of the entire song. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["artist"]}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"audioAttributionAnalysis":{"title":"SimilarAudioFilesPerStem","description":"Audio attribution analysis extracts the analysis metrics for a given audio file. Metrics are as follows: Attribution likelihood describes the probability that a piece of content from the registry had an influence on the creation of a new piece of content. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"instrumentals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"vocals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"bass":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}},"drums":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"SimilarAudioFilesPerDurationInnerValues","type":"array","items":{"title":"SimilarAudioFilesPerDurationInnerValuesInner","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","properties":{"attribution_likelihood":{"title":"AttributionLikelihood","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"ConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"MaxAttribution","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AverageAttribution","type":"array","items":{"type":"number"}},"track":{"type":"string"},"filename":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"]}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"identical_matches":{"title":"IdenticalMatches","type":"object","properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}},"required":["value","signed_urls"]},"max_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]},"average_attribution":{"title":"TopMetric","type":"object","properties":{"value":{"type":"number"},"signed_url":{"type":"string"},"signed_url_thumbnail":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["value","signed_url"]}},"required":["attribution_likelihood","max_attribution","average_attribution"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}}},"required":["master","instrumentals","vocals","bass","drums"]},"optOutAnalysis":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"musicalityAnalysis":{"title":"Musicality Analysis","description":"Detailed analysis of musicality, including metadata and scoring for various segments.","type":"object","properties":{"master":{"title":"ChunkWiseMusicalityAnalysis","type":"array","items":{"title":"ChunkWiseMusicalityAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The musical analysis values for the given responses.","title":"MusicalityArray","type":"array","items":{"title":"MusicalityInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"MusicalityValues","type":"object","properties":{"sampling_rate":{"type":"number"},"song_length":{"type":"number"},"key":{"type":"string"},"key_confidence":{"type":"number"},"tempo":{"type":"number"},"pitch":{"type":"number"},"genre_analysis":{"title":"GenreAnalysisValues","type":"array","items":{"title":"GenreAnalysisValuesInner","type":"object","properties":{"genre":{"type":"string"},"values":{"title":"GenreAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}},"required":["genre","values"]}},"mood_analysis":{"title":"MoodAnalysisValues","type":"array","items":{"title":"MoodAnalysisValuesInner","type":"object","properties":{"mood":{"type":"string"},"values":{"title":"MoodAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}},"required":["mood","values"]}}},"required":["genre_analysis","mood_analysis"]}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"aiDnaVisualization":{"title":"VisualizationS3KeysResponse","type":"array","items":{"title":"AI DNA Visualization","description":"Images for the AI DNA Visualization","type":"object","properties":{"master":{"title":"ChunkWiseVisualizationS3keysResponse","type":"array","items":{"title":"VisualizationS3keysResponseInner","type":"object","properties":{"filename":{"type":"string"},"signedUrls":{"title":"SignedUrls","type":"array","items":{"type":"string"}}},"required":["signedUrls"]}}},"required":["master"]}},"lyricsAnalysis":{"title":"LyricsAnalysis","description":"The result of the lyrics analysis.","type":"object","properties":{"filename":{"description":"The name of the file containing the uploaded lyrics.","type":"string"},"lyrics":{"description":"The input lyrics.","type":"string"},"lyrics_attribution":{"description":"The lyrics attribution values for the (translated) input lyrics.","title":"LyricsAttribution","type":"array","items":{"title":"LyricsAttributionPerChunk","type":"object","properties":{"duration":{"description":"The duration (in number of words) of the inspected segment, representing the length of each analyzed time window.","type":"number"},"period":{"description":"The period (in number of words) of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis.","type":"number"},"values":{"title":"LyricsAttribution","type":"array","items":{"title":"LyricsAttributionInner","type":"object","properties":{"score":{"description":"The degree of copyright infringement per chunk related to the lyrics.","title":"LyricsAttributionInnerScore","type":"array","items":{"type":"number"}},"mean_score":{"description":"The mean degree of copyright infringement over the whole lyrics.","type":"number"},"similar_lyrics_inspected":{"description":"The corresponding lyrics from the new song that match the original lyrics.","title":"LyricsAttributionInnerSimilarLyricsInspected","type":"array","items":{"type":"string"}},"similar_lyrics_original":{"description":"The most similar lyrics from the original song.","title":"LyricsAttributionInnerSimilarLyricsOriginal","type":"array","items":{"type":"string"}},"track_name":{"description":"The name of the song.","type":"string"},"track":{"description":"The track associated with the original lyrics.","type":"string"},"is_spotify_url":{"description":"Whether the returned track URL is a Spotify URL or not.","type":"boolean"}},"required":["score","similar_lyrics_inspected","similar_lyrics_original","track","is_spotify_url"]}}},"required":["duration","period","values"]}},"translated_lyrics":{"description":"The translated version of the lyrics, if applicable.","type":"string"}}},"aiGeneratedLikelihood":{"description":"AI detection results are provided for each stem. The master stem delivers the most reliable results, while results for individual stems are available in beta.","title":"AIDetectionResultsWithStem","type":"object","properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}}},"required":["master","instrumentals","vocals","bass","drums"]},"similarTracks":{"title":"SimilarTracks","type":"array","items":{"title":"SimilarTracksInner","type":"object","properties":{"track":{"type":"string"},"signed_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"}},"required":["track","signed_url","is_spotify_url"]}},"artist_uuid":{"type":"string"}},"required":["requestId"]}},"lastEvaluatedKey":{"title":"LastEvaluatedKey","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["promptHistory","lastEvaluatedKey"]}}}}}}},"/v1/ai/prompt-history/{requestId}":{"delete":{"operationId":"deleteRequestById","summary":"Delete LDM request","tags":["prompt-history"],"description":"Delete prompt and images by request ID.","parameters":[{"schema":{"type":"string"},"in":"path","name":"requestId","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai/record-label/{labelName}":{"get":{"operationId":"getCustomerData","summary":"Get profile data by label name","tags":["record-label"],"description":"This endpoint returns the label profile data and the artist profile data for all artists that are associated with the label.","parameters":[{"schema":{"type":"number"},"in":"query","name":"take","required":false,"description":"The `take` parameter is the number of artists to return per page."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"The optional `cursor` parameter is the `lastEvaluatedKey` in the previous page."},{"schema":{"minLength":1,"type":"string"},"in":"path","name":"labelName","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"CustomerProfileData","type":"object","properties":{"label":{"description":"The name of the record label.","type":"string"},"labelLogo":{"description":"The URL of the record label's logo.","type":"string"},"coverImage":{"description":"The URL of the cover image for the record label.","type":"string"},"artists":{"title":"Artists","type":"array","items":{"title":"ArtistProfileData","type":"object","properties":{"username":{"type":"string"},"auth0_id":{"type":"string"},"profile_picture_s3_key":{"type":"string"},"cover_image_s3_key":{"type":"string"},"picture":{"type":"string"},"cover_image":{"type":"string"},"family_name":{"type":"string"},"given_name":{"type":"string"},"email":{"type":"string"},"profile_description":{"type":"string"},"url_external_website":{"type":"string"},"updated_at":{"title":"UpdatedAt","anyOf":[{"type":"string"},{"type":"number"}]},"user_role":{"anyOf":[{"title":"UserRole","anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["ai-company"]}]},{"title":"ArtistOnlyRole","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]}]}]},"stripe_customer_id":{"type":"string"},"subscription_tier":{"title":"SubscriptionTier","anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["pro"]},{"type":"string","enum":["ultra"]}]},"customer_name":{"type":"string"},"connected_api_user":{"type":"string"},"logo":{"type":"string"},"api_terms_and_conditions":{"type":"boolean"},"created_at":{"type":"number"},"zero_balance_email_sent":{"type":"boolean"},"low_balance_email_sent":{"type":"boolean"},"balance_treshold":{"type":"number"},"sub_labels":{"title":"SubLabels","type":"array","items":{"type":"string"}},"metrics":{"title":"Metrics","type":"object","properties":{"registry":{"title":"GetRegistryOptInOutMetricsResponse","type":"object","properties":{"optOutPercentage":{"type":"number"},"optInPercentage":{"type":"number"},"optOutAmount":{"type":"number"},"optInAmount":{"type":"number"},"numberOfReleases":{"type":"number"},"numberOfAssets":{"type":"number"},"numberOfArtists":{"type":"number"},"collectionWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"collectionWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"artistsWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"artistsWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"genreWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"genreWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"rulesForOptIn":{"type":"string"}},"required":["optOutPercentage","optInPercentage","optOutAmount","optInAmount","numberOfReleases","numberOfAssets"]}},"required":["registry"]},"spotify_user_id":{"type":"string"},"spotify_display_name":{"type":"string"},"verified":{"type":"boolean"},"tutorial_completed_at":{"type":"number"},"terms_and_conditions":{"type":"boolean"},"show_in_frontend":{"type":"boolean"},"collection_uuids":{"title":"CollectionUUIDs","type":"array","items":{"type":"string"}},"collections":{"title":"ArtistCollections","type":"array","items":{"title":"ArtistCollectionRecordIntersection","type":"object","properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"status":{"title":"CollectionStatus","anyOf":[{"type":"string","enum":["Draft"]},{"type":"string","enum":["Pending"]},{"type":"string","enum":["In training"]},{"type":"string","enum":["Opted-in"]},{"type":"string","enum":["Opted-out"]},{"type":"string","enum":["Denied"]}]},"status_description":{"type":"string"},"file_ids":{"title":"FileIds","type":"array","items":{"type":"string"}},"files":{"type":"array","items":{"title":"AssetMetadataRecordForDisplay","type":"object","properties":{"file_id":{"type":"string"},"isrc":{"type":"string"},"track_title":{"type":"string"},"file_path":{"type":"string"},"duration":{"type":"number"},"spotify_url":{"type":"string"},"is_spotify_url":{"type":"boolean"},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"artist_names":{"deprecated":true,"title":"ArtistNames","type":"array","items":{"type":"string"}},"labels":{"title":"Labels","type":"array","items":{"type":"string"}}}}},"artworks_s3_keys":{"title":"ArtworksS3Keys","type":"array","items":{"type":"string"}},"artworks":{"title":"Artworks","type":"array","items":{"type":"string"}},"artworksFullRes":{"title":"ArtworksFullRes","type":"array","items":{"type":"string"}},"is_spotify_url":{"type":"boolean"},"prompt_guidance":{"type":"string"},"show_in_frontend":{"type":"boolean"},"styles":{"title":"Styles","type":"array","items":{"type":"string"}},"use_for_finetuning":{"type":"boolean"},"use_for_training":{"type":"boolean"},"no_audio_files_available":{"type":"boolean"},"knowledge_acquisition_ratio":{"type":"number"},"ai_influence":{"type":"string"},"external_id":{"type":"string"},"external_url":{"type":"string"},"original_cover_art_s3_key":{"type":"string"},"original_cover_art":{"type":"string"},"original_cover_art_filename":{"type":"string"},"original_cover_art_thumbnail":{"type":"string"},"audio_language":{"type":"string"},"spotify_id":{"type":"string"},"release_date":{"type":"string"},"release_date_precision":{"type":"string"},"popularity":{"type":"number"},"release_type":{"type":"string"},"recording_studio":{"type":"string"},"publisher":{"type":"string"},"producer":{"type":"string"},"composer":{"type":"string"},"song_writer":{"type":"string"},"rights_administrator":{"type":"string"},"rights_owner":{"type":"string"},"sub_label":{"type":"string"},"created_at":{"type":"number"},"updated_at":{"type":"number"},"collection_published_email_sent":{"type":"number"},"customer_name":{"type":"string"},"lora_weights_s3_key":{"type":"string"},"content_type":{"type":"string"},"attribution_setup_status":{"type":"string"},"suno_analysis_request_ids":{"title":"SunoAnalysisRequestIds","type":"array","items":{"type":"string"}},"suno_analysis_result":{"title":"GetExternalAiMonitoringResponse","description":"The external AI monitoring results for the given collection or user.","type":"array","items":{"title":"ExternalAiMonitoringObject","type":"object","properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"HistogramValues","type":"array","items":{"title":"HistogramValuesInner","type":"object","properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}},"required":["binStart","binEnd","count"]}}},"required":["duration","period","values"]}}},"required":["master"]}},"required":["trackName","histogramValues"]}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"SynthesisRules","type":"object","properties":{"no_attribution_greater_than":{"type":"number"},"no_attribution_smaller_than":{"type":"number"},"no_shared_attribution_with_artist":{"type":"string"},"no_shared_attribution_with_genre":{"type":"string"}}},"label":{"type":"string"},"use_for_training_timestamp":{"type":"number"},"ai_company_notifications":{"title":"AiCompanyNotifications","type":"object","properties":{"notifications_status":{"type":"string"},"notification_time":{"type":"number"},"number_of_contacted_ai_companies":{"type":"number"},"contacted_ai_companies":{"title":"AiCompanyNotifications","type":"array","items":{"title":"AiCompanyNotification","type":"object","properties":{"ai_company_name":{"type":"string"},"ai_company_email":{"type":"string"},"status":{"type":"string"},"notification_time":{"type":"number"},"acknowledged":{"type":"boolean"}}}}}},"artists":{"title":"ArtistsArrayDb","type":"array","items":{"title":"ArtistDb","type":"object","properties":{"artist_name":{"type":"string"},"artist_external_id":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"},"audio_embeddings_s3_keys":{"title":"AudioEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"midi_embeddings_s3_keys":{"title":"MIDIEmbeddingsS3Keys","type":"array","items":{"type":"string"}},"lyrics_embeddings_s3_key":{"type":"string"},"fingerprint_db_s3_key":{"type":"string"},"lyrics_s3_key":{"type":"string"},"external_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"internal_check_results":{"title":"OptOutAnalysis","description":"If any songs are included in the response, it indicates that the input song has been opted out of AI training. The results provided contain all metadata details for the opted out songs. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"object","properties":{"master":{"title":"ChunkWiseOptOutAnalysis","type":"array","items":{"title":"ChunkWiseOptOutAnalysisInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"description":"The opt out analysis values for the given audios.","title":"OptOutArray","type":"array","items":{"title":"OptOutInfo","type":"object","properties":{"filename":{"type":"string"},"values":{"title":"OptOutValues","type":"array","items":{"title":"OptOutValuesInner","type":"object","properties":{"album":{"type":"string"},"album_id":{"type":"string"},"opt_in":{"type":"boolean"},"apple_music_uri":{"type":"string"},"artist":{"type":"string"},"cover_art_uri":{"type":"string"},"genre":{"type":"string"},"isrc":{"type":"string"},"label":{"type":"string"},"release_date":{"type":"string"},"score":{"title":"OptOutScore","type":"array","items":{"type":"number"}},"title":{"type":"string"},"track_id":{"type":"string"},"track_url":{"type":"string"}}}}},"required":["filename","values"]}}},"required":["duration","period","values"]}}}},"ai_check_results":{"description":"AI detection results are provided for each stem. The master stem delivers the most reliable results, while results for individual stems are available in beta.","title":"AIDetectionResultsWithStem","type":"object","properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","properties":{"filename":{"description":"The name of the audio file or stem being analyzed.","type":"string"},"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The period of the inspected segment, defining the interval at which new segments start, ensuring overlapping analysis. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"average_value":{"description":"The average AI-generated likelihood score across the entire file.","type":"number"},"average_value_confidence":{"description":"The confidence score associated with the average AI-generated likelihood value.","type":"number"},"max_value":{"description":"The highest AI-generated likelihood score detected in the file.","type":"number"},"max_value_confidence":{"description":"The confidence score associated with the max AI-generated likelihood value.","type":"number"},"values":{"description":"An array of AI-generated likelihood values for each analyzed segment. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerValues","anyOf":[{"title":"AIDetectionResultPerStemInnerValuesNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"confidence_scores":{"description":"Confidence scores corresponding to each likelihood value for the analyzed segments. A -1 in the array indicates that the corresponding segment is considered inaudible. If `values` is null, it means the stem was not found in the audio file.","title":"AIDetectionResultPerStemInnerConfidenceScores","anyOf":[{"title":"AIDetectionResultPerStemInnerConfidenceScoresNumbers","type":"array","items":{"type":"number"}},{"type":"null"}]},"generator_detection":{"description":"AI generator detection results mapping generator names (e.g. 'Suno') to probability statistics. Each generator contains average/max probabilities and per-segment probability scores ranging from 0-1, where higher values indicate stronger likelihood the audio was generated by that specific AI model. Only returned when enableGeneratorDetection is true and overall AI probability is above 0.5. Currently available in beta.","title":"AIDetectionResultPerStemInnerGeneratorDetection","anyOf":[{"type":"object","additionalProperties":{"title":"GeneratorDetectionInner","type":"object","properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}},"required":["average_probability","max_probability","per_segment_probabilities"]}},{"type":"null"}]}},"required":["filename","duration","period"]}}},"required":["master","instrumentals","vocals","bass","drums"]}},"required":["collection_uuid","username","status"]}},"attribution_setup_status":{"type":"string"},"suno_analysis_request_ids":{"title":"SunoAnalysisRequestIds","type":"array","items":{"type":"string"}},"suno_analysis_result":{"title":"GetExternalAiMonitoringResponse","description":"The external AI monitoring results for the given collection or user.","type":"array","items":{"title":"ExternalAiMonitoringObject","type":"object","properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","properties":{"duration":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"period":{"description":"The duration of the inspected segment, representing the length of each analyzed time window. If the duration and period are -1, it indicates that analysis for the entire song was calculated.","type":"number"},"values":{"title":"HistogramValues","type":"array","items":{"title":"HistogramValuesInner","type":"object","properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}},"required":["binStart","binEnd","count"]}}},"required":["duration","period","values"]}}},"required":["master"]}},"required":["trackName","histogramValues"]}},"company_name":{"description":"The name of the company/record label associated with the artist.","type":"string"},"lastEvaluatedKey":{"type":"string"}},"required":["username"]}},"metrics":{"title":"Metrics","type":"object","properties":{"registry":{"title":"GetRegistryOptInOutMetricsResponse","type":"object","properties":{"optOutPercentage":{"type":"number"},"optInPercentage":{"type":"number"},"optOutAmount":{"type":"number"},"optInAmount":{"type":"number"},"numberOfReleases":{"type":"number"},"numberOfAssets":{"type":"number"},"numberOfArtists":{"type":"number"},"collectionWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"collectionWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"artistsWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"artistsWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"genreWithMostOptedOutAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"genreWithMostOptedInAssets":{"title":"OptInOutValue","type":"object","properties":{"name":{"type":"string"},"totalAssets":{"type":"string"},"groupedResults":{"type":"object","additionalProperties":{"title":"GroupedResultItem","type":"object","properties":{"key":{"type":"string"},"totalAssets":{"type":"number"},"contentType":{"type":"string"}}}}}},"rulesForOptIn":{"type":"string"}},"required":["optOutPercentage","optInPercentage","optOutAmount","optInAmount","numberOfReleases","numberOfAssets"]}},"required":["registry"]},"lastEvaluatedKey":{"description":"The `lastEvaluatedKey` is used for pagination. It indicates the last item returned in the current page.","type":"string"}}}}}}}}}},"servers":[{"url":"https://api.sureel.ai","description":"Production"}],"tags":[{"name":"audio-ai","description":"Audio synthesis, speech synthesis, stem split, and attribution calculation"},{"name":"image-ai","description":"Image synthesis, attribution calculation and fine-tuning"},{"name":"files","description":"Files can be uploaded either as form-data or by using a pre-signed PUT URL."},{"name":"prompt-history","description":"Prompt history for all synthesis requests like text-to-audio"},{"name":"analysis-history","description":"Analysis history for all analysis requests, such as attribution analysis or AI detection"},{"name":"artist","description":"Artists and collections"},{"name":"record-label","description":"Record label"},{"name":"asset-metadata","description":"Asset metadata"},{"name":"ai-model-artifacts","description":"AI model artifacts"}]}