{"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-company/":{"get":{"operationId":"getAiCompanies","summary":"Get AI companies","tags":["ai-company"],"description":"Get a list of all AI companies registered in the system.","security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetAiCompaniesResponse","additionalProperties":false,"type":"object","required":["ai_companies"],"properties":{"ai_companies":{"title":"AiCompanies","description":"List of AI company names.","type":"array","items":{"title":"AiCompanyItem","additionalProperties":false,"type":"object","required":["ai_company_name"],"properties":{"ai_company_name":{"description":"The name of the AI company.","type":"string"}}}}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"title":"TrackTrainingArtifactsBody","type":"object","required":["model_name","audio_id","captions_file","model_manifest_file","training_artifacts"],"properties":{"model_name":{"description":"Name of the model including version.","type":"string"},"audio_id":{"description":"Sureel per-track Registry ID, supplied by Sureel alongside the audio file.","type":"string"},"captions_file":{"description":"File path to the captions file containing the per-track caption (may be empty) and optionally the lyrics. The 'captions_file' can either be a file URL, the key returned from the `/files/upload-files` endpoint, or the key returned from the `/files/generate-upload-urls` PUT signed URL flow (recommended for files larger than the form-data limit; up to 1GB per file). Supported formats include .JSON.","type":"string"},"model_manifest_file":{"description":"File path to the model manifest file. Declares the model_family, artifact_schema_version, adapter_applied flag and all model and processing configuration. The 'model_manifest_file' can either be a file URL, the key returned from the `/files/upload-files` endpoint, or the key returned from the `/files/generate-upload-urls` PUT signed URL flow (recommended for files larger than the form-data limit; up to 1GB per file). Supported formats include .JSON.","type":"string"},"training_artifacts":{"title":"TrainingArtifact","description":"List of training artifacts.","type":"array","items":{"title":"TrainingArtifactEntry","type":"object","required":["stem_combination","artifacts_per_epoch"],"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, the key returned from the `/files/upload-files` endpoint, or the key returned from the `/files/generate-upload-urls` PUT signed URL flow (recommended for files larger than the form-data limit; up to 1GB per file). Supported formats include .JSON.","type":"string"},"conditioning_file":{"description":"File path to the conditioning file. The 'conditioning_file' can either be a file URL, the key returned from the `/files/upload-files` endpoint, or the key returned from the `/files/generate-upload-urls` PUT signed URL flow (recommended for files larger than the form-data limit; up to 1GB per file). Supported formats include .NPY.","type":"string"},"artifacts_per_epoch":{"title":"ArtifactsPerEpoch","description":"List of artifacts per epoch.","type":"array","items":{"title":"ArtifactsPerEpochEntry","type":"object","required":["epoch","artifacts_file"],"properties":{"epoch":{"description":"Generic capture time point. Set to 1 for trained models or single adapters.","type":"number"},"artifacts_file":{"description":"File path to the artifacts file containing the real activation vectors captured at this time point. The 'artifacts_file' can either be a file URL, the key returned from the `/files/upload-files` endpoint, or the key returned from the `/files/generate-upload-urls` PUT signed URL flow (recommended for files larger than the form-data limit; up to 1GB per file). Supported formats include .NPY (single array) and .NPZ (multi-array).","type":"string"}}}}}}}}},"example":{"model_name":"audio-gen-v2.1","audio_id":"audio_abc123def456","captions_file":"https://example.com/captions/audio_abc123def456.json","model_manifest_file":"https://example.com/manifests/audio-gen-v2.1_model_manifest.json","training_artifacts":[{"stem_combination":"master","stem_input_association_file":"https://example.com/stems/audio_abc123def456_association.json","conditioning_file":"https://example.com/conditioning/audio_abc123def456.npy","artifacts_per_epoch":[{"epoch":1,"artifacts_file":"https://example.com/artifacts/audio_abc123def456_epoch1.npy"},{"epoch":2,"artifacts_file":"https://example.com/artifacts/audio_abc123def456_epoch2.npz"}]}]}}}},"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":{"required":true,"content":{"application/json":{"schema":{"title":"TrackInferenceArtifactsBody","type":"object","required":["model_name","inference_request_id","model_manifest_file","text_inputs_file","config_file","content_audios","style_audios","output_audios","artifacts_file"],"properties":{"model_name":{"description":"Name of the model including version.","type":"string"},"inference_request_id":{"description":"Unique identifier for each generated track, allowing Sureel attribution to be mapped back to the generated audios on the Mirage side.","type":"string"},"model_manifest_file":{"description":"File path to the model manifest file. Declares the model_family, artifact_schema_version, adapter_applied flag and all model and processing configuration. The 'model_manifest_file' can either be a file URL, the key returned from the `/files/upload-files` endpoint, or the key returned from the `/files/generate-upload-urls` PUT signed URL flow (recommended for files larger than the form-data limit; up to 1GB per file). Supported formats include .JSON.","type":"string"},"text_inputs_file":{"description":"File path to the text inputs file containing the required 'text_prompt' and optionally 'lyrics' and 'inference_request_id'. The 'text_inputs_file' can either be a file URL, the key returned from the `/files/upload-files` endpoint, or the key returned from the `/files/generate-upload-urls` PUT signed URL flow (recommended for files larger than the form-data limit; up to 1GB per file). Supported formats include .JSON.","type":"string"},"config_file":{"description":"File path to the per-generation configuration file. The 'config_file' can either be a file URL, the key returned from the `/files/upload-files` endpoint, or the key returned from the `/files/generate-upload-urls` PUT signed URL flow (recommended for files larger than the form-data limit; up to 1GB per file). 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 containing the real activation vectors. The 'artifacts_file' can either be a file URL, the key returned from the `/files/upload-files` endpoint, or the key returned from the `/files/generate-upload-urls` PUT signed URL flow (recommended for files larger than the form-data limit; up to 1GB per file). Supported formats include .NPY (single array) and .NPZ (multi-array).","type":"string"},"conditioning_file":{"description":"File path to the conditioning file. The 'conditioning_file' can either be a file URL, the key returned from the `/files/upload-files` endpoint, or the key returned from the `/files/generate-upload-urls` PUT signed URL flow (recommended for files larger than the form-data limit; up to 1GB per file). Supported formats include .NPY.","type":"string"}}},"example":{"model_name":"audio-gen-v2.1","inference_request_id":"infer_req_789xyz","model_manifest_file":"https://example.com/manifests/audio-gen-v2.1_model_manifest.json","text_inputs_file":"https://example.com/inputs/infer_req_789xyz.json","config_file":"https://example.com/configs/infer_req_789xyz_config.json","content_audios":["https://example.com/audio/content_input_1.wav","https://example.com/audio/content_input_2.wav"],"style_audios":["https://example.com/audio/style_reference.wav"],"output_audios":["https://example.com/audio/output_1.wav","https://example.com/audio/output_2.wav"],"artifacts_file":"https://example.com/artifacts/infer_req_789xyz.npy","conditioning_file":"https://example.com/conditioning/infer_req_789xyz.npy"}}}},"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/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 analysis results 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 analysis results 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","required":["analysisHistory","lastEvaluatedKey"],"properties":{"analysisHistory":{"title":"AnalysisHistory","type":"array","items":{"title":"AnalysisHistoryEntry","type":"object","allOf":[{"title":"GetLdmResponse","type":"object","required":["requestId"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}}}}}}}]},"provenance":{"title":"Provenance","anyOf":[{"type":"null"},{"title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}}}}}}}]},"contentImage":{"type":"string"},"styleImage":{"type":"string"},"maskImage":{"type":"string"},"artistProfilePictures":{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","required":["artistName","picture"],"properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"},"labelName":{"type":"string"}}}}]},"seed":{"type":"number"},"requestData":{"title":"GetLdmRequestData","type":"object","required":["user_id","request_id"],"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"}]}}},"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","required":["similarFiles","topMetrics"],"properties":{"similarFiles":{"title":"SimilarImageFilesWithMetrics","type":"array","items":{"title":"SimilarImageFile","type":"object","required":["attribution_likelihood","color_matching","pixelwise_similarity"],"properties":{"attribution_likelihood":{"type":"number"},"cross_correlation":{"type":"number"},"color_matching":{"title":"ColorMatching","type":"object","required":["g_channel","r_channel","b_channel"],"properties":{"g_channel":{"type":"number"},"r_channel":{"type":"number"},"b_channel":{"type":"number"}}},"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"}}}},"topMetrics":{"title":"TopMetrics","type":"object","required":["attribution_likelihood","cross_correlation","color_matching","color_matching_combined","pixelwise_similarity","identical_matches"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"cross_correlation":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"color_matching":{"title":"TopColorMatching","type":"object","required":["g_channel","r_channel","b_channel"],"properties":{"g_channel":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"r_channel":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"b_channel":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}},"color_matching_combined":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"pixelwise_similarity":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls","signed_urls_thumbnails"],"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"}]}}}}}}}},"originalFilename":{"type":"string"}}},{"title":"GetAudioLdmResponse","type":"object","required":["requestId"],"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"},"metadataUrl":{"description":"Signed URL to the extracted-metadata JSON on S3 (metadata-extraction requests only).","type":"string"},"metadata":{"title":"ExtractedMetadata","description":"Extracted metadata keyed by track S3 key. Only inlined when the file is small; the signed URL is always provided.","type":"object","additionalProperties":{}},"seed":{"type":"number"},"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"compositionAttributionPerTrack":{"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"ipGuardrailAttributionPerCollection":{"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"ipGuardrailAttributionPerTrack":{"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"provenance":{"title":"Provenance","anyOf":[{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}},{"type":"null"}]},"artistProfilePictures":{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","required":["artistName","picture"],"properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"},"labelName":{"type":"string"}}}}]},"requestData":{"title":"AudioLdmRequestData","type":"object","required":["user_id","request_id"],"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"}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"MusicalityValues","type":"object","required":["genre_analysis","mood_analysis"],"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","required":["genre","values"],"properties":{"genre":{"type":"string"},"values":{"title":"GenreAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}}}},"mood_analysis":{"title":"MoodAnalysisValues","type":"array","items":{"title":"MoodAnalysisValuesInner","type":"object","required":["mood","values"],"properties":{"mood":{"type":"string"},"values":{"title":"MoodAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}}}}}}}}}}}}}},"aiDnaVisualization":{"title":"VisualizationS3KeysResponse","type":"array","items":{"title":"AI DNA Visualization","description":"Images for the AI DNA Visualization","type":"object","required":["master"],"properties":{"master":{"title":"ChunkWiseVisualizationS3keysResponse","type":"array","items":{"title":"VisualizationS3keysResponseInner","type":"object","required":["signedUrls"],"properties":{"filename":{"type":"string"},"signedUrls":{"title":"SignedUrls","type":"array","items":{"type":"string"}}}}}}}},"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","required":["duration","period","values"],"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","required":["score","similar_lyrics_inspected","similar_lyrics_original","track","is_spotify_url"],"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"}}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}}}},"similarTracks":{"title":"SimilarTracks","type":"array","items":{"title":"SimilarTracksInner","type":"object","required":["track","signed_url","is_spotify_url"],"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"}}}},"artist_uuid":{"type":"string"},"originalFilename":{"type":"string"},"audios_rule_evaluations":{"title":"AudiosRuleEvaluations","type":"array","items":{"title":"AudioRuleEvaluation","description":"Per-AI-song rule evaluation result: blocked status, violations, and (for blocked songs) the preview duration. Parallel to audiosSignedUrls.","additionalProperties":false,"type":"object","required":["filename","blocked","rule_violations"],"properties":{"filename":{"description":"The AI-generated audio filename this entry describes.","type":"string"},"blocked":{"description":"True if any attribution rule was violated for this AI song. When blocked, the corresponding entry in audiosSignedUrls is a half-duration preview (or empty if the clipping pipeline is not yet wired).","type":"boolean"},"preview_duration_seconds":{"description":"Duration in seconds of the half-song preview returned for blocked audios.","type":"number"},"preview_failed_stems":{"description":"List of audios (master + stems) whose preview clip failed and will be retried on subsequent fetches. Absent/empty means all clips succeeded.","type":"array","items":{"anyOf":[{"type":"string","enum":["master"]},{"type":"string","enum":["vocals"]},{"type":"string","enum":["instrumentals"]},{"type":"string","enum":["bass"]},{"type":"string","enum":["drums"]}]}},"rule_violations":{"title":"AudioRuleEvaluationViolations","type":"array","items":{"title":"RuleViolation","description":"Describes a single attribution rule violation for a collection.","additionalProperties":false,"type":"object","required":["collection_uuid","rule","source","filename","message"],"properties":{"collection_uuid":{"type":"string"},"rule":{"description":"The rule that was violated.","anyOf":[{"type":"string","enum":["no_attribution_greater_than"]},{"type":"string","enum":["no_attribution_smaller_than"]},{"type":"string","enum":["no_shared_attribution_with_artist"]},{"type":"string","enum":["time_scoped_consent"]}]},"source":{"description":"Which attribution signal tripped the rule: recording or composition attribution.","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["composition"]}]},"filename":{"description":"The generated AI song (filename) that tripped the rule.","type":"string"},"source_stem":{"description":"Which stem tripped the rule, for per-stem rules (no_attribution_greater_than, no_attribution_smaller_than). Unset for rules whose semantics are not per-stem.","anyOf":[{"type":"string","enum":["master"]},{"type":"string","enum":["vocals"]},{"type":"string","enum":["instrumentals"]},{"type":"string","enum":["bass"]},{"type":"string","enum":["drums"]}]},"threshold":{"description":"The threshold the rule was configured with, where applicable.","type":"number"},"observed":{"description":"The observed attribution percentage, where applicable.","type":"number"},"message":{"type":"string"}}}}}}}}}]}},"lastEvaluatedKey":{"title":"LastEvaluatedKey","anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"CreateCollectionRequest","type":"object","required":["collection_name","contentType"],"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, FLAC, AIFF, AIF, and WMA 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":"The individual performers who contributed to the recording of the collection. An artist is a creative contributor on the recording side.","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"},"artistRole":{"description":"The role of one artist that contributed to the collection.","type":"string"},"artistIsni":{"description":"The ISNI (International Standard Name Identifier) of the contributor, a 16-character identifier for a natural or legal person (15 digits plus a final digit or X). Submit without spaces or hyphens.","pattern":"^[0-9]{15}[0-9X]$","type":"string"},"artistUaid":{"description":"The UAID of the contributor.","type":"string"},"artistPartyId":{"description":"The party ID of the contributor in the delivering partner's system.","type":"string"},"artistSpotifyId":{"description":"The Spotify artist ID.","type":"string"},"artistAppleId":{"description":"The Apple Music artist ID.","type":"string"},"artistDateOfBirth":{"description":"The date of birth of the contributor. The format is YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}}}},"ip_rights":{"title":"IpRights","description":"Intellectual property rights information for the file.","type":"object","properties":{"recording":{"title":"RecordingContributors","description":"List of recording contributors and their respective AI training consent.","type":"array","items":{"title":"RecordingContributor","type":"object","properties":{"contributor":{"description":"The contributor of the recording.","type":"string"},"identifiers":{"title":"ContributorIdentifiers","description":"Identifiers and personal identification data for the contributor.","type":"object","properties":{"external_id":{"description":"The external ID of the contributor in another system, e.g. OpenPlay. This ID can be used to reference the contributor.","type":"string"},"isni":{"description":"The ISNI (International Standard Name Identifier) of the contributor, a 16-character identifier (15 digits plus a final digit or X). Submit without spaces or hyphens.","pattern":"^[0-9]{15}[0-9X]$","type":"string"},"party_id":{"description":"The party ID of the contributor in the delivering partner's system.","type":"string"},"sureel_party_uuid":{"description":"The Sureel party UUID of the contributor: the platform-minted identity of their artist or songwriter profile record. Set when the contributor could be resolved to a profile; distinct from party_id, which is the delivering partner's identifier.","type":"string"},"uaid":{"description":"The UAID of the contributor.","type":"string"},"date_of_birth":{"description":"The date of birth of the contributor. The format is YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}}},"contributor_role":{"title":"ContributorRole","description":"The role of the contributor in the recording.","anyOf":[{"type":"string","enum":["Performed by"]},{"type":"string","enum":["Vocalist"]},{"type":"string","enum":["Lead vocalist"]},{"type":"string","enum":["Background vocalist"]},{"type":"string","enum":["Instrumentalist"]},{"type":"string","enum":["Guitarist"]},{"type":"string","enum":["Bassist"]},{"type":"string","enum":["Drummer"]},{"type":"string","enum":["Keyboardist"]},{"type":"string","enum":["Producer"]},{"type":"string","enum":["Executive producer"]},{"type":"string","enum":["Co-producer"]},{"type":"string","enum":["Engineer"]},{"type":"string","enum":["Mixing engineer"]},{"type":"string","enum":["Mastering engineer"]},{"type":"string","enum":["Recording engineer"]},{"type":"string","enum":["Featured artist"]},{"type":"string","enum":["Primary artist"]},{"minLength":1,"type":"string"}]},"split_percentage":{"description":"The split percentage of the recording contributed by the artist.","minimum":0,"maximum":1,"type":"number"},"territory":{"description":"The territory in which the recording is distributed.","type":"string"},"allow_ai_training":{"description":"Indicates whether to allow AI training on the recording data.","type":"boolean"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"_delete":{"description":"Set to true to remove this contributor during a merge update.","type":"boolean"}}}},"publishing":{"title":"PublishingContributors","description":"List of publishing contributors and their respective AI training consent.","type":"array","items":{"title":"PublishingContributor","type":"object","properties":{"work_title":{"description":"The title of the musical work.","type":"string"},"external_work_id":{"description":"An external identifier for the musical work, e.g. from a CMO or publishing administration system.","type":"string"},"iswc":{"description":"The ISWC (International Standard Musical Work Code) is a unique identifier for musical works.","type":"string"},"contributor":{"description":"The contributor of the publishing.","type":"string"},"ipi_number":{"description":"The IPI (Interested Parties Information) number for songwriter/publisher identification. Typically a 9 to 11 digit numeric code assigned by CISAC.","pattern":"^[0-9]{9,11}$","type":"string"},"pro_affiliation":{"title":"ProAffiliation","description":"The Performance Rights Organization (PRO) the contributor is affiliated with (e.g., ASCAP, BMI, GEMA).","anyOf":[{"type":"string","enum":["ASCAP"]},{"type":"string","enum":["BMI"]},{"type":"string","enum":["SESAC"]},{"type":"string","enum":["GEMA"]},{"type":"string","enum":["PRS"]},{"type":"string","enum":["SOCAN"]},{"type":"string","enum":["SACEM"]},{"type":"string","enum":["JASRAC"]},{"type":"string","enum":["APRA AMCOS"]},{"type":"string","enum":["BUMA/STEMRA"]},{"type":"string","enum":["SGAE"]},{"type":"string","enum":["SIAE"]},{"type":"string","enum":["SUISA"]},{"type":"string","enum":["KODA"]},{"type":"string","enum":["TONO"]},{"type":"string","enum":["STIM"]},{"type":"string","enum":["TEOSTO"]},{"type":"string","enum":["KOMCA"]},{"type":"string","enum":["IMRO"]},{"minLength":1,"type":"string"}]},"identifiers":{"title":"ContributorIdentifiers","description":"Identifiers and personal identification data for the contributor.","type":"object","properties":{"external_id":{"description":"The external ID of the contributor in another system, e.g. OpenPlay. This ID can be used to reference the contributor.","type":"string"},"isni":{"description":"The ISNI (International Standard Name Identifier) of the contributor, a 16-character identifier (15 digits plus a final digit or X). Submit without spaces or hyphens.","pattern":"^[0-9]{15}[0-9X]$","type":"string"},"party_id":{"description":"The party ID of the contributor in the delivering partner's system.","type":"string"},"sureel_party_uuid":{"description":"The Sureel party UUID of the contributor: the platform-minted identity of their artist or songwriter profile record. Set when the contributor could be resolved to a profile; distinct from party_id, which is the delivering partner's identifier.","type":"string"},"uaid":{"description":"The UAID of the contributor.","type":"string"},"date_of_birth":{"description":"The date of birth of the contributor. The format is YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}}},"contributor_role":{"title":"PublishingContributorRole","description":"The role of the contributor in the publishing.","anyOf":[{"type":"string","enum":["Composer"]},{"type":"string","enum":["Songwriter"]},{"type":"string","enum":["Co-songwriter"]},{"type":"string","enum":["Lyricist"]},{"type":"string","enum":["Lyric writer"]},{"type":"string","enum":["Music composer"]},{"type":"string","enum":["Melody writer"]},{"type":"string","enum":["Author"]},{"type":"string","enum":["Co-author"]},{"type":"string","enum":["Writer"]},{"type":"string","enum":["Co-writer"]},{"type":"string","enum":["Arranger"]},{"type":"string","enum":["Adapter"]},{"type":"string","enum":["Translator"]},{"type":"string","enum":["Publisher"]},{"type":"string","enum":["Rights holder"]},{"type":"string","enum":["Administrator"]},{"minLength":1,"type":"string"}]},"split_percentage":{"description":"The split percentage of the publishing contributed by the artist.","minimum":0,"maximum":1,"type":"number"},"territory":{"description":"The territory in which the publishing is distributed.","type":"string"},"allow_ai_training":{"description":"Indicates whether to allow AI training on the publishing data.","type":"boolean"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"_delete":{"description":"Set to true to remove this contributor during a merge update.","type":"boolean"}}}}}},"labels":{"title":"Labels","description":"The record label(s) that released the song. A label is an organizational entity on the recording side.","type":"array","items":{"type":"string"}},"publisher":{"description":"The publishing company that administers the song's composition rights and royalties. A publisher is an organizational entity on the publishing side.","type":"string"},"cover":{"description":"Indicates whether the song is a cover.","type":"boolean"},"category":{"description":"The category of the track, e.g. sound effect, remix, original, cover, etc.","type":"string"},"hasVocal":{"description":"Indicates whether the track contains vocal content.","type":"boolean"},"acapella":{"description":"Indicates whether the song is acapella, i.e., contains only vocals.","type":"boolean"},"instrumental":{"description":"Indicates whether the song is instrumental.","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","required":["stemFilePath","stemType"],"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"}}}},"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"},"producer":{"description":"For music, you can set the producer.","type":"string"},"composer":{"description":"The individual who wrote the music (melody and harmony) of the song. A composer is a creative contributor on the publishing side.","type":"string"},"songWriter":{"description":"The individual who wrote the lyrics and melody of the song. A songwriter is a creative contributor on the publishing side.","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"]}]}}}},"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"},"contentType":{"enum":["audio","image","video"],"title":"ContentType","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"},"ean":{"description":"The EAN-13 (International Article Number) that uniquely identifies the release/product. 13 digits.","pattern":"^[0-9]{13}$","type":"string"},"grid":{"description":"The GRid (Global Release Identifier), an 18-character identifier for the release, e.g. A1-2425G-ABC1234002-M. Hyphens are optional.","pattern":"^[A-Z0-9]{2}-?[A-Z0-9]{5}-?[A-Z0-9]{10}-?[A-Z0-9]$","type":"string"},"projectId":{"description":"The project ID of the release/product in the delivering partner's system.","type":"string"},"artists":{"title":"Artists","description":"The individual performers who contributed to the recording of the collection. An artist is a creative contributor on the recording side. Only a request acting for an organization (X-Sureel-Org) whose role holds roster:write 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"},"artistRole":{"description":"The role of one artist that contributed to the collection.","type":"string"},"artistIsni":{"description":"The ISNI (International Standard Name Identifier) of the contributor, a 16-character identifier for a natural or legal person (15 digits plus a final digit or X). Submit without spaces or hyphens.","pattern":"^[0-9]{15}[0-9X]$","type":"string"},"artistUaid":{"description":"The UAID of the contributor.","type":"string"},"artistPartyId":{"description":"The party ID of the contributor in the delivering partner's system.","type":"string"},"artistSpotifyId":{"description":"The Spotify artist ID.","type":"string"},"artistAppleId":{"description":"The Apple Music artist ID.","type":"string"},"artistDateOfBirth":{"description":"The date of birth of the contributor. The format is YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","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":{"default":false,"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"},"producer":{"description":"For music, you can set the producer.","type":"string"},"composer":{"description":"The individual who wrote the music (melody and harmony) of the song. A composer is a creative contributor on the publishing side.","type":"string"},"songWriter":{"description":"The individual who wrote the lyrics and melody of the song. A songwriter is a creative contributor on the publishing side.","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 (subsidiary imprint) under the parent label that released the song. Like a label, a sub-label is an organizational entity on the recording side.","type":"string"},"publisher":{"description":"The publishing company that administers the song's composition rights and royalties. A publisher is an organizational entity on the publishing side.","type":"string"},"enableAutomaticAttributionSetup":{"description":"Enable or disable automatic attribution setup.","default":true,"type":"boolean"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}}}},"example":{"files":[{"filePath":"https://example.com/track1.wav","trackTitle":"Midnight Dreams","isrc":"USUM71703861","externalTrackId":"track-123456","externalUrl":"https://example.com/track/midnight-dreams","artists":[{"artistName":"John Doe","artistExternalId":"artist-ext-789","artistRole":"Primary Artist","artistIsni":"0000000121174585","artistUaid":"UAID-000123","artistPartyId":"PADPIDA2007040502I","artistSpotifyId":"1uNFoZAHBGtllmzznpCI3s","artistAppleId":"159260351","artistDateOfBirth":"1985-04-12"}],"ip_rights":{"recording":[{"contributor":"John Doe","identifiers":{"external_id":"contributor-ext-123","isni":"0000000121174585","party_id":"PADPIDA2007040502I","sureel_party_uuid":"0f8a3b2e-5c41-4d69-9a77-2e1b6f4c8d05","uaid":"UAID-000123","date_of_birth":"1985-04-12"},"contributor_role":"Performed by","split_percentage":0.5,"territory":"US","allow_ai_training":true,"opt_in_rules":{"ai_company_scoped_consent":[{"ai_company_name":"Mirage","allow_ai_training":true}],"time_scoped_consent":{"start_timestamp":1770740622000,"end_timestamp":1773159822000},"no_attribution_greater_than":25,"no_attribution_smaller_than":3,"no_shared_attribution_with_artist":"Example artist","no_shared_attribution_with_genre":"Classical","allow_cover_art_in_motion_picture":true,"allow_lyrics":true}}],"publishing":[{"work_title":"Midnight Dreams","external_work_id":"WRK-123456","iswc":"T-123.456.789-0","contributor":"Bob Dylan","ipi_number":"00523879401","pro_affiliation":"ASCAP","identifiers":{"external_id":"contributor-ext-456","isni":"0000000114559647","party_id":"PADPIDA2007040502W","sureel_party_uuid":"6c2d9e71-84fb-4a0c-b3d5-91e7a25c4f68","uaid":"UAID-000456","date_of_birth":"1941-05-24"},"contributor_role":"Composer","split_percentage":0.5,"territory":"worldwide","allow_ai_training":true,"opt_in_rules":{"ai_company_scoped_consent":[{"ai_company_name":"Mirage","allow_ai_training":true}],"time_scoped_consent":{"start_timestamp":1770740622000,"end_timestamp":1773159822000},"no_attribution_greater_than":25,"no_attribution_smaller_than":3,"no_shared_attribution_with_artist":"Example artist","no_shared_attribution_with_genre":"Classical","allow_cover_art_in_motion_picture":true,"allow_lyrics":true}}]},"labels":["Electronic Music Records","Ambient Sounds"],"publisher":"Universal Music Publishing","cover":false,"category":"original","hasVocal":true,"acapella":false,"instrumental":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","producer":"Rick Rubin","composer":"John Williams","songWriter":"Bob Dylan","rightsAdministrator":"ASCAP","rightsOwner":"Universal Music Group","aiInfluence":"AI refined"}],"collection_name":"My First Collection","collection_description":"A collection of my original music tracks with electronic and ambient influences","contentType":"audio","upc":"123456789012","ean":"4006381333931","grid":"A12425GABC1234002M","projectId":"PRJ-2026-000123","artists":[{"artistName":"John Doe","artistExternalId":"artist-123","artistRole":"Primary Artist","artistIsni":"0000000121174585","artistUaid":"UAID-000123","artistPartyId":"PADPIDA2007040502I","artistSpotifyId":"1uNFoZAHBGtllmzznpCI3s","artistAppleId":"159260351","artistDateOfBirth":"1985-04-12"}],"styles":"electronic, ambient, downtempo","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","producer":"Rick Rubin","composer":"John Williams","songWriter":"Bob Dylan","rightsAdministrator":"ASCAP","rightsOwner":"Universal Music Group","subLabel":"Interscope Records","publisher":"Universal Music Publishing","enableAutomaticAttributionSetup":true,"opt_in_rules":{"ai_company_scoped_consent":[{"ai_company_name":"Mirage","allow_ai_training":true}],"time_scoped_consent":{"start_timestamp":1770740622000,"end_timestamp":1773159822000},"no_attribution_greater_than":25,"no_attribution_smaller_than":3,"no_shared_attribution_with_artist":"Example artist","no_shared_attribution_with_genre":"Classical","allow_cover_art_in_motion_picture":true,"allow_lyrics":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","required":["collectionUuid","files"],"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","required":["fileId"],"properties":{"fileId":{"description":"The file ID of the uploaded files.","type":"string"},"trackTitle":{"description":"The name of the track.","type":"string"}}}}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"SetFilepathsRequest","type":"object","required":["collectionUuid","files"],"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","required":["fileId","filePath"],"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, FLAC, AIFF, AIF, and WMA for audio; and MP4 for video.","type":"string"}}}},"enableAutomaticAttributionSetup":{"description":"Enable or disable automatic attribution setup.","default":true,"type":"boolean"}}},"example":{"collectionUuid":"550e8400","files":[{"fileId":"file_12345","filePath":"https://example.com/audio/track1.wav"},{"fileId":"file_67890","filePath":"https://example.com/audio/track2.wav"}],"enableAutomaticAttributionSetup":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/collection/from-ddex":{"post":{"operationId":"createCollectionFromDdex","summary":"Create a collection from a DDEX ERN 4.3 delivery","tags":["artist"],"description":"Ingest a DDEX ERN 4.3 release. The manifest is fetched (or extracted from a ZIP), per-track metadata (titles, ISRCs, durations, contributors) is extracted, and one collection is created. Multi-release deliveries are rejected with 400.","requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"CreateCollectionFromDdexRequest","additionalProperties":false,"type":"object","required":["source"],"properties":{"source":{"title":"DdexSource","description":"Discriminated by `kind`. `zip` for a single ZIP delivery, `manifest` for a manifest pointing at remotely-hosted audio. Each variant's value accepts an HTTPS URL or a key from the file-upload endpoints.","anyOf":[{"title":"DdexSourceZip","additionalProperties":false,"type":"object","required":["kind","zip"],"properties":{"kind":{"type":"string","enum":["zip"]},"zip":{"description":"DDEX ZIP delivery. Either an HTTPS URL to the ZIP, or a key returned from `/files/upload-files` or `/files/generate-upload-urls`. The ZIP contains the DDEX ERN manifest XML and all referenced audio + image resources.","type":"string"}}},{"title":"DdexSourceManifest","additionalProperties":false,"type":"object","required":["kind","manifest"],"properties":{"kind":{"type":"string","enum":["manifest"]},"manifest":{"description":"Standalone DDEX ERN manifest XML. Either an HTTPS URL to the manifest, or a key returned from `/files/upload-files` or `/files/generate-upload-urls`. Audio resources are fetched individually from the `` elements inside the manifest.","type":"string"}}}]},"options":{"title":"CreateCollectionFromDdexOptions","additionalProperties":false,"type":"object","properties":{"useForTraining":{"default":false,"description":"Whether the collection opts in to AI training.","type":"boolean"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"contentType":{"enum":["audio","image","video"],"default":"audio","description":"Content type of the assets referenced by the manifest. Defaults to audio.","title":"DdexContentType","type":"string"},"enableAutomaticAttributionSetup":{"default":true,"description":"Whether to start automatic C2PA and attribution setup after the collection is created.","type":"boolean"}}}}}}}},"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":"CreateCollectionFromDdexResponse","type":"object","required":["collectionUuids","warnings"],"properties":{"collectionUuids":{"title":"DdexCollectionUuids","description":"Always length 1 today; multi-release deliveries may produce N UUIDs in future versions.","type":"array","items":{"description":"UUID of a collection created from the DDEX manifest.","type":"string"}},"warnings":{"title":"DdexWarnings","description":"Non-fatal manifest parsing notes. May be empty.","type":"array","items":{"title":"DdexWarning","type":"object","required":["code","message"],"properties":{"code":{"description":"Short machine-readable warning identifier (e.g. `unknown_contributor_role`).","type":"string"},"message":{"description":"Human-readable description.","type":"string"}}}}}}}}}}}},"/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 return per page. Defaults to 20, at most 100."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"The optional `cursor` parameter is the `lastEvaluatedKey` from the previous page. Omit it to read the first page. A page in the middle of a walk can come back empty and still carry a cursor, so read on until a page comes back without one rather than stopping at the first empty page. A cursor belongs to the sort and the search it was issued under: handing it back with a different `sort_by`, `collection_search_value` or `search` is refused with 400."},{"schema":{"enum":["collection_name"],"type":"string"},"in":"query","name":"collection_search_field","required":false,"description":"Field to search collections by."},{"schema":{"maxLength":100,"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. Answered by the search index, so the request is refused with 503 while that index is unavailable."},{"schema":{"enum":["release_date","collection_name","number_of_assets","created_at","updated_at","upc","styles","ai_company_notifications.notifications_status","ai_company_notifications.number_of_contacted_ai_companies","use_for_training_timestamp"],"type":"string"},"in":"query","name":"sort_by","required":false,"description":"Specifies the sorting criteria. While the search index is unavailable, only release_date, collection_name and number_of_assets can be answered; the other fields are refused with 503."},{"schema":{"enum":["asc","desc"],"type":"string"},"in":"query","name":"sort_order","required":false,"description":"Specifies the sorting order, defaults to desc."},{"schema":{"pattern":"^(album|single|compilation|audio collection|image collection|video collection)(,(album|single|compilation|audio collection|image collection|video collection))*$","type":"string"},"examples":{"album":{"value":"album"},"single":{"value":"single"},"album,single,compilation":{"value":"album,single,compilation"}},"in":"query","name":"release_type","required":false,"description":"Filter collections by release type. Supports comma-separated values for multiple types (e.g. 'album,single'). Valid values: album, single, compilation, audio collection, image collection, video collection. Only the values ingestion writes are stored on a record and can therefore be filtered on: album, single, compilation. The remaining values (\"audio collection\", \"image collection\", \"video collection\") are derived at read time from a collection's assets and are not filterable yet: asking for one matches nothing."},{"schema":{"enum":["true","false"],"type":"string"},"in":"query","name":"use_for_training","required":false,"description":"Filter collections by their `use_for_training` flag."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistProfileData","type":"object","allOf":[{"title":"BaseProfileData","type":"object","required":["username"],"properties":{"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"auth0_id":{"type":"string"},"profile_picture_s3_key":{"type":"string"},"profile_picture_source":{"title":"ProfilePictureSource","anyOf":[{"type":"string","enum":["artist_photo"]},{"type":"string","enum":["promo_photo"]},{"type":"string","enum":["cover_art"]},{"type":"string","enum":["user_upload"]}]},"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":{"title":"UserRole","anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["ai_company"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["publisher"]}]},"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"},"publisher_name":{"type":"string"},"connected_publisher":{"type":"string"},"sureel_party_uuid":{"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"}},"signed_labels":{"title":"SignedLabels","type":"array","items":{"type":"string"}},"metrics":{"title":"Metrics","type":"object","required":["registry"],"properties":{"registry":{"title":"GetRegistryOptInOutMetricsResponse","type":"object","required":["optOutPercentage","optInPercentage","optOutAmount","optInAmount","numberOfReleases","numberOfAssets","rulesForOptIn"],"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":{"anyOf":[{"type":"string"},{"title":"OptInRulesForMetrics","type":"array","items":{"title":"OptInRulesForMetricsItem","type":"object","required":["collection_uuid","opt_in_rules"],"properties":{"collection_uuid":{"type":"string"},"collection_name":{"type":"string"},"username":{"type":"string"},"number_of_assets":{"type":"number"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}}}}}]}}}}},"external_id":{"type":"string"},"isni":{"type":"string"},"uaid":{"type":"string"},"party_id":{"type":"string"},"spotify_artist_id":{"type":"string"},"apple_artist_id":{"type":"string"},"date_of_birth":{"type":"string"},"identifiers":{"title":"ArtistIdentifiers","description":"Additional industry identifiers. A type may appear more than once, e.g. several IPIs for one artist.","type":"array","items":{"title":"ArtistIdentifier","type":"object","required":["type","value"],"properties":{"type":{"title":"IdentifierType","description":"The kind of identifier, e.g. IPI, IPN, MBID. Common industry types are listed; identifiers specific to the delivering partner's system are accepted as free strings.","anyOf":[{"type":"string","enum":["IPI"]},{"type":"string","enum":["IPN"]},{"type":"string","enum":["MBID"]},{"type":"string","enum":["DISCOGS"]},{"type":"string","enum":["WIKIDATA"]},{"type":"string","enum":["AMAZON"]},{"type":"string","enum":["DEEZER"]},{"type":"string","enum":["SONGKICK"]},{"type":"string","enum":["INSTAGRAM"]},{"type":"string","enum":["TIKTOK"]},{"type":"string","enum":["YOUTUBE"]},{"minLength":1,"type":"string"}]},"value":{"minLength":1,"description":"The identifier value, exactly as the source holds it.","type":"string"}}}},"spotify_user_id":{"type":"string"},"spotify_display_name":{"type":"string"},"verified":{"type":"boolean"},"tutorial_completed_at":{"type":"number"},"terms_accepted_at":{"description":"When the profile first accepted the terms and conditions, in epoch milliseconds. Stamped by the server on the first acceptance and never moved by a later one.","type":"number"}}},{"title":"ArtistSpecificProfileData","type":"object","properties":{"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","allOf":[{"title":"ArtistCollectionRecord","type":"object","required":["collection_uuid","username","status"],"properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"ean":{"type":"string"},"grid":{"type":"string"},"project_id":{"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_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"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"},"artist_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"}}},{"title":"AttributionSetupResponse","type":"object","properties":{"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}}}}}}]}},"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"company_name":{"description":"The name of the company/record label associated with the artist.","type":"string"},"deal_territories":{"title":"DealTerritories","description":"Territories the delivering partner's deal with this party covers, as supplied by the partner. Descriptive only: it is not evaluated for permissions.","type":"array","items":{"type":"string"}},"related_artist_names":{"title":"RelatedArtistNames","description":"Names of recording artists this party is associated with, as supplied by the delivering partner. Plain strings for display and disambiguation, deliberately not resolved to profile records.","type":"array","items":{"type":"string"}},"lastEvaluatedKey":{"type":"string"}}},{"title":"ArtistOnlyProfileData","type":"object","properties":{"user_role":{"title":"ArtistOnlyRole","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["publisher"]}]}}}]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"BadRequestResponse","additionalProperties":true,"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string"},"message":{"type":"string"},"name":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ServiceUnavailableResponse","type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"number"},"error":{"type":"string"},"message":{"type":"string"}}}}}}}}},"/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","allOf":[{"title":"ArtistCollectionRecord","type":"object","required":["collection_uuid","username","status"],"properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"ean":{"type":"string"},"grid":{"type":"string"},"project_id":{"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_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"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"},"artist_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"}}},{"title":"AttributionSetupResponse","type":"object","properties":{"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}}}}}}]}},"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","allOf":[{"title":"ArtistCollectionRecordIntersection","type":"object","allOf":[{"title":"ArtistCollectionRecord","type":"object","required":["collection_uuid","username","status"],"properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"ean":{"type":"string"},"grid":{"type":"string"},"project_id":{"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_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"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"},"artist_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"}}},{"title":"AttributionSetupResponse","type":"object","properties":{"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}}}}}}]},{"title":"CollectionWithLyricsAndStems","type":"object","required":["stems","lyrics"],"properties":{"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","required":["filename","lyrics"],"properties":{"filename":{"type":"string"},"lyrics":{"type":"string"}}}}}}]}}}}}}},"/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":{"required":true,"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"},"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"},"ean":{"description":"The EAN-13 (International Article Number) that uniquely identifies the release/product. 13 digits.","pattern":"^[0-9]{13}$","type":"string"},"grid":{"description":"The GRid (Global Release Identifier), an 18-character identifier for the release, e.g. A1-2425G-ABC1234002-M. Hyphens are optional.","pattern":"^[A-Z0-9]{2}-?[A-Z0-9]{5}-?[A-Z0-9]{10}-?[A-Z0-9]$","type":"string"},"projectId":{"description":"The project ID of the release/product in the delivering partner's system.","type":"string"},"recordingStudio":{"description":"For music, you can set the recording studio.","type":"string"},"producer":{"description":"For music, you can set the producer.","type":"string"},"composer":{"description":"The individual who wrote the music (melody and harmony) of the song. A composer is a creative contributor on the publishing side.","type":"string"},"songWriter":{"description":"The individual who wrote the lyrics and melody of the song. A songwriter is a creative contributor on the publishing side.","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 (subsidiary imprint) under the parent label that released the song. Like a label, a sub-label is an organizational entity on the recording side.","type":"string"},"publisher":{"description":"The publishing company that administers the song's composition rights and royalties. A publisher is an organizational entity on the publishing side.","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"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}}}},"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","upc":"123456789012","ean":"4006381333931","grid":"A12425GABC1234002M","projectId":"PRJ-2026-000123","recordingStudio":"Abbey Road Studios","producer":"Rick Rubin","composer":"John Williams","songWriter":"Bob Dylan","rightsAdministrator":"ASCAP","rightsOwner":"Universal Music Group","subLabel":"Interscope Records","publisher":"Universal Music Publishing","originalCoverArt":"https://example.com/cover-art.jpg","aiInfluence":"AI refined","knowledgeAcquisitionRatio":0.1,"opt_in_rules":{"ai_company_scoped_consent":[{"ai_company_name":"Mirage","allow_ai_training":true}],"time_scoped_consent":{"start_timestamp":1770740622000,"end_timestamp":1773159822000},"no_attribution_greater_than":30,"no_attribution_smaller_than":5,"no_shared_attribution_with_artist":"Example artist","no_shared_attribution_with_genre":"Heavy Metal","allow_cover_art_in_motion_picture":true,"allow_lyrics":true}}}}},"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/{username}/settings":{"get":{"operationId":"getArtistSettingsByUsername","summary":"Get a roster artist's settings, for a label acting on their behalf","tags":["artist"],"parameters":[{"schema":{"minimum":1,"type":"integer"},"in":"query","name":"version","required":false,"description":"Return this exact historical snapshot instead of the newest one."},{"schema":{"type":"string"},"in":"path","name":"username","required":true,"description":"The artist whose settings are being addressed."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetArtistSettingsResponse","type":"object","required":["record_version","updated_at","settings"],"properties":{"record_version":{"description":"Cite this when recording why a decision was permitted; it identifies the exact snapshot.","type":"integer"},"updated_at":{"description":"Epoch milliseconds.","type":"integer"},"settings":{"title":"ArtistSettingsEnvelope","type":"object","required":["name_image_likeness"],"properties":{"name_image_likeness":{"title":"NameImageLikenessResponse","additionalProperties":false,"type":"object","required":["artist_id","styles","schema_version","consent","names","images","voice_recordings","videos","persona"],"properties":{"artist_id":{"minLength":1,"type":"string"},"isni":{"type":"string"},"styles":{"maxItems":100,"type":"array","items":{"title":"NilvStyle","additionalProperties":false,"type":"object","required":["id","name"],"properties":{"id":{"minLength":1,"description":"Stable id, e.g. 'style-002'.","type":"string"},"name":{"minLength":1,"description":"Human label, e.g. 'funk and retro soul revival era'.","type":"string"},"span":{"description":"Informal period, e.g. '2016-'.","type":"string"}}}},"sureel_party_uuid":{"type":"string"},"schema_version":{"minLength":1,"type":"string"},"consent":{"title":"NilvConsentResponse","additionalProperties":false,"type":"object","required":["default_decision","grants","revocations"],"properties":{"default_decision":{"title":"NilvDefaultDecisionResponse","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"grants":{"type":"array","items":{"title":"NilvGrantResponse","additionalProperties":false,"type":"object","required":["id","decision","scope","styles","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"NilvDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":5,"uniqueItems":true,"type":"array","items":{"title":"NilvScope","anyOf":[{"type":"string","enum":["name"]},{"type":"string","enum":["image"]},{"type":"string","enum":["voice"]},{"type":"string","enum":["video"]},{"type":"string","enum":["persona"]}]}},"styles":{"minItems":1,"maxItems":101,"uniqueItems":true,"type":"array","items":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}},"uses":{"maxItems":4,"uniqueItems":true,"description":"The finer-grained voice action, when the grant answers one of the dashboard's voice uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Every use is about the voice, so the grant's scope must include voice, or the write is refused with 422.","type":"array","items":{"title":"NilvAiUse","anyOf":[{"type":"string","enum":["voice_cover"]},{"type":"string","enum":["voice_translation_cover"]},{"type":"string","enum":["voice_create"]},{"type":"string","enum":["voice_create_filters"]}]}},"asset_refs":{"minItems":1,"maxItems":2001,"uniqueItems":true,"description":"Asset ids, or ['*'] for every asset in scope. A grant naming specific assets answers only questions that name one of them: it takes no part in a scope-wide question, meaning one sent without an asset_ref. That holds for a block as much as for an allow, so a scope-wide question can answer allow while a specific asset is blocked by a narrower grant, and the trace shows that grant as unmatched on asset_refs. Ask a per-asset question to get a per-asset answer.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"NilvAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":500,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"NilvGrantStatusResponse","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"NilvGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"NilvGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["rightsholder_rep"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"NilvEvidenceResponse","type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}},"revocations":{"type":"array","items":{"title":"NilvRevocation","additionalProperties":false,"type":"object","required":["grant_id","revoked_at","revoked_by","reason"],"properties":{"grant_id":{"type":"string"},"revoked_at":{"format":"date-time","type":"string"},"revoked_by":{"type":"string"},"revoked_by_username":{"minLength":1,"type":"string"},"reason":{"type":"string"}}}},"audit_log_ref":{"type":"string"}}},"names":{"maxItems":250,"type":"array","items":{"title":"NilvName","additionalProperties":false,"type":"object","required":["id","name","type","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"name":{"minLength":1,"type":"string"},"type":{"description":"e.g. 'stage/artist name', 'legal name'.","type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"images":{"maxItems":250,"type":"array","items":{"title":"NilvLabelledFileResponse","additionalProperties":false,"type":"object","required":["id","label","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"label":{"type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"storage_uri":{"description":"Permanent location, once ingested. Absent while ingestion is pending.","type":"string"},"ingest_state":{"title":"NilvIngestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["downloading"]},{"type":"string","enum":["stored"]},{"type":"string","enum":["duplicate"]},{"type":"string","enum":["checksum_mismatch"]},{"type":"string","enum":["failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]}}}},"voice_recordings":{"maxItems":250,"type":"array","items":{"title":"NilvLabelledFileResponse","additionalProperties":false,"type":"object","required":["id","label","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"label":{"type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"storage_uri":{"description":"Permanent location, once ingested. Absent while ingestion is pending.","type":"string"},"ingest_state":{"title":"NilvIngestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["downloading"]},{"type":"string","enum":["stored"]},{"type":"string","enum":["duplicate"]},{"type":"string","enum":["checksum_mismatch"]},{"type":"string","enum":["failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]}}}},"videos":{"maxItems":250,"type":"array","items":{"title":"NilvLabelledFileResponse","additionalProperties":false,"type":"object","required":["id","label","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"label":{"type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"storage_uri":{"description":"Permanent location, once ingested. Absent while ingestion is pending.","type":"string"},"ingest_state":{"title":"NilvIngestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["downloading"]},{"type":"string","enum":["stored"]},{"type":"string","enum":["duplicate"]},{"type":"string","enum":["checksum_mismatch"]},{"type":"string","enum":["failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]}}}},"persona":{"title":"NilvPersonaResponse","additionalProperties":false,"type":"object","properties":{"biography":{"title":"NilvBiography","additionalProperties":false,"type":"object","required":["biography"],"properties":{"biography":{"type":"string"}}},"genres":{"maxItems":250,"type":"array","items":{"title":"NilvGenre","additionalProperties":false,"type":"object","required":["id","genre","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"genre":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"social_handles":{"maxItems":250,"type":"array","items":{"title":"NilvSocialHandle","additionalProperties":false,"type":"object","required":["id","platform","handle","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"platform":{"type":"string"},"handle":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"brand_assets":{"maxItems":250,"type":"array","items":{"title":"NilvLabelledFileResponse","additionalProperties":false,"type":"object","required":["id","label","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"label":{"type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"storage_uri":{"description":"Permanent location, once ingested. Absent while ingestion is pending.","type":"string"},"ingest_state":{"title":"NilvIngestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["downloading"]},{"type":"string","enum":["stored"]},{"type":"string","enum":["duplicate"]},{"type":"string","enum":["checksum_mismatch"]},{"type":"string","enum":["failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]}}}},"linguistic_samples":{"maxItems":250,"type":"array","items":{"title":"NilvLinguisticSampleResponse","additionalProperties":false,"type":"object","required":["id","type","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"type":{"description":"e.g. 'interview transcript'.","type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"derived_from":{"description":"Source asset id, e.g. a voice_recordings entry a transcript came from. Recorded for provenance; consent is not yet inherited through it, so grant the transcript explicitly.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"storage_uri":{"description":"Permanent location, once ingested. Absent while ingestion is pending.","type":"string"},"ingest_state":{"title":"NilvIngestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["downloading"]},{"type":"string","enum":["stored"]},{"type":"string","enum":["duplicate"]},{"type":"string","enum":["checksum_mismatch"]},{"type":"string","enum":["failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]}}}}}}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}},"post":{"operationId":"saveArtistSettingsByUsername","summary":"Replace a roster artist's settings, for a label acting on their behalf","tags":["artist"],"description":"Grants are append-only: a submitted grant id that already exists must be unchanged, a grant that disappears is revoked, and a grant named in supersedes is retired. Nothing is ever deleted.","requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"PostArtistSettingsBody","additionalProperties":false,"type":"object","required":["name_image_likeness"],"properties":{"name_image_likeness":{"title":"NameImageLikenessInput","additionalProperties":false,"type":"object","required":["artist_id","styles","schema_version","consent","names","images","voice_recordings","videos","persona"],"properties":{"artist_id":{"minLength":1,"type":"string"},"isni":{"type":"string"},"styles":{"maxItems":100,"type":"array","items":{"title":"NilvStyle","additionalProperties":false,"type":"object","required":["id","name"],"properties":{"id":{"minLength":1,"description":"Stable id, e.g. 'style-002'.","type":"string"},"name":{"minLength":1,"description":"Human label, e.g. 'funk and retro soul revival era'.","type":"string"},"span":{"description":"Informal period, e.g. '2016-'.","type":"string"}}}},"schema_version":{"title":"NilvSchemaVersionInput","description":"Must be \"2026-07-30-v1\".","type":"string","enum":["2026-07-30-v1"]},"consent":{"title":"NilvConsentInput","additionalProperties":false,"type":"object","required":["default_decision","grants"],"properties":{"default_decision":{"title":"NilvDefaultDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"grants":{"maxItems":500,"type":"array","items":{"title":"NilvGrantInput","additionalProperties":false,"type":"object","required":["id","decision","scope","styles","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"NilvDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":5,"uniqueItems":true,"type":"array","items":{"title":"NilvScope","anyOf":[{"type":"string","enum":["name"]},{"type":"string","enum":["image"]},{"type":"string","enum":["voice"]},{"type":"string","enum":["video"]},{"type":"string","enum":["persona"]}]}},"styles":{"minItems":1,"maxItems":101,"uniqueItems":true,"type":"array","items":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}},"uses":{"maxItems":4,"uniqueItems":true,"description":"The finer-grained voice action, when the grant answers one of the dashboard's voice uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Every use is about the voice, so the grant's scope must include voice, or the write is refused with 422.","type":"array","items":{"title":"NilvAiUse","anyOf":[{"type":"string","enum":["voice_cover"]},{"type":"string","enum":["voice_translation_cover"]},{"type":"string","enum":["voice_create"]},{"type":"string","enum":["voice_create_filters"]}]}},"asset_refs":{"minItems":1,"maxItems":2001,"uniqueItems":true,"description":"Asset ids, or ['*'] for every asset in scope. A grant naming specific assets answers only questions that name one of them: it takes no part in a scope-wide question, meaning one sent without an asset_ref. That holds for a block as much as for an allow, so a scope-wide question can answer allow while a specific asset is blocked by a narrower grant, and the trace shows that grant as unmatched on asset_refs. Ask a per-asset question to get a per-asset answer.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"NilvAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":500,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"granted_by":{"title":"NilvGrantedByInput","additionalProperties":false,"type":"object","properties":{}},"evidence":{"anyOf":[{"title":"NilvEvidenceInput","additionalProperties":false,"type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}}}},"names":{"maxItems":250,"title":"NilvNamesInput","type":"array","items":{"title":"NilvName","additionalProperties":false,"type":"object","required":["id","name","type","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"name":{"minLength":1,"type":"string"},"type":{"description":"e.g. 'stage/artist name', 'legal name'.","type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"images":{"maxItems":250,"title":"NilvImagesInput","type":"array","items":{"title":"NilvLabelledFileInput","additionalProperties":false,"type":"object","required":["id","sha256","label","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"source_key":{"minLength":1,"description":"Staging key from POST /v1/ai/artist/settings/assets/upload-url, for content not yet ingested. Omit for content already registered under this artist.","type":"string"},"label":{"description":"e.g. 'press/promo photo'.","type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"voice_recordings":{"maxItems":250,"title":"NilvVoiceRecordingsInput","type":"array","items":{"title":"NilvLabelledFileInput","additionalProperties":false,"type":"object","required":["id","sha256","label","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"source_key":{"minLength":1,"description":"Staging key from POST /v1/ai/artist/settings/assets/upload-url, for content not yet ingested. Omit for content already registered under this artist.","type":"string"},"label":{"description":"e.g. 'press/promo photo'.","type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"videos":{"maxItems":250,"title":"NilvVideosInput","type":"array","items":{"title":"NilvLabelledFileInput","additionalProperties":false,"type":"object","required":["id","sha256","label","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"source_key":{"minLength":1,"description":"Staging key from POST /v1/ai/artist/settings/assets/upload-url, for content not yet ingested. Omit for content already registered under this artist.","type":"string"},"label":{"description":"e.g. 'press/promo photo'.","type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"persona":{"title":"NilvPersonaInput","additionalProperties":false,"type":"object","properties":{"biography":{"title":"NilvBiography","additionalProperties":false,"type":"object","required":["biography"],"properties":{"biography":{"type":"string"}}},"genres":{"maxItems":250,"type":"array","items":{"title":"NilvGenre","additionalProperties":false,"type":"object","required":["id","genre","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"genre":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"social_handles":{"maxItems":250,"type":"array","items":{"title":"NilvSocialHandle","additionalProperties":false,"type":"object","required":["id","platform","handle","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"platform":{"type":"string"},"handle":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"brand_assets":{"maxItems":250,"type":"array","items":{"title":"NilvLabelledFileInput","additionalProperties":false,"type":"object","required":["id","sha256","label","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"source_key":{"minLength":1,"description":"Staging key from POST /v1/ai/artist/settings/assets/upload-url, for content not yet ingested. Omit for content already registered under this artist.","type":"string"},"label":{"description":"e.g. 'press/promo photo'.","type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"linguistic_samples":{"maxItems":250,"type":"array","items":{"title":"NilvLinguisticSampleInput","additionalProperties":false,"type":"object","required":["id","type","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"type":{"description":"e.g. 'interview transcript'.","type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"derived_from":{"description":"Source asset id, e.g. a voice_recordings entry a transcript came from. Recorded for provenance; consent is not yet inherited through it, so grant the transcript explicitly.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"source_key":{"minLength":1,"description":"Staging key from POST /v1/ai/artist/settings/assets/upload-url, for content not yet ingested. Omit for content already registered under this artist.","type":"string"}}}}}}}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"username","required":true,"description":"The artist whose settings are being addressed."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"The record_version this edit was based on. Required once a record exists, so a concurrent write cannot be silently overwritten."},{"schema":{"type":"string"},"in":"header","name":"idempotency-key","required":false,"description":"Replaying the same key returns the existing version rather than creating a duplicate."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostArtistSettingsResponse","type":"object","required":["record_version","changes"],"properties":{"record_version":{"type":"integer"},"changes":{"title":"ArtistSettingsChanges","type":"object","required":["grants_added","grants_superseded","revocations_added"],"properties":{"grants_added":{"type":"array","items":{"type":"string"}},"grants_superseded":{"type":"array","items":{"type":"string"}},"revocations_added":{"type":"array","items":{"type":"string"}}}},"ingestion":{"title":"ArtistSettingsIngestionSummary","type":"object","required":["request_id","state","assets_pending"],"properties":{"request_id":{"description":"Poll GET /v1/ai/artist/settings/ingestion/{requestId} with this.","type":"string"},"state":{"title":"NilvIngestRequestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["in_progress"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["publish_failed"]}]},"assets_pending":{"minimum":0,"description":"How many distinct files were handed to the worker.","type":"integer"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsDuplicateError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"},"duplicate_of":{"type":"array","items":{"title":"NilvDuplicateAsset","type":"object","required":["asset_id","registered_as","sha256","reason"],"properties":{"asset_id":{"description":"The id in the submission.","type":"string"},"registered_as":{"description":"The ids these bytes are already filed under for this artist.","type":"array","items":{"type":"string"}},"sha256":{"type":"string"},"reason":{"title":"NilvDuplicateReason","anyOf":[{"type":"string","enum":["stored"]},{"type":"string","enum":["in_flight"]}]},"storage_uri":{"description":"Set when the existing copy is stored.","type":"string"},"request_id":{"description":"The request still working on it, when it is in flight.","type":"string"}}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}}},"/v1/ai/artist/{username}/settings/evaluate":{"post":{"operationId":"evaluateArtistSettingsByUsername","summary":"Ask what an artist's consent record permits for a given request","tags":["artist"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"EvaluateArtistSettingsBody","additionalProperties":false,"type":"object","required":["scope","style","ai_company","lifecycle_stage","purpose"],"properties":{"scope":{"title":"EvaluateScope","anyOf":[{"type":"string","enum":["name"]},{"type":"string","enum":["image"]},{"type":"string","enum":["voice"]},{"type":"string","enum":["video"]},{"type":"string","enum":["persona"]}]},"style":{"description":"A style id from the record, or '*' for any era.","type":"string"},"ai_company":{"type":"string"},"lifecycle_stage":{"title":"EvaluateLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]},"purpose":{"title":"EvaluatePurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]},"uses":{"title":"EvaluateNilvUse","anyOf":[{"type":"string","enum":["voice_cover"]},{"type":"string","enum":["voice_translation_cover"]},{"type":"string","enum":["voice_create"]},{"type":"string","enum":["voice_create_filters"]}]},"asset_ref":{"description":"Narrows the question to one asset. Omit to ask about the scope at large. A grant naming specific assets takes no part in a scope-wide question, so omitting this can answer allow while a named asset is blocked by a narrower grant.","type":"string"},"as_of":{"format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt].+([Zz]|[+-]\\d{2}:?\\d{2})$","description":"Evaluate validity windows as at this instant. Must carry an explicit UTC offset (e.g. 2026-07-01T00:30:00Z); an offset-less value is rejected, because resolving it in the server's local zone would make the verdict depend on where it ran. Defaults to now.","type":"string"},"record_version":{"minimum":1,"description":"Evaluate against this snapshot rather than the newest, to re-derive a verdict that was already issued.","type":"integer"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"username","required":true,"description":"The artist whose settings are being addressed."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"EvaluateArtistSettingsResponse","type":"object","required":["decision","via","record_version","algorithm_version","evaluated_at","matched_grant","trace"],"properties":{"decision":{"title":"EvaluateDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"via":{"description":"The deciding grant id, or 'default_decision'.","type":"string"},"record_version":{"type":"integer"},"algorithm_version":{"type":"string"},"evaluated_at":{"format":"date-time","description":"The instant validity windows were judged against. Returned so a verdict can be re-derived exactly, including when as_of was omitted and the server clock was used.","type":"string"},"matched_grant":{"anyOf":[{"title":"NilvGrantResponse","additionalProperties":false,"type":"object","required":["id","decision","scope","styles","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"NilvDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":5,"uniqueItems":true,"type":"array","items":{"title":"NilvScope","anyOf":[{"type":"string","enum":["name"]},{"type":"string","enum":["image"]},{"type":"string","enum":["voice"]},{"type":"string","enum":["video"]},{"type":"string","enum":["persona"]}]}},"styles":{"minItems":1,"maxItems":101,"uniqueItems":true,"type":"array","items":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}},"uses":{"maxItems":4,"uniqueItems":true,"description":"The finer-grained voice action, when the grant answers one of the dashboard's voice uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Every use is about the voice, so the grant's scope must include voice, or the write is refused with 422.","type":"array","items":{"title":"NilvAiUse","anyOf":[{"type":"string","enum":["voice_cover"]},{"type":"string","enum":["voice_translation_cover"]},{"type":"string","enum":["voice_create"]},{"type":"string","enum":["voice_create_filters"]}]}},"asset_refs":{"minItems":1,"maxItems":2001,"uniqueItems":true,"description":"Asset ids, or ['*'] for every asset in scope. A grant naming specific assets answers only questions that name one of them: it takes no part in a scope-wide question, meaning one sent without an asset_ref. That holds for a block as much as for an allow, so a scope-wide question can answer allow while a specific asset is blocked by a narrower grant, and the trace shows that grant as unmatched on asset_refs. Ask a per-asset question to get a per-asset answer.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"NilvAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":500,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"NilvGrantStatusResponse","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"NilvGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"NilvGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["rightsholder_rep"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"NilvEvidenceResponse","type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}},{"type":"null"}]},"trace":{"description":"Every grant considered and why it did or did not apply. This is what makes a verdict auditable.","type":"array","items":{"title":"EvaluateTraceEntry","type":"object","required":["grant_id","matched"],"properties":{"grant_id":{"type":"string"},"matched":{"type":"boolean"},"reason":{"type":"string"},"specificity":{"type":"integer"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}}},"/v1/ai/artist/{username}/settings/assets/upload-url":{"post":{"operationId":"createNilAssetUploadUrlByUsername","summary":"Get an upload URL for a roster artist's NILV asset, for a label acting on their behalf","tags":["artist"],"description":"The key is scoped to the artist named in the path, not to the caller. Without this a label could not supply assets on an artist's behalf at all.","requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"CreateNilAssetUploadUrlBody","additionalProperties":false,"type":"object","required":["extension"],"properties":{"extension":{"pattern":"^\\.[A-Za-z0-9]{1,8}$","description":"File extension including the dot, e.g. '.wav'. Must be accepted by at least one asset kind; the per-kind allowlist is applied again when the record cites the key.","type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"username","required":true,"description":"The artist whose settings are being addressed."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"CreateNilAssetUploadUrlResponse","type":"object","required":["source_key","upload_url","expires_at"],"properties":{"source_key":{"description":"Put this on the asset entry as source_key when submitting the record.","type":"string"},"upload_url":{"description":"Write-only, short-lived. PUT the bytes here before submitting the record.","type":"string"},"expires_at":{"format":"date-time","type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}}},"/v1/ai/artist/{username}/settings/music":{"get":{"operationId":"getMusicConsentByUsername","summary":"Get a roster party's music consent record, for a label or publisher acting on their behalf","tags":["artist"],"parameters":[{"schema":{"minimum":1,"type":"integer"},"in":"query","name":"version","required":false,"description":"Return this exact historical snapshot instead of the newest one."},{"schema":{"type":"string"},"in":"path","name":"username","required":true,"description":"The party (artist or songwriter) whose music consents are being addressed."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetMusicConsentResponse","type":"object","required":["layers","writable_layers"],"properties":{"record_version":{"description":"Cite this when recording why a decision was permitted; it identifies the exact snapshot. Absent until a record exists.","type":"integer"},"updated_at":{"description":"Epoch milliseconds.","type":"integer"},"layers":{"uniqueItems":true,"type":"array","items":{"title":"MusicLayerResponse","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"writable_layers":{"uniqueItems":true,"type":"array","items":{"title":"MusicWritableLayerResponse","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"settings":{"title":"MusicConsentEnvelope","type":"object","required":["music_consent"],"properties":{"music_consent":{"title":"MusicConsentRecord","additionalProperties":false,"type":"object","required":["party_id","schema_version","consent"],"properties":{"party_id":{"minLength":1,"type":"string"},"sureel_party_uuid":{"type":"string"},"schema_version":{"minLength":1,"type":"string"},"consent":{"title":"MusicConsent","additionalProperties":false,"type":"object","required":["default_decision","grants","revocations"],"properties":{"default_decision":{"title":"MusicDefaultDecisionStored","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"grants":{"type":"array","items":{"title":"MusicGrant","additionalProperties":false,"type":"object","required":["id","decision","scope","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"MusicDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":2,"uniqueItems":true,"description":"The track layers the grant covers: the recording (the master) and/or the publishing side (the work: composition and lyrics).","type":"array","items":{"title":"MusicScope","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"asset_refs":{"minItems":1,"maxItems":500,"uniqueItems":true,"description":"Catalog references, or ['*'] for the party's whole catalog. Party-level today; per-track references (ISRC/ISWC) are an intended later narrowing.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"description":"Training consent covers ['training']; derivative consent covers ['inference', 'output']. Stages, not the frontend's use labels, so finer-grained actions stay an additive change.","type":"array","items":{"title":"MusicLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"MusicAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"MusicPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"uses":{"maxItems":9,"uniqueItems":true,"description":"The finer-grained AI action, when the grant answers one of the dashboard's uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Each use belongs to one layer (remix_* to recording, song_* to publishing) and the grant's scope must cover it, or the write is refused with 422.","type":"array","items":{"title":"MusicAiUse","anyOf":[{"type":"string","enum":["remix_vocal_kept"]},{"type":"string","enum":["remix_different_voice"]},{"type":"string","enum":["remix_with_others"]},{"type":"string","enum":["remix_with_others_new_vocal"]},{"type":"string","enum":["remix_in_style"]},{"type":"string","enum":["song_remix"]},{"type":"string","enum":["song_translation"]},{"type":"string","enum":["song_lyric_changes"]},{"type":"string","enum":["song_lyric_changes_filters"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":200,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"MusicGrantStatus","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"MusicGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"MusicGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["publisher"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"MusicEvidence","additionalProperties":false,"type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}},"revocations":{"type":"array","items":{"title":"MusicRevocation","additionalProperties":false,"type":"object","required":["grant_id","revoked_at","revoked_by","reason"],"properties":{"grant_id":{"type":"string"},"revoked_at":{"format":"date-time","type":"string"},"revoked_by":{"type":"string"},"revoked_by_username":{"minLength":1,"type":"string"},"reason":{"type":"string"}}}}}}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}},"post":{"operationId":"saveMusicConsentByUsername","summary":"Replace a roster party's music consents, for a label or publisher acting on their behalf","tags":["artist"],"description":"A label may write for the recording layer of its roster artists; a publisher for the publishing layer of its songwriters. The append-only grant rules of the self-service route apply unchanged.","requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"PostMusicConsentBody","additionalProperties":false,"type":"object","required":["music_consent"],"properties":{"music_consent":{"title":"MusicConsentRecordInput","additionalProperties":false,"type":"object","required":["party_id","schema_version","consent"],"properties":{"party_id":{"minLength":1,"type":"string"},"schema_version":{"title":"MusicSchemaVersionInput","description":"Must be \"2026-08-12-v1\".","type":"string","enum":["2026-08-12-v1"]},"consent":{"title":"MusicConsentInput","additionalProperties":false,"type":"object","required":["default_decision","grants"],"properties":{"default_decision":{"title":"MusicDefaultDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"grants":{"maxItems":200,"type":"array","items":{"title":"MusicGrantInput","additionalProperties":false,"type":"object","required":["id","decision","scope","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"MusicDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":2,"uniqueItems":true,"description":"The track layers the grant covers: the recording (the master) and/or the publishing side (the work: composition and lyrics).","type":"array","items":{"title":"MusicScope","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"asset_refs":{"minItems":1,"maxItems":500,"uniqueItems":true,"description":"Catalog references, or ['*'] for the party's whole catalog. Party-level today; per-track references (ISRC/ISWC) are an intended later narrowing.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"description":"Training consent covers ['training']; derivative consent covers ['inference', 'output']. Stages, not the frontend's use labels, so finer-grained actions stay an additive change.","type":"array","items":{"title":"MusicLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"MusicAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"MusicPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"uses":{"maxItems":9,"uniqueItems":true,"description":"The finer-grained AI action, when the grant answers one of the dashboard's uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Each use belongs to one layer (remix_* to recording, song_* to publishing) and the grant's scope must cover it, or the write is refused with 422.","type":"array","items":{"title":"MusicAiUse","anyOf":[{"type":"string","enum":["remix_vocal_kept"]},{"type":"string","enum":["remix_different_voice"]},{"type":"string","enum":["remix_with_others"]},{"type":"string","enum":["remix_with_others_new_vocal"]},{"type":"string","enum":["remix_in_style"]},{"type":"string","enum":["song_remix"]},{"type":"string","enum":["song_translation"]},{"type":"string","enum":["song_lyric_changes"]},{"type":"string","enum":["song_lyric_changes_filters"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":200,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"granted_by":{"title":"MusicGrantedByInput","additionalProperties":false,"type":"object","properties":{}},"evidence":{"anyOf":[{"title":"MusicEvidenceInput","additionalProperties":false,"type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}}}}}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"username","required":true,"description":"The party (artist or songwriter) whose music consents are being addressed."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"The record_version this edit was based on. Required once a record exists, so a concurrent write cannot be silently overwritten."},{"schema":{"type":"string"},"in":"header","name":"idempotency-key","required":false,"description":"Replaying the same key returns the existing version rather than creating a duplicate."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostMusicConsentResponse","type":"object","required":["record_version","changes"],"properties":{"record_version":{"type":"integer"},"changes":{"title":"MusicConsentChanges","type":"object","required":["grants_added","grants_superseded","revocations_added"],"properties":{"grants_added":{"type":"array","items":{"type":"string"}},"grants_superseded":{"type":"array","items":{"type":"string"}},"revocations_added":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}}},"/v1/ai/artist/{username}/settings/music/evaluate":{"post":{"operationId":"evaluateMusicConsentByUsername","summary":"Ask what a party's music consent record permits for a given request","tags":["artist"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"EvaluateMusicConsentBody","additionalProperties":false,"type":"object","required":["scope","ai_company","lifecycle_stage","purpose"],"properties":{"scope":{"title":"EvaluateMusicScope","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]},"ai_company":{"type":"string"},"lifecycle_stage":{"title":"EvaluateMusicLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]},"purpose":{"title":"EvaluateMusicPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]},"uses":{"title":"EvaluateMusicUse","anyOf":[{"type":"string","enum":["remix_vocal_kept"]},{"type":"string","enum":["remix_different_voice"]},{"type":"string","enum":["remix_with_others"]},{"type":"string","enum":["remix_with_others_new_vocal"]},{"type":"string","enum":["remix_in_style"]},{"type":"string","enum":["song_remix"]},{"type":"string","enum":["song_translation"]},{"type":"string","enum":["song_lyric_changes"]},{"type":"string","enum":["song_lyric_changes_filters"]}]},"asset_ref":{"description":"Narrows the question to one catalog reference. Omit to ask about the party's catalog at large.","type":"string"},"as_of":{"format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt].+([Zz]|[+-]\\d{2}:?\\d{2})$","description":"Evaluate validity windows as at this instant. Must carry an explicit UTC offset; an offset-less value is rejected. Defaults to now.","type":"string"},"record_version":{"minimum":1,"description":"Evaluate against this snapshot rather than the newest, to re-derive a verdict that was already issued.","type":"integer"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"username","required":true,"description":"The party (artist or songwriter) whose music consents are being addressed."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"EvaluateMusicConsentResponse","type":"object","required":["decision","via","record_version","algorithm_version","evaluated_at","matched_grant","trace"],"properties":{"decision":{"title":"EvaluateMusicDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"via":{"description":"The deciding grant id, or 'default_decision'.","type":"string"},"record_version":{"type":"integer"},"algorithm_version":{"type":"string"},"evaluated_at":{"format":"date-time","type":"string"},"matched_grant":{"anyOf":[{"title":"MusicGrant","additionalProperties":false,"type":"object","required":["id","decision","scope","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"MusicDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":2,"uniqueItems":true,"description":"The track layers the grant covers: the recording (the master) and/or the publishing side (the work: composition and lyrics).","type":"array","items":{"title":"MusicScope","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"asset_refs":{"minItems":1,"maxItems":500,"uniqueItems":true,"description":"Catalog references, or ['*'] for the party's whole catalog. Party-level today; per-track references (ISRC/ISWC) are an intended later narrowing.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"description":"Training consent covers ['training']; derivative consent covers ['inference', 'output']. Stages, not the frontend's use labels, so finer-grained actions stay an additive change.","type":"array","items":{"title":"MusicLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"MusicAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"MusicPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"uses":{"maxItems":9,"uniqueItems":true,"description":"The finer-grained AI action, when the grant answers one of the dashboard's uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Each use belongs to one layer (remix_* to recording, song_* to publishing) and the grant's scope must cover it, or the write is refused with 422.","type":"array","items":{"title":"MusicAiUse","anyOf":[{"type":"string","enum":["remix_vocal_kept"]},{"type":"string","enum":["remix_different_voice"]},{"type":"string","enum":["remix_with_others"]},{"type":"string","enum":["remix_with_others_new_vocal"]},{"type":"string","enum":["remix_in_style"]},{"type":"string","enum":["song_remix"]},{"type":"string","enum":["song_translation"]},{"type":"string","enum":["song_lyric_changes"]},{"type":"string","enum":["song_lyric_changes_filters"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":200,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"MusicGrantStatus","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"MusicGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"MusicGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["publisher"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"MusicEvidence","additionalProperties":false,"type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}},{"type":"null"}]},"trace":{"type":"array","items":{"title":"EvaluateMusicTraceEntry","type":"object","required":["grant_id","matched"],"properties":{"grant_id":{"type":"string"},"matched":{"type":"boolean"},"reason":{"type":"string"},"specificity":{"type":"integer"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}}},"/v1/ai/artist/":{"get":{"operationId":"getAllArtists","summary":"Get all artists","tags":["artist"],"description":"Get a paginated list of artists on the public directory, including their published collections. Read a page at a time with `take` (default 20, at most 100) and resume the walk by passing the previous page's `lastEvaluatedKey` back as `cursor`. The body is an object, `{ artists, lastEvaluatedKey }`; `lastEvaluatedKey` is absent on the last page, and an empty directory is a 200 with an empty `artists` array. The optional `search` term matches an artist's username, a previous username, or their company name, and is served from the profile index alone: while that index is unavailable a searched read answers 503, an unsearched one starts again from DynamoDB, unordered, and a walk already resuming from an index cursor is refused rather than restarted. 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 return per page. Defaults to 20, at most 100."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"The optional `cursor` parameter is the `lastEvaluatedKey` from the previous page. Omit it to read the first page. A page in the middle of a walk can come back empty and still carry a cursor, so read on until a page comes back without one rather than stopping at the first empty page. A cursor belongs to the sort and the search it was issued under: handing it back with a different `sort_by`, `collection_search_value` or `search` is refused with 400."},{"schema":{"minLength":1,"maxLength":100,"type":"string"},"in":"query","name":"search","required":false,"description":"Filter the directory to artists matching this term, on their username, a previous username, or their company name. Served from the profile index alone: while that index is unavailable a searched read answers 503, because DynamoDB cannot match a name without answering a different question. Omit the parameter to read the whole directory: an empty term is refused, because it would otherwise be answered as an unsearched read whose cursor format the next request cannot carry."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetAllArtistsResponse","additionalProperties":false,"type":"object","required":["artists"],"properties":{"artists":{"title":"GetAllArtistsList","type":"array","items":{"title":"ArtistProfileData","type":"object","allOf":[{"title":"BaseProfileData","type":"object","required":["username"],"properties":{"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"auth0_id":{"type":"string"},"profile_picture_s3_key":{"type":"string"},"profile_picture_source":{"title":"ProfilePictureSource","anyOf":[{"type":"string","enum":["artist_photo"]},{"type":"string","enum":["promo_photo"]},{"type":"string","enum":["cover_art"]},{"type":"string","enum":["user_upload"]}]},"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":{"title":"UserRole","anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["ai_company"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["publisher"]}]},"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"},"publisher_name":{"type":"string"},"connected_publisher":{"type":"string"},"sureel_party_uuid":{"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"}},"signed_labels":{"title":"SignedLabels","type":"array","items":{"type":"string"}},"metrics":{"title":"Metrics","type":"object","required":["registry"],"properties":{"registry":{"title":"GetRegistryOptInOutMetricsResponse","type":"object","required":["optOutPercentage","optInPercentage","optOutAmount","optInAmount","numberOfReleases","numberOfAssets","rulesForOptIn"],"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":{"anyOf":[{"type":"string"},{"title":"OptInRulesForMetrics","type":"array","items":{"title":"OptInRulesForMetricsItem","type":"object","required":["collection_uuid","opt_in_rules"],"properties":{"collection_uuid":{"type":"string"},"collection_name":{"type":"string"},"username":{"type":"string"},"number_of_assets":{"type":"number"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}}}}}]}}}}},"external_id":{"type":"string"},"isni":{"type":"string"},"uaid":{"type":"string"},"party_id":{"type":"string"},"spotify_artist_id":{"type":"string"},"apple_artist_id":{"type":"string"},"date_of_birth":{"type":"string"},"identifiers":{"title":"ArtistIdentifiers","description":"Additional industry identifiers. A type may appear more than once, e.g. several IPIs for one artist.","type":"array","items":{"title":"ArtistIdentifier","type":"object","required":["type","value"],"properties":{"type":{"title":"IdentifierType","description":"The kind of identifier, e.g. IPI, IPN, MBID. Common industry types are listed; identifiers specific to the delivering partner's system are accepted as free strings.","anyOf":[{"type":"string","enum":["IPI"]},{"type":"string","enum":["IPN"]},{"type":"string","enum":["MBID"]},{"type":"string","enum":["DISCOGS"]},{"type":"string","enum":["WIKIDATA"]},{"type":"string","enum":["AMAZON"]},{"type":"string","enum":["DEEZER"]},{"type":"string","enum":["SONGKICK"]},{"type":"string","enum":["INSTAGRAM"]},{"type":"string","enum":["TIKTOK"]},{"type":"string","enum":["YOUTUBE"]},{"minLength":1,"type":"string"}]},"value":{"minLength":1,"description":"The identifier value, exactly as the source holds it.","type":"string"}}}},"spotify_user_id":{"type":"string"},"spotify_display_name":{"type":"string"},"verified":{"type":"boolean"},"tutorial_completed_at":{"type":"number"},"terms_accepted_at":{"description":"When the profile first accepted the terms and conditions, in epoch milliseconds. Stamped by the server on the first acceptance and never moved by a later one.","type":"number"}}},{"title":"ArtistSpecificProfileData","type":"object","properties":{"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","allOf":[{"title":"ArtistCollectionRecord","type":"object","required":["collection_uuid","username","status"],"properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"ean":{"type":"string"},"grid":{"type":"string"},"project_id":{"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_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"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"},"artist_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"}}},{"title":"AttributionSetupResponse","type":"object","properties":{"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}}}}}}]}},"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"company_name":{"description":"The name of the company/record label associated with the artist.","type":"string"},"deal_territories":{"title":"DealTerritories","description":"Territories the delivering partner's deal with this party covers, as supplied by the partner. Descriptive only: it is not evaluated for permissions.","type":"array","items":{"type":"string"}},"related_artist_names":{"title":"RelatedArtistNames","description":"Names of recording artists this party is associated with, as supplied by the delivering partner. Plain strings for display and disambiguation, deliberately not resolved to profile records.","type":"array","items":{"type":"string"}},"lastEvaluatedKey":{"type":"string"}}},{"title":"ArtistOnlyProfileData","type":"object","properties":{"user_role":{"title":"ArtistOnlyRole","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["publisher"]}]}}}]}},"lastEvaluatedKey":{"description":"Base64-encoded cursor for the next page. Absent when the walk is over.","type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"BadRequestResponse","additionalProperties":true,"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string"},"message":{"type":"string"},"name":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ServiceUnavailableResponse","type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"number"},"error":{"type":"string"},"message":{"type":"string"}}}}}}}}},"/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 return per page. Defaults to 20, at most 100."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"The optional `cursor` parameter is the `lastEvaluatedKey` from the previous page. Omit it to read the first page. A page in the middle of a walk can come back empty and still carry a cursor, so read on until a page comes back without one rather than stopping at the first empty page. A cursor belongs to the sort and the search it was issued under: handing it back with a different `sort_by`, `collection_search_value` or `search` is refused with 400."},{"schema":{"enum":["collection_name"],"type":"string"},"in":"query","name":"collection_search_field","required":false,"description":"Field to search collections by."},{"schema":{"maxLength":100,"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. Answered by the search index, so the request is refused with 503 while that index is unavailable."},{"schema":{"enum":["release_date","collection_name","number_of_assets","created_at","updated_at","upc","styles","ai_company_notifications.notifications_status","ai_company_notifications.number_of_contacted_ai_companies","use_for_training_timestamp"],"type":"string"},"in":"query","name":"sort_by","required":false,"description":"Specifies the sorting criteria. While the search index is unavailable, only release_date, collection_name and number_of_assets can be answered; the other fields are refused with 503."},{"schema":{"enum":["asc","desc"],"type":"string"},"in":"query","name":"sort_order","required":false,"description":"Specifies the sorting order, defaults to desc."},{"schema":{"pattern":"^(album|single|compilation|audio collection|image collection|video collection)(,(album|single|compilation|audio collection|image collection|video collection))*$","type":"string"},"examples":{"album":{"value":"album"},"single":{"value":"single"},"album,single,compilation":{"value":"album,single,compilation"}},"in":"query","name":"release_type","required":false,"description":"Filter collections by release type. Supports comma-separated values for multiple types (e.g. 'album,single'). Valid values: album, single, compilation, audio collection, image collection, video collection. Only the values ingestion writes are stored on a record and can therefore be filtered on: album, single, compilation. The remaining values (\"audio collection\", \"image collection\", \"video collection\") are derived at read time from a collection's assets and are not filterable yet: asking for one matches nothing."},{"schema":{"enum":["true","false"],"type":"string"},"in":"query","name":"use_for_training","required":false,"description":"Filter collections by their `use_for_training` flag."},{"schema":{"minLength":1,"type":"string"},"in":"path","name":"username","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistProfileData","type":"object","allOf":[{"title":"BaseProfileData","type":"object","required":["username"],"properties":{"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"auth0_id":{"type":"string"},"profile_picture_s3_key":{"type":"string"},"profile_picture_source":{"title":"ProfilePictureSource","anyOf":[{"type":"string","enum":["artist_photo"]},{"type":"string","enum":["promo_photo"]},{"type":"string","enum":["cover_art"]},{"type":"string","enum":["user_upload"]}]},"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":{"title":"UserRole","anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["ai_company"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["publisher"]}]},"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"},"publisher_name":{"type":"string"},"connected_publisher":{"type":"string"},"sureel_party_uuid":{"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"}},"signed_labels":{"title":"SignedLabels","type":"array","items":{"type":"string"}},"metrics":{"title":"Metrics","type":"object","required":["registry"],"properties":{"registry":{"title":"GetRegistryOptInOutMetricsResponse","type":"object","required":["optOutPercentage","optInPercentage","optOutAmount","optInAmount","numberOfReleases","numberOfAssets","rulesForOptIn"],"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":{"anyOf":[{"type":"string"},{"title":"OptInRulesForMetrics","type":"array","items":{"title":"OptInRulesForMetricsItem","type":"object","required":["collection_uuid","opt_in_rules"],"properties":{"collection_uuid":{"type":"string"},"collection_name":{"type":"string"},"username":{"type":"string"},"number_of_assets":{"type":"number"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}}}}}]}}}}},"external_id":{"type":"string"},"isni":{"type":"string"},"uaid":{"type":"string"},"party_id":{"type":"string"},"spotify_artist_id":{"type":"string"},"apple_artist_id":{"type":"string"},"date_of_birth":{"type":"string"},"identifiers":{"title":"ArtistIdentifiers","description":"Additional industry identifiers. A type may appear more than once, e.g. several IPIs for one artist.","type":"array","items":{"title":"ArtistIdentifier","type":"object","required":["type","value"],"properties":{"type":{"title":"IdentifierType","description":"The kind of identifier, e.g. IPI, IPN, MBID. Common industry types are listed; identifiers specific to the delivering partner's system are accepted as free strings.","anyOf":[{"type":"string","enum":["IPI"]},{"type":"string","enum":["IPN"]},{"type":"string","enum":["MBID"]},{"type":"string","enum":["DISCOGS"]},{"type":"string","enum":["WIKIDATA"]},{"type":"string","enum":["AMAZON"]},{"type":"string","enum":["DEEZER"]},{"type":"string","enum":["SONGKICK"]},{"type":"string","enum":["INSTAGRAM"]},{"type":"string","enum":["TIKTOK"]},{"type":"string","enum":["YOUTUBE"]},{"minLength":1,"type":"string"}]},"value":{"minLength":1,"description":"The identifier value, exactly as the source holds it.","type":"string"}}}},"spotify_user_id":{"type":"string"},"spotify_display_name":{"type":"string"},"verified":{"type":"boolean"},"tutorial_completed_at":{"type":"number"},"terms_accepted_at":{"description":"When the profile first accepted the terms and conditions, in epoch milliseconds. Stamped by the server on the first acceptance and never moved by a later one.","type":"number"}}},{"title":"ArtistSpecificProfileData","type":"object","properties":{"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","allOf":[{"title":"ArtistCollectionRecord","type":"object","required":["collection_uuid","username","status"],"properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"ean":{"type":"string"},"grid":{"type":"string"},"project_id":{"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_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"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"},"artist_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"}}},{"title":"AttributionSetupResponse","type":"object","properties":{"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}}}}}}]}},"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"company_name":{"description":"The name of the company/record label associated with the artist.","type":"string"},"deal_territories":{"title":"DealTerritories","description":"Territories the delivering partner's deal with this party covers, as supplied by the partner. Descriptive only: it is not evaluated for permissions.","type":"array","items":{"type":"string"}},"related_artist_names":{"title":"RelatedArtistNames","description":"Names of recording artists this party is associated with, as supplied by the delivering partner. Plain strings for display and disambiguation, deliberately not resolved to profile records.","type":"array","items":{"type":"string"}},"lastEvaluatedKey":{"type":"string"}}},{"title":"ArtistOnlyProfileData","type":"object","properties":{"user_role":{"title":"ArtistOnlyRole","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["publisher"]}]}}}]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"BadRequestResponse","additionalProperties":true,"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string"},"message":{"type":"string"},"name":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ServiceUnavailableResponse","type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"number"},"error":{"type":"string"},"message":{"type":"string"}}}}}}}}},"/v1/ai/artist/settings/":{"get":{"operationId":"getArtistSettings","summary":"Get an artist's settings, including their NILV consent record","tags":["artist"],"parameters":[{"schema":{"minimum":1,"type":"integer"},"in":"query","name":"version","required":false,"description":"Return this exact historical snapshot instead of the newest one."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetArtistSettingsResponse","type":"object","required":["record_version","updated_at","settings"],"properties":{"record_version":{"description":"Cite this when recording why a decision was permitted; it identifies the exact snapshot.","type":"integer"},"updated_at":{"description":"Epoch milliseconds.","type":"integer"},"settings":{"title":"ArtistSettingsEnvelope","type":"object","required":["name_image_likeness"],"properties":{"name_image_likeness":{"title":"NameImageLikenessResponse","additionalProperties":false,"type":"object","required":["artist_id","styles","schema_version","consent","names","images","voice_recordings","videos","persona"],"properties":{"artist_id":{"minLength":1,"type":"string"},"isni":{"type":"string"},"styles":{"maxItems":100,"type":"array","items":{"title":"NilvStyle","additionalProperties":false,"type":"object","required":["id","name"],"properties":{"id":{"minLength":1,"description":"Stable id, e.g. 'style-002'.","type":"string"},"name":{"minLength":1,"description":"Human label, e.g. 'funk and retro soul revival era'.","type":"string"},"span":{"description":"Informal period, e.g. '2016-'.","type":"string"}}}},"sureel_party_uuid":{"type":"string"},"schema_version":{"minLength":1,"type":"string"},"consent":{"title":"NilvConsentResponse","additionalProperties":false,"type":"object","required":["default_decision","grants","revocations"],"properties":{"default_decision":{"title":"NilvDefaultDecisionResponse","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"grants":{"type":"array","items":{"title":"NilvGrantResponse","additionalProperties":false,"type":"object","required":["id","decision","scope","styles","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"NilvDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":5,"uniqueItems":true,"type":"array","items":{"title":"NilvScope","anyOf":[{"type":"string","enum":["name"]},{"type":"string","enum":["image"]},{"type":"string","enum":["voice"]},{"type":"string","enum":["video"]},{"type":"string","enum":["persona"]}]}},"styles":{"minItems":1,"maxItems":101,"uniqueItems":true,"type":"array","items":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}},"uses":{"maxItems":4,"uniqueItems":true,"description":"The finer-grained voice action, when the grant answers one of the dashboard's voice uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Every use is about the voice, so the grant's scope must include voice, or the write is refused with 422.","type":"array","items":{"title":"NilvAiUse","anyOf":[{"type":"string","enum":["voice_cover"]},{"type":"string","enum":["voice_translation_cover"]},{"type":"string","enum":["voice_create"]},{"type":"string","enum":["voice_create_filters"]}]}},"asset_refs":{"minItems":1,"maxItems":2001,"uniqueItems":true,"description":"Asset ids, or ['*'] for every asset in scope. A grant naming specific assets answers only questions that name one of them: it takes no part in a scope-wide question, meaning one sent without an asset_ref. That holds for a block as much as for an allow, so a scope-wide question can answer allow while a specific asset is blocked by a narrower grant, and the trace shows that grant as unmatched on asset_refs. Ask a per-asset question to get a per-asset answer.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"NilvAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":500,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"NilvGrantStatusResponse","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"NilvGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"NilvGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["rightsholder_rep"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"NilvEvidenceResponse","type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}},"revocations":{"type":"array","items":{"title":"NilvRevocation","additionalProperties":false,"type":"object","required":["grant_id","revoked_at","revoked_by","reason"],"properties":{"grant_id":{"type":"string"},"revoked_at":{"format":"date-time","type":"string"},"revoked_by":{"type":"string"},"revoked_by_username":{"minLength":1,"type":"string"},"reason":{"type":"string"}}}},"audit_log_ref":{"type":"string"}}},"names":{"maxItems":250,"type":"array","items":{"title":"NilvName","additionalProperties":false,"type":"object","required":["id","name","type","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"name":{"minLength":1,"type":"string"},"type":{"description":"e.g. 'stage/artist name', 'legal name'.","type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"images":{"maxItems":250,"type":"array","items":{"title":"NilvLabelledFileResponse","additionalProperties":false,"type":"object","required":["id","label","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"label":{"type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"storage_uri":{"description":"Permanent location, once ingested. Absent while ingestion is pending.","type":"string"},"ingest_state":{"title":"NilvIngestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["downloading"]},{"type":"string","enum":["stored"]},{"type":"string","enum":["duplicate"]},{"type":"string","enum":["checksum_mismatch"]},{"type":"string","enum":["failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]}}}},"voice_recordings":{"maxItems":250,"type":"array","items":{"title":"NilvLabelledFileResponse","additionalProperties":false,"type":"object","required":["id","label","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"label":{"type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"storage_uri":{"description":"Permanent location, once ingested. Absent while ingestion is pending.","type":"string"},"ingest_state":{"title":"NilvIngestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["downloading"]},{"type":"string","enum":["stored"]},{"type":"string","enum":["duplicate"]},{"type":"string","enum":["checksum_mismatch"]},{"type":"string","enum":["failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]}}}},"videos":{"maxItems":250,"type":"array","items":{"title":"NilvLabelledFileResponse","additionalProperties":false,"type":"object","required":["id","label","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"label":{"type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"storage_uri":{"description":"Permanent location, once ingested. Absent while ingestion is pending.","type":"string"},"ingest_state":{"title":"NilvIngestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["downloading"]},{"type":"string","enum":["stored"]},{"type":"string","enum":["duplicate"]},{"type":"string","enum":["checksum_mismatch"]},{"type":"string","enum":["failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]}}}},"persona":{"title":"NilvPersonaResponse","additionalProperties":false,"type":"object","properties":{"biography":{"title":"NilvBiography","additionalProperties":false,"type":"object","required":["biography"],"properties":{"biography":{"type":"string"}}},"genres":{"maxItems":250,"type":"array","items":{"title":"NilvGenre","additionalProperties":false,"type":"object","required":["id","genre","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"genre":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"social_handles":{"maxItems":250,"type":"array","items":{"title":"NilvSocialHandle","additionalProperties":false,"type":"object","required":["id","platform","handle","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"platform":{"type":"string"},"handle":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"brand_assets":{"maxItems":250,"type":"array","items":{"title":"NilvLabelledFileResponse","additionalProperties":false,"type":"object","required":["id","label","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"label":{"type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"storage_uri":{"description":"Permanent location, once ingested. Absent while ingestion is pending.","type":"string"},"ingest_state":{"title":"NilvIngestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["downloading"]},{"type":"string","enum":["stored"]},{"type":"string","enum":["duplicate"]},{"type":"string","enum":["checksum_mismatch"]},{"type":"string","enum":["failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]}}}},"linguistic_samples":{"maxItems":250,"type":"array","items":{"title":"NilvLinguisticSampleResponse","additionalProperties":false,"type":"object","required":["id","type","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"type":{"description":"e.g. 'interview transcript'.","type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"derived_from":{"description":"Source asset id, e.g. a voice_recordings entry a transcript came from. Recorded for provenance; consent is not yet inherited through it, so grant the transcript explicitly.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"storage_uri":{"description":"Permanent location, once ingested. Absent while ingestion is pending.","type":"string"},"ingest_state":{"title":"NilvIngestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["downloading"]},{"type":"string","enum":["stored"]},{"type":"string","enum":["duplicate"]},{"type":"string","enum":["checksum_mismatch"]},{"type":"string","enum":["failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]}}}}}}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}},"post":{"operationId":"saveArtistSettings","summary":"Replace an artist's settings, appending a new consent version","tags":["artist"],"description":"Grants are append-only: a submitted grant id that already exists must be unchanged, a grant that disappears is revoked, and a grant named in supersedes is retired. Nothing is ever deleted.","requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"PostArtistSettingsBody","additionalProperties":false,"type":"object","required":["name_image_likeness"],"properties":{"name_image_likeness":{"title":"NameImageLikenessInput","additionalProperties":false,"type":"object","required":["artist_id","styles","schema_version","consent","names","images","voice_recordings","videos","persona"],"properties":{"artist_id":{"minLength":1,"type":"string"},"isni":{"type":"string"},"styles":{"maxItems":100,"type":"array","items":{"title":"NilvStyle","additionalProperties":false,"type":"object","required":["id","name"],"properties":{"id":{"minLength":1,"description":"Stable id, e.g. 'style-002'.","type":"string"},"name":{"minLength":1,"description":"Human label, e.g. 'funk and retro soul revival era'.","type":"string"},"span":{"description":"Informal period, e.g. '2016-'.","type":"string"}}}},"schema_version":{"title":"NilvSchemaVersionInput","description":"Must be \"2026-07-30-v1\".","type":"string","enum":["2026-07-30-v1"]},"consent":{"title":"NilvConsentInput","additionalProperties":false,"type":"object","required":["default_decision","grants"],"properties":{"default_decision":{"title":"NilvDefaultDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"grants":{"maxItems":500,"type":"array","items":{"title":"NilvGrantInput","additionalProperties":false,"type":"object","required":["id","decision","scope","styles","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"NilvDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":5,"uniqueItems":true,"type":"array","items":{"title":"NilvScope","anyOf":[{"type":"string","enum":["name"]},{"type":"string","enum":["image"]},{"type":"string","enum":["voice"]},{"type":"string","enum":["video"]},{"type":"string","enum":["persona"]}]}},"styles":{"minItems":1,"maxItems":101,"uniqueItems":true,"type":"array","items":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}},"uses":{"maxItems":4,"uniqueItems":true,"description":"The finer-grained voice action, when the grant answers one of the dashboard's voice uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Every use is about the voice, so the grant's scope must include voice, or the write is refused with 422.","type":"array","items":{"title":"NilvAiUse","anyOf":[{"type":"string","enum":["voice_cover"]},{"type":"string","enum":["voice_translation_cover"]},{"type":"string","enum":["voice_create"]},{"type":"string","enum":["voice_create_filters"]}]}},"asset_refs":{"minItems":1,"maxItems":2001,"uniqueItems":true,"description":"Asset ids, or ['*'] for every asset in scope. A grant naming specific assets answers only questions that name one of them: it takes no part in a scope-wide question, meaning one sent without an asset_ref. That holds for a block as much as for an allow, so a scope-wide question can answer allow while a specific asset is blocked by a narrower grant, and the trace shows that grant as unmatched on asset_refs. Ask a per-asset question to get a per-asset answer.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"NilvAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":500,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"granted_by":{"title":"NilvGrantedByInput","additionalProperties":false,"type":"object","properties":{}},"evidence":{"anyOf":[{"title":"NilvEvidenceInput","additionalProperties":false,"type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}}}},"names":{"maxItems":250,"title":"NilvNamesInput","type":"array","items":{"title":"NilvName","additionalProperties":false,"type":"object","required":["id","name","type","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"name":{"minLength":1,"type":"string"},"type":{"description":"e.g. 'stage/artist name', 'legal name'.","type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"images":{"maxItems":250,"title":"NilvImagesInput","type":"array","items":{"title":"NilvLabelledFileInput","additionalProperties":false,"type":"object","required":["id","sha256","label","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"source_key":{"minLength":1,"description":"Staging key from POST /v1/ai/artist/settings/assets/upload-url, for content not yet ingested. Omit for content already registered under this artist.","type":"string"},"label":{"description":"e.g. 'press/promo photo'.","type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"voice_recordings":{"maxItems":250,"title":"NilvVoiceRecordingsInput","type":"array","items":{"title":"NilvLabelledFileInput","additionalProperties":false,"type":"object","required":["id","sha256","label","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"source_key":{"minLength":1,"description":"Staging key from POST /v1/ai/artist/settings/assets/upload-url, for content not yet ingested. Omit for content already registered under this artist.","type":"string"},"label":{"description":"e.g. 'press/promo photo'.","type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"videos":{"maxItems":250,"title":"NilvVideosInput","type":"array","items":{"title":"NilvLabelledFileInput","additionalProperties":false,"type":"object","required":["id","sha256","label","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"source_key":{"minLength":1,"description":"Staging key from POST /v1/ai/artist/settings/assets/upload-url, for content not yet ingested. Omit for content already registered under this artist.","type":"string"},"label":{"description":"e.g. 'press/promo photo'.","type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"persona":{"title":"NilvPersonaInput","additionalProperties":false,"type":"object","properties":{"biography":{"title":"NilvBiography","additionalProperties":false,"type":"object","required":["biography"],"properties":{"biography":{"type":"string"}}},"genres":{"maxItems":250,"type":"array","items":{"title":"NilvGenre","additionalProperties":false,"type":"object","required":["id","genre","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"genre":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"social_handles":{"maxItems":250,"type":"array","items":{"title":"NilvSocialHandle","additionalProperties":false,"type":"object","required":["id","platform","handle","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"platform":{"type":"string"},"handle":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"brand_assets":{"maxItems":250,"type":"array","items":{"title":"NilvLabelledFileInput","additionalProperties":false,"type":"object","required":["id","sha256","label","style"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"source_key":{"minLength":1,"description":"Staging key from POST /v1/ai/artist/settings/assets/upload-url, for content not yet ingested. Omit for content already registered under this artist.","type":"string"},"label":{"description":"e.g. 'press/promo photo'.","type":"string"},"title":{"type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}}}},"linguistic_samples":{"maxItems":250,"type":"array","items":{"title":"NilvLinguisticSampleInput","additionalProperties":false,"type":"object","required":["id","type","style","sha256"],"properties":{"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Stable id. Grants, detections and licences reference it. Letters, digits, hyphen and underscore, up to 64 characters.","type":"string"},"type":{"description":"e.g. 'interview transcript'.","type":"string"},"style":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"},"derived_from":{"description":"Source asset id, e.g. a voice_recordings entry a transcript came from. Recorded for provenance; consent is not yet inherited through it, so grant the transcript explicitly.","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","description":"Lowercase hex SHA-256 of the file's bytes. Identifies the asset's content. Compute it client-side (SubtleCrypto in a browser).","type":"string"},"source_key":{"minLength":1,"description":"Staging key from POST /v1/ai/artist/settings/assets/upload-url, for content not yet ingested. Omit for content already registered under this artist.","type":"string"}}}}}}}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"The record_version this edit was based on. Required once a record exists, so a concurrent write cannot be silently overwritten."},{"schema":{"type":"string"},"in":"header","name":"idempotency-key","required":false,"description":"Replaying the same key returns the existing version rather than creating a duplicate."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostArtistSettingsResponse","type":"object","required":["record_version","changes"],"properties":{"record_version":{"type":"integer"},"changes":{"title":"ArtistSettingsChanges","type":"object","required":["grants_added","grants_superseded","revocations_added"],"properties":{"grants_added":{"type":"array","items":{"type":"string"}},"grants_superseded":{"type":"array","items":{"type":"string"}},"revocations_added":{"type":"array","items":{"type":"string"}}}},"ingestion":{"title":"ArtistSettingsIngestionSummary","type":"object","required":["request_id","state","assets_pending"],"properties":{"request_id":{"description":"Poll GET /v1/ai/artist/settings/ingestion/{requestId} with this.","type":"string"},"state":{"title":"NilvIngestRequestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["in_progress"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["publish_failed"]}]},"assets_pending":{"minimum":0,"description":"How many distinct files were handed to the worker.","type":"integer"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsDuplicateError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"},"duplicate_of":{"type":"array","items":{"title":"NilvDuplicateAsset","type":"object","required":["asset_id","registered_as","sha256","reason"],"properties":{"asset_id":{"description":"The id in the submission.","type":"string"},"registered_as":{"description":"The ids these bytes are already filed under for this artist.","type":"array","items":{"type":"string"}},"sha256":{"type":"string"},"reason":{"title":"NilvDuplicateReason","anyOf":[{"type":"string","enum":["stored"]},{"type":"string","enum":["in_flight"]}]},"storage_uri":{"description":"Set when the existing copy is stored.","type":"string"},"request_id":{"description":"The request still working on it, when it is in flight.","type":"string"}}}}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}}},"/v1/ai/artist/settings/evaluate":{"post":{"operationId":"evaluateArtistSettings","summary":"Ask what an artist's consent record permits for a given request","tags":["artist"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"EvaluateArtistSettingsBody","additionalProperties":false,"type":"object","required":["scope","style","ai_company","lifecycle_stage","purpose"],"properties":{"scope":{"title":"EvaluateScope","anyOf":[{"type":"string","enum":["name"]},{"type":"string","enum":["image"]},{"type":"string","enum":["voice"]},{"type":"string","enum":["video"]},{"type":"string","enum":["persona"]}]},"style":{"description":"A style id from the record, or '*' for any era.","type":"string"},"ai_company":{"type":"string"},"lifecycle_stage":{"title":"EvaluateLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]},"purpose":{"title":"EvaluatePurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]},"uses":{"title":"EvaluateNilvUse","anyOf":[{"type":"string","enum":["voice_cover"]},{"type":"string","enum":["voice_translation_cover"]},{"type":"string","enum":["voice_create"]},{"type":"string","enum":["voice_create_filters"]}]},"asset_ref":{"description":"Narrows the question to one asset. Omit to ask about the scope at large. A grant naming specific assets takes no part in a scope-wide question, so omitting this can answer allow while a named asset is blocked by a narrower grant.","type":"string"},"as_of":{"format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt].+([Zz]|[+-]\\d{2}:?\\d{2})$","description":"Evaluate validity windows as at this instant. Must carry an explicit UTC offset (e.g. 2026-07-01T00:30:00Z); an offset-less value is rejected, because resolving it in the server's local zone would make the verdict depend on where it ran. Defaults to now.","type":"string"},"record_version":{"minimum":1,"description":"Evaluate against this snapshot rather than the newest, to re-derive a verdict that was already issued.","type":"integer"}}}}}},"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"EvaluateArtistSettingsResponse","type":"object","required":["decision","via","record_version","algorithm_version","evaluated_at","matched_grant","trace"],"properties":{"decision":{"title":"EvaluateDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"via":{"description":"The deciding grant id, or 'default_decision'.","type":"string"},"record_version":{"type":"integer"},"algorithm_version":{"type":"string"},"evaluated_at":{"format":"date-time","description":"The instant validity windows were judged against. Returned so a verdict can be re-derived exactly, including when as_of was omitted and the server clock was used.","type":"string"},"matched_grant":{"anyOf":[{"title":"NilvGrantResponse","additionalProperties":false,"type":"object","required":["id","decision","scope","styles","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"NilvDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":5,"uniqueItems":true,"type":"array","items":{"title":"NilvScope","anyOf":[{"type":"string","enum":["name"]},{"type":"string","enum":["image"]},{"type":"string","enum":["voice"]},{"type":"string","enum":["video"]},{"type":"string","enum":["persona"]}]}},"styles":{"minItems":1,"maxItems":101,"uniqueItems":true,"type":"array","items":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}},"uses":{"maxItems":4,"uniqueItems":true,"description":"The finer-grained voice action, when the grant answers one of the dashboard's voice uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Every use is about the voice, so the grant's scope must include voice, or the write is refused with 422.","type":"array","items":{"title":"NilvAiUse","anyOf":[{"type":"string","enum":["voice_cover"]},{"type":"string","enum":["voice_translation_cover"]},{"type":"string","enum":["voice_create"]},{"type":"string","enum":["voice_create_filters"]}]}},"asset_refs":{"minItems":1,"maxItems":2001,"uniqueItems":true,"description":"Asset ids, or ['*'] for every asset in scope. A grant naming specific assets answers only questions that name one of them: it takes no part in a scope-wide question, meaning one sent without an asset_ref. That holds for a block as much as for an allow, so a scope-wide question can answer allow while a specific asset is blocked by a narrower grant, and the trace shows that grant as unmatched on asset_refs. Ask a per-asset question to get a per-asset answer.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"NilvAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":500,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"NilvGrantStatusResponse","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"NilvGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"NilvGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["rightsholder_rep"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"NilvEvidenceResponse","type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}},{"type":"null"}]},"trace":{"description":"Every grant considered and why it did or did not apply. This is what makes a verdict auditable.","type":"array","items":{"title":"EvaluateTraceEntry","type":"object","required":["grant_id","matched"],"properties":{"grant_id":{"type":"string"},"matched":{"type":"boolean"},"reason":{"type":"string"},"specificity":{"type":"integer"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}}},"/v1/ai/artist/settings/music":{"get":{"operationId":"getMusicConsent","summary":"Get a party's music consent record: what AI may do with their recordings and works","tags":["artist"],"parameters":[{"schema":{"minimum":1,"type":"integer"},"in":"query","name":"version","required":false,"description":"Return this exact historical snapshot instead of the newest one."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"GetMusicConsentResponse","type":"object","required":["layers","writable_layers"],"properties":{"record_version":{"description":"Cite this when recording why a decision was permitted; it identifies the exact snapshot. Absent until a record exists.","type":"integer"},"updated_at":{"description":"Epoch milliseconds.","type":"integer"},"layers":{"uniqueItems":true,"type":"array","items":{"title":"MusicLayerResponse","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"writable_layers":{"uniqueItems":true,"type":"array","items":{"title":"MusicWritableLayerResponse","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"settings":{"title":"MusicConsentEnvelope","type":"object","required":["music_consent"],"properties":{"music_consent":{"title":"MusicConsentRecord","additionalProperties":false,"type":"object","required":["party_id","schema_version","consent"],"properties":{"party_id":{"minLength":1,"type":"string"},"sureel_party_uuid":{"type":"string"},"schema_version":{"minLength":1,"type":"string"},"consent":{"title":"MusicConsent","additionalProperties":false,"type":"object","required":["default_decision","grants","revocations"],"properties":{"default_decision":{"title":"MusicDefaultDecisionStored","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"grants":{"type":"array","items":{"title":"MusicGrant","additionalProperties":false,"type":"object","required":["id","decision","scope","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"MusicDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":2,"uniqueItems":true,"description":"The track layers the grant covers: the recording (the master) and/or the publishing side (the work: composition and lyrics).","type":"array","items":{"title":"MusicScope","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"asset_refs":{"minItems":1,"maxItems":500,"uniqueItems":true,"description":"Catalog references, or ['*'] for the party's whole catalog. Party-level today; per-track references (ISRC/ISWC) are an intended later narrowing.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"description":"Training consent covers ['training']; derivative consent covers ['inference', 'output']. Stages, not the frontend's use labels, so finer-grained actions stay an additive change.","type":"array","items":{"title":"MusicLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"MusicAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"MusicPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"uses":{"maxItems":9,"uniqueItems":true,"description":"The finer-grained AI action, when the grant answers one of the dashboard's uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Each use belongs to one layer (remix_* to recording, song_* to publishing) and the grant's scope must cover it, or the write is refused with 422.","type":"array","items":{"title":"MusicAiUse","anyOf":[{"type":"string","enum":["remix_vocal_kept"]},{"type":"string","enum":["remix_different_voice"]},{"type":"string","enum":["remix_with_others"]},{"type":"string","enum":["remix_with_others_new_vocal"]},{"type":"string","enum":["remix_in_style"]},{"type":"string","enum":["song_remix"]},{"type":"string","enum":["song_translation"]},{"type":"string","enum":["song_lyric_changes"]},{"type":"string","enum":["song_lyric_changes_filters"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":200,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"MusicGrantStatus","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"MusicGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"MusicGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["publisher"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"MusicEvidence","additionalProperties":false,"type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}},"revocations":{"type":"array","items":{"title":"MusicRevocation","additionalProperties":false,"type":"object","required":["grant_id","revoked_at","revoked_by","reason"],"properties":{"grant_id":{"type":"string"},"revoked_at":{"format":"date-time","type":"string"},"revoked_by":{"type":"string"},"revoked_by_username":{"minLength":1,"type":"string"},"reason":{"type":"string"}}}}}}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}},"post":{"operationId":"saveMusicConsent","summary":"Replace a party's music consents, appending a new consent version","tags":["artist"],"description":"Grants are append-only: a submitted grant id that already exists must be unchanged, a grant that disappears is revoked, and a grant named in supersedes is retired. Nothing is ever deleted. Grants covering the recording layer require the party to be a recording artist; the publishing layer requires a songwriter; a singer-songwriter writes both.","requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"PostMusicConsentBody","additionalProperties":false,"type":"object","required":["music_consent"],"properties":{"music_consent":{"title":"MusicConsentRecordInput","additionalProperties":false,"type":"object","required":["party_id","schema_version","consent"],"properties":{"party_id":{"minLength":1,"type":"string"},"schema_version":{"title":"MusicSchemaVersionInput","description":"Must be \"2026-08-12-v1\".","type":"string","enum":["2026-08-12-v1"]},"consent":{"title":"MusicConsentInput","additionalProperties":false,"type":"object","required":["default_decision","grants"],"properties":{"default_decision":{"title":"MusicDefaultDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"grants":{"maxItems":200,"type":"array","items":{"title":"MusicGrantInput","additionalProperties":false,"type":"object","required":["id","decision","scope","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"MusicDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":2,"uniqueItems":true,"description":"The track layers the grant covers: the recording (the master) and/or the publishing side (the work: composition and lyrics).","type":"array","items":{"title":"MusicScope","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"asset_refs":{"minItems":1,"maxItems":500,"uniqueItems":true,"description":"Catalog references, or ['*'] for the party's whole catalog. Party-level today; per-track references (ISRC/ISWC) are an intended later narrowing.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"description":"Training consent covers ['training']; derivative consent covers ['inference', 'output']. Stages, not the frontend's use labels, so finer-grained actions stay an additive change.","type":"array","items":{"title":"MusicLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"MusicAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"MusicPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"uses":{"maxItems":9,"uniqueItems":true,"description":"The finer-grained AI action, when the grant answers one of the dashboard's uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Each use belongs to one layer (remix_* to recording, song_* to publishing) and the grant's scope must cover it, or the write is refused with 422.","type":"array","items":{"title":"MusicAiUse","anyOf":[{"type":"string","enum":["remix_vocal_kept"]},{"type":"string","enum":["remix_different_voice"]},{"type":"string","enum":["remix_with_others"]},{"type":"string","enum":["remix_with_others_new_vocal"]},{"type":"string","enum":["remix_in_style"]},{"type":"string","enum":["song_remix"]},{"type":"string","enum":["song_translation"]},{"type":"string","enum":["song_lyric_changes"]},{"type":"string","enum":["song_lyric_changes_filters"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":200,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"granted_by":{"title":"MusicGrantedByInput","additionalProperties":false,"type":"object","properties":{}},"evidence":{"anyOf":[{"title":"MusicEvidenceInput","additionalProperties":false,"type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}}}}}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"The record_version this edit was based on. Required once a record exists, so a concurrent write cannot be silently overwritten."},{"schema":{"type":"string"},"in":"header","name":"idempotency-key","required":false,"description":"Replaying the same key returns the existing version rather than creating a duplicate."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostMusicConsentResponse","type":"object","required":["record_version","changes"],"properties":{"record_version":{"type":"integer"},"changes":{"title":"MusicConsentChanges","type":"object","required":["grants_added","grants_superseded","revocations_added"],"properties":{"grants_added":{"type":"array","items":{"type":"string"}},"grants_superseded":{"type":"array","items":{"type":"string"}},"revocations_added":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}}},"/v1/ai/artist/settings/music/evaluate":{"post":{"operationId":"evaluateMusicConsent","summary":"Ask what a party's music consent record permits for a given request","tags":["artist"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"EvaluateMusicConsentBody","additionalProperties":false,"type":"object","required":["scope","ai_company","lifecycle_stage","purpose"],"properties":{"scope":{"title":"EvaluateMusicScope","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]},"ai_company":{"type":"string"},"lifecycle_stage":{"title":"EvaluateMusicLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]},"purpose":{"title":"EvaluateMusicPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]},"uses":{"title":"EvaluateMusicUse","anyOf":[{"type":"string","enum":["remix_vocal_kept"]},{"type":"string","enum":["remix_different_voice"]},{"type":"string","enum":["remix_with_others"]},{"type":"string","enum":["remix_with_others_new_vocal"]},{"type":"string","enum":["remix_in_style"]},{"type":"string","enum":["song_remix"]},{"type":"string","enum":["song_translation"]},{"type":"string","enum":["song_lyric_changes"]},{"type":"string","enum":["song_lyric_changes_filters"]}]},"asset_ref":{"description":"Narrows the question to one catalog reference. Omit to ask about the party's catalog at large.","type":"string"},"as_of":{"format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}[Tt].+([Zz]|[+-]\\d{2}:?\\d{2})$","description":"Evaluate validity windows as at this instant. Must carry an explicit UTC offset; an offset-less value is rejected. Defaults to now.","type":"string"},"record_version":{"minimum":1,"description":"Evaluate against this snapshot rather than the newest, to re-derive a verdict that was already issued.","type":"integer"}}}}}},"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"EvaluateMusicConsentResponse","type":"object","required":["decision","via","record_version","algorithm_version","evaluated_at","matched_grant","trace"],"properties":{"decision":{"title":"EvaluateMusicDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"via":{"description":"The deciding grant id, or 'default_decision'.","type":"string"},"record_version":{"type":"integer"},"algorithm_version":{"type":"string"},"evaluated_at":{"format":"date-time","type":"string"},"matched_grant":{"anyOf":[{"title":"MusicGrant","additionalProperties":false,"type":"object","required":["id","decision","scope","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"MusicDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":2,"uniqueItems":true,"description":"The track layers the grant covers: the recording (the master) and/or the publishing side (the work: composition and lyrics).","type":"array","items":{"title":"MusicScope","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"asset_refs":{"minItems":1,"maxItems":500,"uniqueItems":true,"description":"Catalog references, or ['*'] for the party's whole catalog. Party-level today; per-track references (ISRC/ISWC) are an intended later narrowing.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"description":"Training consent covers ['training']; derivative consent covers ['inference', 'output']. Stages, not the frontend's use labels, so finer-grained actions stay an additive change.","type":"array","items":{"title":"MusicLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"MusicAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"MusicPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"uses":{"maxItems":9,"uniqueItems":true,"description":"The finer-grained AI action, when the grant answers one of the dashboard's uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Each use belongs to one layer (remix_* to recording, song_* to publishing) and the grant's scope must cover it, or the write is refused with 422.","type":"array","items":{"title":"MusicAiUse","anyOf":[{"type":"string","enum":["remix_vocal_kept"]},{"type":"string","enum":["remix_different_voice"]},{"type":"string","enum":["remix_with_others"]},{"type":"string","enum":["remix_with_others_new_vocal"]},{"type":"string","enum":["remix_in_style"]},{"type":"string","enum":["song_remix"]},{"type":"string","enum":["song_translation"]},{"type":"string","enum":["song_lyric_changes"]},{"type":"string","enum":["song_lyric_changes_filters"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":200,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"MusicGrantStatus","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"MusicGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"MusicGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["publisher"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"MusicEvidence","additionalProperties":false,"type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}},{"type":"null"}]},"trace":{"type":"array","items":{"title":"EvaluateMusicTraceEntry","type":"object","required":["grant_id","matched"],"properties":{"grant_id":{"type":"string"},"matched":{"type":"boolean"},"reason":{"type":"string"},"specificity":{"type":"integer"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"MusicConsentError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}}},"/v1/ai/artist/settings/assets/upload-url":{"post":{"operationId":"createNilAssetUploadUrl","summary":"Get a short-lived URL for uploading a NILV asset","tags":["artist"],"description":"The key is generated by the server; a client never chooses one. Upload the bytes, compute their SHA-256, then submit the record with both.","requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"CreateNilAssetUploadUrlBody","additionalProperties":false,"type":"object","required":["extension"],"properties":{"extension":{"pattern":"^\\.[A-Za-z0-9]{1,8}$","description":"File extension including the dot, e.g. '.wav'. Must be accepted by at least one asset kind; the per-kind allowlist is applied again when the record cites the key.","type":"string"}}}}}},"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"CreateNilAssetUploadUrlResponse","type":"object","required":["source_key","upload_url","expires_at"],"properties":{"source_key":{"description":"Put this on the asset entry as source_key when submitting the record.","type":"string"},"upload_url":{"description":"Write-only, short-lived. PUT the bytes here before submitting the record.","type":"string"},"expires_at":{"format":"date-time","type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}}},"/v1/ai/artist/settings/ingestion/{requestId}":{"get":{"operationId":"getNilIngestionStatus","summary":"Check how ingestion of a settings submission's assets is going","tags":["artist"],"description":"Answers 404 for an unknown request and for one belonging to another artist, identically.","parameters":[{"schema":{"type":"string"},"in":"path","name":"requestId","required":true,"description":"The request_id returned by a settings write."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"NilIngestionStatusResponse","type":"object","required":["request_id","state","dna_state","record_version","created_at","updated_at","assets"],"properties":{"request_id":{"type":"string"},"state":{"title":"NilvIngestRequestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["in_progress"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["partial"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["publish_failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]},"record_version":{"description":"The settings version that cited these assets.","type":"integer"},"created_at":{"description":"Epoch milliseconds.","type":"integer"},"updated_at":{"description":"Epoch milliseconds.","type":"integer"},"assets":{"type":"array","items":{"title":"NilIngestionAssetStatus","type":"object","required":["asset_id","sha256","kind","state","dna_state"],"properties":{"asset_id":{"type":"string"},"sha256":{"type":"string"},"kind":{"type":"string"},"state":{"title":"NilvIngestState","anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["downloading"]},{"type":"string","enum":["stored"]},{"type":"string","enum":["duplicate"]},{"type":"string","enum":["checksum_mismatch"]},{"type":"string","enum":["failed"]}]},"dna_state":{"title":"NilvDnaState","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["extracted"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["failed"]}]},"storage_uri":{"description":"Set once the bytes are stored.","type":"string"},"error":{"description":"Why this asset will not be stored. Present on checksum_mismatch, duplicate and failed.","type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ArtistSettingsError","additionalProperties":true,"type":"object","properties":{"message":{"type":"string"},"name":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"},"code":{"type":"string"},"permission":{"type":"string"},"object":{"type":"string"},"reason":{"type":"string"}}}}}}}}},"/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","required":["files"],"properties":{"files":{"title":"Files","type":"array","items":{"title":"AssetMetadataRecord","type":"object","required":["file_id"],"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_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"type":"string"}}}},"ip_rights":{"title":"IpRights","description":"Intellectual property rights information for the file.","type":"object","properties":{"recording":{"title":"RecordingContributors","description":"List of recording contributors and their respective AI training consent.","type":"array","items":{"title":"RecordingContributor","type":"object","properties":{"contributor":{"description":"The contributor of the recording.","type":"string"},"identifiers":{"title":"ContributorIdentifiers","description":"Identifiers and personal identification data for the contributor.","type":"object","properties":{"external_id":{"description":"The external ID of the contributor in another system, e.g. OpenPlay. This ID can be used to reference the contributor.","type":"string"},"isni":{"description":"The ISNI (International Standard Name Identifier) of the contributor, a 16-character identifier (15 digits plus a final digit or X). Submit without spaces or hyphens.","pattern":"^[0-9]{15}[0-9X]$","type":"string"},"party_id":{"description":"The party ID of the contributor in the delivering partner's system.","type":"string"},"sureel_party_uuid":{"description":"The Sureel party UUID of the contributor: the platform-minted identity of their artist or songwriter profile record. Set when the contributor could be resolved to a profile; distinct from party_id, which is the delivering partner's identifier.","type":"string"},"uaid":{"description":"The UAID of the contributor.","type":"string"},"date_of_birth":{"description":"The date of birth of the contributor. The format is YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}}},"contributor_role":{"title":"ContributorRole","description":"The role of the contributor in the recording.","anyOf":[{"type":"string","enum":["Performed by"]},{"type":"string","enum":["Vocalist"]},{"type":"string","enum":["Lead vocalist"]},{"type":"string","enum":["Background vocalist"]},{"type":"string","enum":["Instrumentalist"]},{"type":"string","enum":["Guitarist"]},{"type":"string","enum":["Bassist"]},{"type":"string","enum":["Drummer"]},{"type":"string","enum":["Keyboardist"]},{"type":"string","enum":["Producer"]},{"type":"string","enum":["Executive producer"]},{"type":"string","enum":["Co-producer"]},{"type":"string","enum":["Engineer"]},{"type":"string","enum":["Mixing engineer"]},{"type":"string","enum":["Mastering engineer"]},{"type":"string","enum":["Recording engineer"]},{"type":"string","enum":["Featured artist"]},{"type":"string","enum":["Primary artist"]},{"minLength":1,"type":"string"}]},"split_percentage":{"description":"The split percentage of the recording contributed by the artist.","minimum":0,"maximum":1,"type":"number"},"territory":{"description":"The territory in which the recording is distributed.","type":"string"},"allow_ai_training":{"description":"Indicates whether to allow AI training on the recording data.","type":"boolean"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"_delete":{"description":"Set to true to remove this contributor during a merge update.","type":"boolean"}}}},"publishing":{"title":"PublishingContributors","description":"List of publishing contributors and their respective AI training consent.","type":"array","items":{"title":"PublishingContributor","type":"object","properties":{"work_title":{"description":"The title of the musical work.","type":"string"},"external_work_id":{"description":"An external identifier for the musical work, e.g. from a CMO or publishing administration system.","type":"string"},"iswc":{"description":"The ISWC (International Standard Musical Work Code) is a unique identifier for musical works.","type":"string"},"contributor":{"description":"The contributor of the publishing.","type":"string"},"ipi_number":{"description":"The IPI (Interested Parties Information) number for songwriter/publisher identification. Typically a 9 to 11 digit numeric code assigned by CISAC.","pattern":"^[0-9]{9,11}$","type":"string"},"pro_affiliation":{"title":"ProAffiliation","description":"The Performance Rights Organization (PRO) the contributor is affiliated with (e.g., ASCAP, BMI, GEMA).","anyOf":[{"type":"string","enum":["ASCAP"]},{"type":"string","enum":["BMI"]},{"type":"string","enum":["SESAC"]},{"type":"string","enum":["GEMA"]},{"type":"string","enum":["PRS"]},{"type":"string","enum":["SOCAN"]},{"type":"string","enum":["SACEM"]},{"type":"string","enum":["JASRAC"]},{"type":"string","enum":["APRA AMCOS"]},{"type":"string","enum":["BUMA/STEMRA"]},{"type":"string","enum":["SGAE"]},{"type":"string","enum":["SIAE"]},{"type":"string","enum":["SUISA"]},{"type":"string","enum":["KODA"]},{"type":"string","enum":["TONO"]},{"type":"string","enum":["STIM"]},{"type":"string","enum":["TEOSTO"]},{"type":"string","enum":["KOMCA"]},{"type":"string","enum":["IMRO"]},{"minLength":1,"type":"string"}]},"identifiers":{"title":"ContributorIdentifiers","description":"Identifiers and personal identification data for the contributor.","type":"object","properties":{"external_id":{"description":"The external ID of the contributor in another system, e.g. OpenPlay. This ID can be used to reference the contributor.","type":"string"},"isni":{"description":"The ISNI (International Standard Name Identifier) of the contributor, a 16-character identifier (15 digits plus a final digit or X). Submit without spaces or hyphens.","pattern":"^[0-9]{15}[0-9X]$","type":"string"},"party_id":{"description":"The party ID of the contributor in the delivering partner's system.","type":"string"},"sureel_party_uuid":{"description":"The Sureel party UUID of the contributor: the platform-minted identity of their artist or songwriter profile record. Set when the contributor could be resolved to a profile; distinct from party_id, which is the delivering partner's identifier.","type":"string"},"uaid":{"description":"The UAID of the contributor.","type":"string"},"date_of_birth":{"description":"The date of birth of the contributor. The format is YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}}},"contributor_role":{"title":"PublishingContributorRole","description":"The role of the contributor in the publishing.","anyOf":[{"type":"string","enum":["Composer"]},{"type":"string","enum":["Songwriter"]},{"type":"string","enum":["Co-songwriter"]},{"type":"string","enum":["Lyricist"]},{"type":"string","enum":["Lyric writer"]},{"type":"string","enum":["Music composer"]},{"type":"string","enum":["Melody writer"]},{"type":"string","enum":["Author"]},{"type":"string","enum":["Co-author"]},{"type":"string","enum":["Writer"]},{"type":"string","enum":["Co-writer"]},{"type":"string","enum":["Arranger"]},{"type":"string","enum":["Adapter"]},{"type":"string","enum":["Translator"]},{"type":"string","enum":["Publisher"]},{"type":"string","enum":["Rights holder"]},{"type":"string","enum":["Administrator"]},{"minLength":1,"type":"string"}]},"split_percentage":{"description":"The split percentage of the publishing contributed by the artist.","minimum":0,"maximum":1,"type":"number"},"territory":{"description":"The territory in which the publishing is distributed.","type":"string"},"allow_ai_training":{"description":"Indicates whether to allow AI training on the publishing data.","type":"boolean"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"_delete":{"description":"Set to true to remove this contributor during a merge update.","type":"boolean"}}}}}},"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","required":["stem_file_path","stem_type","original_stem_filename"],"properties":{"stem_file_path":{"type":"string"},"stem_type":{"type":"string"},"original_stem_filename":{"type":"string"}}}},"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","required":["recording_rights","publishing_rights","cover_or_derivative_work"],"properties":{"recording_rights":{"type":"boolean"},"publishing_rights":{"type":"boolean"},"cover_or_derivative_work":{"type":"boolean"}}},"spotify_url":{"type":"string"},"spotify_id":{"type":"string"},"is_spotify_url":{"type":"boolean"},"not_on_spotify":{"type":"boolean"},"spotify_not_found_retry_after":{"type":"number"},"spotify_not_found_count":{"type":"number"}}}}}}}}}}},"put":{"operationId":"updateAssetMetadata","summary":"Update asset metadata","tags":["asset-metadata"],"description":"Update asset metadata by using fileId.","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"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"},"artists":{"title":"Artists","description":"The individual performers who contributed to the recording of the collection. An artist is a creative contributor on the recording side.","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"},"artistRole":{"description":"The role of one artist that contributed to the collection.","type":"string"},"artistIsni":{"description":"The ISNI (International Standard Name Identifier) of the contributor, a 16-character identifier for a natural or legal person (15 digits plus a final digit or X). Submit without spaces or hyphens.","pattern":"^[0-9]{15}[0-9X]$","type":"string"},"artistUaid":{"description":"The UAID of the contributor.","type":"string"},"artistPartyId":{"description":"The party ID of the contributor in the delivering partner's system.","type":"string"},"artistSpotifyId":{"description":"The Spotify artist ID.","type":"string"},"artistAppleId":{"description":"The Apple Music artist ID.","type":"string"},"artistDateOfBirth":{"description":"The date of birth of the contributor. The format is YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}}}},"ip_rights":{"title":"IpRights","description":"Intellectual property rights information for the file.","type":"object","properties":{"recording":{"title":"RecordingContributors","description":"List of recording contributors and their respective AI training consent.","type":"array","items":{"title":"RecordingContributor","type":"object","properties":{"contributor":{"description":"The contributor of the recording.","type":"string"},"identifiers":{"title":"ContributorIdentifiers","description":"Identifiers and personal identification data for the contributor.","type":"object","properties":{"external_id":{"description":"The external ID of the contributor in another system, e.g. OpenPlay. This ID can be used to reference the contributor.","type":"string"},"isni":{"description":"The ISNI (International Standard Name Identifier) of the contributor, a 16-character identifier (15 digits plus a final digit or X). Submit without spaces or hyphens.","pattern":"^[0-9]{15}[0-9X]$","type":"string"},"party_id":{"description":"The party ID of the contributor in the delivering partner's system.","type":"string"},"sureel_party_uuid":{"description":"The Sureel party UUID of the contributor: the platform-minted identity of their artist or songwriter profile record. Set when the contributor could be resolved to a profile; distinct from party_id, which is the delivering partner's identifier.","type":"string"},"uaid":{"description":"The UAID of the contributor.","type":"string"},"date_of_birth":{"description":"The date of birth of the contributor. The format is YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}}},"contributor_role":{"title":"ContributorRole","description":"The role of the contributor in the recording.","anyOf":[{"type":"string","enum":["Performed by"]},{"type":"string","enum":["Vocalist"]},{"type":"string","enum":["Lead vocalist"]},{"type":"string","enum":["Background vocalist"]},{"type":"string","enum":["Instrumentalist"]},{"type":"string","enum":["Guitarist"]},{"type":"string","enum":["Bassist"]},{"type":"string","enum":["Drummer"]},{"type":"string","enum":["Keyboardist"]},{"type":"string","enum":["Producer"]},{"type":"string","enum":["Executive producer"]},{"type":"string","enum":["Co-producer"]},{"type":"string","enum":["Engineer"]},{"type":"string","enum":["Mixing engineer"]},{"type":"string","enum":["Mastering engineer"]},{"type":"string","enum":["Recording engineer"]},{"type":"string","enum":["Featured artist"]},{"type":"string","enum":["Primary artist"]},{"minLength":1,"type":"string"}]},"split_percentage":{"description":"The split percentage of the recording contributed by the artist.","minimum":0,"maximum":1,"type":"number"},"territory":{"description":"The territory in which the recording is distributed.","type":"string"},"allow_ai_training":{"description":"Indicates whether to allow AI training on the recording data.","type":"boolean"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"_delete":{"description":"Set to true to remove this contributor during a merge update.","type":"boolean"}}}},"publishing":{"title":"PublishingContributors","description":"List of publishing contributors and their respective AI training consent.","type":"array","items":{"title":"PublishingContributor","type":"object","properties":{"work_title":{"description":"The title of the musical work.","type":"string"},"external_work_id":{"description":"An external identifier for the musical work, e.g. from a CMO or publishing administration system.","type":"string"},"iswc":{"description":"The ISWC (International Standard Musical Work Code) is a unique identifier for musical works.","type":"string"},"contributor":{"description":"The contributor of the publishing.","type":"string"},"ipi_number":{"description":"The IPI (Interested Parties Information) number for songwriter/publisher identification. Typically a 9 to 11 digit numeric code assigned by CISAC.","pattern":"^[0-9]{9,11}$","type":"string"},"pro_affiliation":{"title":"ProAffiliation","description":"The Performance Rights Organization (PRO) the contributor is affiliated with (e.g., ASCAP, BMI, GEMA).","anyOf":[{"type":"string","enum":["ASCAP"]},{"type":"string","enum":["BMI"]},{"type":"string","enum":["SESAC"]},{"type":"string","enum":["GEMA"]},{"type":"string","enum":["PRS"]},{"type":"string","enum":["SOCAN"]},{"type":"string","enum":["SACEM"]},{"type":"string","enum":["JASRAC"]},{"type":"string","enum":["APRA AMCOS"]},{"type":"string","enum":["BUMA/STEMRA"]},{"type":"string","enum":["SGAE"]},{"type":"string","enum":["SIAE"]},{"type":"string","enum":["SUISA"]},{"type":"string","enum":["KODA"]},{"type":"string","enum":["TONO"]},{"type":"string","enum":["STIM"]},{"type":"string","enum":["TEOSTO"]},{"type":"string","enum":["KOMCA"]},{"type":"string","enum":["IMRO"]},{"minLength":1,"type":"string"}]},"identifiers":{"title":"ContributorIdentifiers","description":"Identifiers and personal identification data for the contributor.","type":"object","properties":{"external_id":{"description":"The external ID of the contributor in another system, e.g. OpenPlay. This ID can be used to reference the contributor.","type":"string"},"isni":{"description":"The ISNI (International Standard Name Identifier) of the contributor, a 16-character identifier (15 digits plus a final digit or X). Submit without spaces or hyphens.","pattern":"^[0-9]{15}[0-9X]$","type":"string"},"party_id":{"description":"The party ID of the contributor in the delivering partner's system.","type":"string"},"sureel_party_uuid":{"description":"The Sureel party UUID of the contributor: the platform-minted identity of their artist or songwriter profile record. Set when the contributor could be resolved to a profile; distinct from party_id, which is the delivering partner's identifier.","type":"string"},"uaid":{"description":"The UAID of the contributor.","type":"string"},"date_of_birth":{"description":"The date of birth of the contributor. The format is YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}}},"contributor_role":{"title":"PublishingContributorRole","description":"The role of the contributor in the publishing.","anyOf":[{"type":"string","enum":["Composer"]},{"type":"string","enum":["Songwriter"]},{"type":"string","enum":["Co-songwriter"]},{"type":"string","enum":["Lyricist"]},{"type":"string","enum":["Lyric writer"]},{"type":"string","enum":["Music composer"]},{"type":"string","enum":["Melody writer"]},{"type":"string","enum":["Author"]},{"type":"string","enum":["Co-author"]},{"type":"string","enum":["Writer"]},{"type":"string","enum":["Co-writer"]},{"type":"string","enum":["Arranger"]},{"type":"string","enum":["Adapter"]},{"type":"string","enum":["Translator"]},{"type":"string","enum":["Publisher"]},{"type":"string","enum":["Rights holder"]},{"type":"string","enum":["Administrator"]},{"minLength":1,"type":"string"}]},"split_percentage":{"description":"The split percentage of the publishing contributed by the artist.","minimum":0,"maximum":1,"type":"number"},"territory":{"description":"The territory in which the publishing is distributed.","type":"string"},"allow_ai_training":{"description":"Indicates whether to allow AI training on the publishing data.","type":"boolean"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"_delete":{"description":"Set to true to remove this contributor during a merge update.","type":"boolean"}}}}}},"labels":{"title":"Labels","description":"The record label(s) that released the song. A label is an organizational entity on the recording side.","type":"array","items":{"type":"string"}},"publisher":{"description":"The publishing company that administers the song's composition rights and royalties. A publisher is an organizational entity on the publishing side.","type":"string"},"cover":{"description":"Indicates whether the song is a cover.","type":"boolean"},"category":{"description":"The category of the track, e.g. sound effect, remix, original, cover, etc.","type":"string"},"hasVocal":{"description":"Indicates whether the track contains vocal content.","type":"boolean"},"acapella":{"description":"Indicates whether the song is acapella, i.e., contains only vocals.","type":"boolean"},"instrumental":{"description":"Indicates whether the song is instrumental.","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"},"producer":{"description":"For music, you can set the producer.","type":"string"},"composer":{"description":"The individual who wrote the music (melody and harmony) of the song. A composer is a creative contributor on the publishing side.","type":"string"},"song_writer":{"description":"The individual who wrote the lyrics and melody of the song. A songwriter is a creative contributor on the publishing side.","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"]}]}}},"example":{"track_title":"Midnight Dreams","isrc":"USUM71703861","external_track_id":"track-123456","external_url":"https://example.com/track/midnight-dreams","artists":[{"artistName":"John Doe","artistExternalId":"artist-123","artistRole":"Primary artist","artistIsni":"0000000121174585","artistUaid":"UAID-000123","artistPartyId":"PADPIDA2007040502I","artistSpotifyId":"1uNFoZAHBGtllmzznpCI3s","artistAppleId":"159260351","artistDateOfBirth":"1985-04-12"},{"artistName":"Jane Smith","artistExternalId":"artist-456","artistRole":"Featured artist"}],"ip_rights":{"recording":[{"contributor":"John Doe","identifiers":{"external_id":"contributor-ext-123","isni":"0000000121174585","party_id":"PADPIDA2007040502I","sureel_party_uuid":"0f8a3b2e-5c41-4d69-9a77-2e1b6f4c8d05","uaid":"UAID-000123","date_of_birth":"1985-04-12"},"contributor_role":"Primary artist","split_percentage":0.6,"territory":"Worldwide","allow_ai_training":true,"opt_in_rules":{"ai_company_scoped_consent":[{"ai_company_name":"Mirage","allow_ai_training":true}],"time_scoped_consent":{"start_timestamp":1770740622000,"end_timestamp":1773159822000},"no_attribution_greater_than":25,"no_attribution_smaller_than":3,"no_shared_attribution_with_artist":"Example artist","no_shared_attribution_with_genre":"Classical","allow_cover_art_in_motion_picture":true,"allow_lyrics":true}}],"publishing":[{"work_title":"Midnight Dreams","external_work_id":"W-034567890","iswc":"T-345246800-1","contributor":"Jane Smith","ipi_number":"00523879401","pro_affiliation":"ASCAP","identifiers":{"external_id":"contributor-ext-234","isni":"0000000114559647","party_id":"PADPIDA2007040502W","sureel_party_uuid":"6c2d9e71-84fb-4a0c-b3d5-91e7a25c4f68","uaid":"UAID-000456","date_of_birth":"1968-03-02"},"contributor_role":"Songwriter","split_percentage":0.4,"territory":"Worldwide","allow_ai_training":true,"opt_in_rules":{"ai_company_scoped_consent":[{"ai_company_name":"Mirage","allow_ai_training":true}],"time_scoped_consent":{"start_timestamp":1770740622000,"end_timestamp":1773159822000},"no_attribution_greater_than":25,"no_attribution_smaller_than":3,"no_shared_attribution_with_artist":"Example artist","no_shared_attribution_with_genre":"Classical","allow_cover_art_in_motion_picture":true,"allow_lyrics":true}}]},"labels":["Electronic Music Records","Ambient Sounds"],"publisher":"Universal Music Publishing","cover":false,"category":"original","hasVocal":true,"acapella":false,"instrumental":false,"is_stem":false,"stem_type":"master","genres":["Electronic","Ambient"],"duration":240,"bpm":120,"key":"Am","pitch":"A440","mood":"Dreamy","danceability":0.7,"instruments":["Synthesizer","Drum Machine","Bass"],"time_signature":"4/4","song_characteristics":"Atmospheric, layered synths with rhythmic elements","themes":["Dreams","Night","Meditation"],"age_group":"Adult","gender":"Unisex","personality":"Introspective","audio_language":"en","release_date":"2024-12-01","explicit":false,"lyrics":"Floating through the midnight sky, dreams that never die...","recording_studio":"Abbey Road Studios","producer":"Rick Rubin","composer":"John Williams","song_writer":"Bob Dylan","rights_administrator":"ASCAP","rights_owner":"Universal Music Group","ai_influence":"AI refined"}}}},"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","required":["file"],"properties":{"file":{"title":"AssetMetadataRecord","type":"object","required":["file_id"],"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_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"type":"string"}}}},"ip_rights":{"title":"IpRights","description":"Intellectual property rights information for the file.","type":"object","properties":{"recording":{"title":"RecordingContributors","description":"List of recording contributors and their respective AI training consent.","type":"array","items":{"title":"RecordingContributor","type":"object","properties":{"contributor":{"description":"The contributor of the recording.","type":"string"},"identifiers":{"title":"ContributorIdentifiers","description":"Identifiers and personal identification data for the contributor.","type":"object","properties":{"external_id":{"description":"The external ID of the contributor in another system, e.g. OpenPlay. This ID can be used to reference the contributor.","type":"string"},"isni":{"description":"The ISNI (International Standard Name Identifier) of the contributor, a 16-character identifier (15 digits plus a final digit or X). Submit without spaces or hyphens.","pattern":"^[0-9]{15}[0-9X]$","type":"string"},"party_id":{"description":"The party ID of the contributor in the delivering partner's system.","type":"string"},"sureel_party_uuid":{"description":"The Sureel party UUID of the contributor: the platform-minted identity of their artist or songwriter profile record. Set when the contributor could be resolved to a profile; distinct from party_id, which is the delivering partner's identifier.","type":"string"},"uaid":{"description":"The UAID of the contributor.","type":"string"},"date_of_birth":{"description":"The date of birth of the contributor. The format is YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}}},"contributor_role":{"title":"ContributorRole","description":"The role of the contributor in the recording.","anyOf":[{"type":"string","enum":["Performed by"]},{"type":"string","enum":["Vocalist"]},{"type":"string","enum":["Lead vocalist"]},{"type":"string","enum":["Background vocalist"]},{"type":"string","enum":["Instrumentalist"]},{"type":"string","enum":["Guitarist"]},{"type":"string","enum":["Bassist"]},{"type":"string","enum":["Drummer"]},{"type":"string","enum":["Keyboardist"]},{"type":"string","enum":["Producer"]},{"type":"string","enum":["Executive producer"]},{"type":"string","enum":["Co-producer"]},{"type":"string","enum":["Engineer"]},{"type":"string","enum":["Mixing engineer"]},{"type":"string","enum":["Mastering engineer"]},{"type":"string","enum":["Recording engineer"]},{"type":"string","enum":["Featured artist"]},{"type":"string","enum":["Primary artist"]},{"minLength":1,"type":"string"}]},"split_percentage":{"description":"The split percentage of the recording contributed by the artist.","minimum":0,"maximum":1,"type":"number"},"territory":{"description":"The territory in which the recording is distributed.","type":"string"},"allow_ai_training":{"description":"Indicates whether to allow AI training on the recording data.","type":"boolean"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"_delete":{"description":"Set to true to remove this contributor during a merge update.","type":"boolean"}}}},"publishing":{"title":"PublishingContributors","description":"List of publishing contributors and their respective AI training consent.","type":"array","items":{"title":"PublishingContributor","type":"object","properties":{"work_title":{"description":"The title of the musical work.","type":"string"},"external_work_id":{"description":"An external identifier for the musical work, e.g. from a CMO or publishing administration system.","type":"string"},"iswc":{"description":"The ISWC (International Standard Musical Work Code) is a unique identifier for musical works.","type":"string"},"contributor":{"description":"The contributor of the publishing.","type":"string"},"ipi_number":{"description":"The IPI (Interested Parties Information) number for songwriter/publisher identification. Typically a 9 to 11 digit numeric code assigned by CISAC.","pattern":"^[0-9]{9,11}$","type":"string"},"pro_affiliation":{"title":"ProAffiliation","description":"The Performance Rights Organization (PRO) the contributor is affiliated with (e.g., ASCAP, BMI, GEMA).","anyOf":[{"type":"string","enum":["ASCAP"]},{"type":"string","enum":["BMI"]},{"type":"string","enum":["SESAC"]},{"type":"string","enum":["GEMA"]},{"type":"string","enum":["PRS"]},{"type":"string","enum":["SOCAN"]},{"type":"string","enum":["SACEM"]},{"type":"string","enum":["JASRAC"]},{"type":"string","enum":["APRA AMCOS"]},{"type":"string","enum":["BUMA/STEMRA"]},{"type":"string","enum":["SGAE"]},{"type":"string","enum":["SIAE"]},{"type":"string","enum":["SUISA"]},{"type":"string","enum":["KODA"]},{"type":"string","enum":["TONO"]},{"type":"string","enum":["STIM"]},{"type":"string","enum":["TEOSTO"]},{"type":"string","enum":["KOMCA"]},{"type":"string","enum":["IMRO"]},{"minLength":1,"type":"string"}]},"identifiers":{"title":"ContributorIdentifiers","description":"Identifiers and personal identification data for the contributor.","type":"object","properties":{"external_id":{"description":"The external ID of the contributor in another system, e.g. OpenPlay. This ID can be used to reference the contributor.","type":"string"},"isni":{"description":"The ISNI (International Standard Name Identifier) of the contributor, a 16-character identifier (15 digits plus a final digit or X). Submit without spaces or hyphens.","pattern":"^[0-9]{15}[0-9X]$","type":"string"},"party_id":{"description":"The party ID of the contributor in the delivering partner's system.","type":"string"},"sureel_party_uuid":{"description":"The Sureel party UUID of the contributor: the platform-minted identity of their artist or songwriter profile record. Set when the contributor could be resolved to a profile; distinct from party_id, which is the delivering partner's identifier.","type":"string"},"uaid":{"description":"The UAID of the contributor.","type":"string"},"date_of_birth":{"description":"The date of birth of the contributor. The format is YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"}}},"contributor_role":{"title":"PublishingContributorRole","description":"The role of the contributor in the publishing.","anyOf":[{"type":"string","enum":["Composer"]},{"type":"string","enum":["Songwriter"]},{"type":"string","enum":["Co-songwriter"]},{"type":"string","enum":["Lyricist"]},{"type":"string","enum":["Lyric writer"]},{"type":"string","enum":["Music composer"]},{"type":"string","enum":["Melody writer"]},{"type":"string","enum":["Author"]},{"type":"string","enum":["Co-author"]},{"type":"string","enum":["Writer"]},{"type":"string","enum":["Co-writer"]},{"type":"string","enum":["Arranger"]},{"type":"string","enum":["Adapter"]},{"type":"string","enum":["Translator"]},{"type":"string","enum":["Publisher"]},{"type":"string","enum":["Rights holder"]},{"type":"string","enum":["Administrator"]},{"minLength":1,"type":"string"}]},"split_percentage":{"description":"The split percentage of the publishing contributed by the artist.","minimum":0,"maximum":1,"type":"number"},"territory":{"description":"The territory in which the publishing is distributed.","type":"string"},"allow_ai_training":{"description":"Indicates whether to allow AI training on the publishing data.","type":"boolean"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"_delete":{"description":"Set to true to remove this contributor during a merge update.","type":"boolean"}}}}}},"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","required":["stem_file_path","stem_type","original_stem_filename"],"properties":{"stem_file_path":{"type":"string"},"stem_type":{"type":"string"},"original_stem_filename":{"type":"string"}}}},"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","required":["recording_rights","publishing_rights","cover_or_derivative_work"],"properties":{"recording_rights":{"type":"boolean"},"publishing_rights":{"type":"boolean"},"cover_or_derivative_work":{"type":"boolean"}}},"spotify_url":{"type":"string"},"spotify_id":{"type":"string"},"is_spotify_url":{"type":"boolean"},"not_on_spotify":{"type":"boolean"},"spotify_not_found_retry_after":{"type":"number"},"spotify_not_found_count":{"type":"number"}}}}}}}}}}},"/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","required":["requestId"],"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"},"metadataUrl":{"description":"Signed URL to the extracted-metadata JSON on S3 (metadata-extraction requests only).","type":"string"},"metadata":{"title":"ExtractedMetadata","description":"Extracted metadata keyed by track S3 key. Only inlined when the file is small; the signed URL is always provided.","type":"object","additionalProperties":{}},"seed":{"type":"number"},"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"compositionAttributionPerTrack":{"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"ipGuardrailAttributionPerCollection":{"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"ipGuardrailAttributionPerTrack":{"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"provenance":{"title":"Provenance","anyOf":[{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}},{"type":"null"}]},"artistProfilePictures":{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","required":["artistName","picture"],"properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"},"labelName":{"type":"string"}}}}]},"requestData":{"title":"AudioLdmRequestData","type":"object","required":["user_id","request_id"],"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"}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"MusicalityValues","type":"object","required":["genre_analysis","mood_analysis"],"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","required":["genre","values"],"properties":{"genre":{"type":"string"},"values":{"title":"GenreAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}}}},"mood_analysis":{"title":"MoodAnalysisValues","type":"array","items":{"title":"MoodAnalysisValuesInner","type":"object","required":["mood","values"],"properties":{"mood":{"type":"string"},"values":{"title":"MoodAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}}}}}}}}}}}}}},"aiDnaVisualization":{"title":"VisualizationS3KeysResponse","type":"array","items":{"title":"AI DNA Visualization","description":"Images for the AI DNA Visualization","type":"object","required":["master"],"properties":{"master":{"title":"ChunkWiseVisualizationS3keysResponse","type":"array","items":{"title":"VisualizationS3keysResponseInner","type":"object","required":["signedUrls"],"properties":{"filename":{"type":"string"},"signedUrls":{"title":"SignedUrls","type":"array","items":{"type":"string"}}}}}}}},"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","required":["duration","period","values"],"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","required":["score","similar_lyrics_inspected","similar_lyrics_original","track","is_spotify_url"],"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"}}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}}}},"similarTracks":{"title":"SimilarTracks","type":"array","items":{"title":"SimilarTracksInner","type":"object","required":["track","signed_url","is_spotify_url"],"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"}}}},"artist_uuid":{"type":"string"},"originalFilename":{"type":"string"},"audios_rule_evaluations":{"title":"AudiosRuleEvaluations","type":"array","items":{"title":"AudioRuleEvaluation","description":"Per-AI-song rule evaluation result: blocked status, violations, and (for blocked songs) the preview duration. Parallel to audiosSignedUrls.","additionalProperties":false,"type":"object","required":["filename","blocked","rule_violations"],"properties":{"filename":{"description":"The AI-generated audio filename this entry describes.","type":"string"},"blocked":{"description":"True if any attribution rule was violated for this AI song. When blocked, the corresponding entry in audiosSignedUrls is a half-duration preview (or empty if the clipping pipeline is not yet wired).","type":"boolean"},"preview_duration_seconds":{"description":"Duration in seconds of the half-song preview returned for blocked audios.","type":"number"},"preview_failed_stems":{"description":"List of audios (master + stems) whose preview clip failed and will be retried on subsequent fetches. Absent/empty means all clips succeeded.","type":"array","items":{"anyOf":[{"type":"string","enum":["master"]},{"type":"string","enum":["vocals"]},{"type":"string","enum":["instrumentals"]},{"type":"string","enum":["bass"]},{"type":"string","enum":["drums"]}]}},"rule_violations":{"title":"AudioRuleEvaluationViolations","type":"array","items":{"title":"RuleViolation","description":"Describes a single attribution rule violation for a collection.","additionalProperties":false,"type":"object","required":["collection_uuid","rule","source","filename","message"],"properties":{"collection_uuid":{"type":"string"},"rule":{"description":"The rule that was violated.","anyOf":[{"type":"string","enum":["no_attribution_greater_than"]},{"type":"string","enum":["no_attribution_smaller_than"]},{"type":"string","enum":["no_shared_attribution_with_artist"]},{"type":"string","enum":["time_scoped_consent"]}]},"source":{"description":"Which attribution signal tripped the rule: recording or composition attribution.","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["composition"]}]},"filename":{"description":"The generated AI song (filename) that tripped the rule.","type":"string"},"source_stem":{"description":"Which stem tripped the rule, for per-stem rules (no_attribution_greater_than, no_attribution_smaller_than). Unset for rules whose semantics are not per-stem.","anyOf":[{"type":"string","enum":["master"]},{"type":"string","enum":["vocals"]},{"type":"string","enum":["instrumentals"]},{"type":"string","enum":["bass"]},{"type":"string","enum":["drums"]}]},"threshold":{"description":"The threshold the rule was configured with, where applicable.","type":"number"},"observed":{"description":"The observed attribution percentage, where applicable.","type":"number"},"message":{"type":"string"}}}}}}}}}}}}}}},"/v1/ai/audio-ldm/ai-platform-audit":{"get":{"operationId":"getAiPlatformAudit","summary":"AI platform audit report","tags":["audio-ai"],"description":"Returns a multi-platform AI audit report for the connected customer. The report content is precomputed and versioned by date; by default the latest version is returned.","parameters":[{"schema":{"minimum":0,"maximum":50000,"default":50,"type":"integer"},"in":"query","name":"topAssets","required":false,"description":"Maximum number of entries to return in compliance_audit_breakdown.assets (sorted by overall_pct descending)."},{"schema":{"minimum":0,"maximum":50,"default":5,"type":"integer"},"in":"query","name":"topTracksPerAlert","required":false,"description":"Maximum number of top_tracks entries to include per alert or asset. A signed URL is returned for each included entry."},{"schema":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},"in":"query","name":"date","required":false,"description":"Optional report version in ISO YYYY-MM-DD format. Defaults to the latest available report for the connected API client."}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Multi-platform AI audit report for a customer. The compliance_audit_breakdown.assets array is truncated to the top entries by overall_pct.","content":{"application/json":{"schema":{"title":"GetAiPlatformAuditResponse","description":"Multi-platform AI audit report for a customer. The compliance_audit_breakdown.assets array is truncated to the top entries by overall_pct.","type":"object","required":["generated_at","report_config","general_information","executive_summary","onboarding_statistics","opt_in_opt_out_distribution","ai_platforms_monitored","compliance_audit_summary","compliance_audit_breakdown"],"properties":{"generated_at":{"type":"string"},"report_config":{"title":"AiPlatformAuditReportConfig","type":"object","required":["threshold_low","threshold_high","scoring_strategy","compliance_bands"],"properties":{"threshold_low":{"type":"number"},"threshold_high":{"type":"number"},"scoring_strategy":{"type":"string"},"compliance_bands":{"title":"AiPlatformAuditComplianceBands","type":"object","required":["low","medium","high"],"properties":{"low":{"title":"AiPlatformAuditComplianceBand","type":"object","required":["label","description"],"properties":{"label":{"type":"string"},"threshold_min":{"type":"number"},"threshold_max":{"type":"number"},"description":{"type":"string"}}},"medium":{"title":"AiPlatformAuditComplianceBand","type":"object","required":["label","description"],"properties":{"label":{"type":"string"},"threshold_min":{"type":"number"},"threshold_max":{"type":"number"},"description":{"type":"string"}}},"high":{"title":"AiPlatformAuditComplianceBand","type":"object","required":["label","description"],"properties":{"label":{"type":"string"},"threshold_min":{"type":"number"},"threshold_max":{"type":"number"},"description":{"type":"string"}}}}}}},"general_information":{"title":"AiPlatformAuditGeneralInformation","type":"object","required":["client_name","report_id","period_start","period_end","generated_at"],"properties":{"client_name":{"type":"string"},"report_id":{"type":"string"},"period_start":{"type":"string"},"period_end":{"type":"string"},"generated_at":{"type":"string"}}},"executive_summary":{"title":"AiPlatformAuditExecutiveSummary","type":"object","required":["is_multi_platform","ai_tracks_analyzed","tracks_subtext","high_risk_matches","high_risk_threshold_pct","primary_detection_source","compliance_band","compliance_label","compliance_description","pct_high_risk"],"properties":{"is_multi_platform":{"type":"boolean"},"ai_tracks_analyzed":{"type":"number"},"tracks_subtext":{"type":"string"},"high_risk_matches":{"type":"number"},"high_risk_threshold_pct":{"type":"number"},"primary_detection_source":{"title":"AiPlatformAuditPrimaryDetectionSource","type":"object","required":["name","model","high_risk_matches"],"properties":{"name":{"type":"string"},"model":{"type":"string"},"high_risk_matches":{"type":"number"}}},"compliance_band":{"type":"string"},"compliance_label":{"type":"string"},"compliance_description":{"type":"string"},"pct_high_risk":{"type":"number"}}},"onboarding_statistics":{"title":"AiPlatformAuditOnboardingStatistics","type":"object","required":["num_assets","num_artists","num_releases","opt_out_pct","opt_in_pct"],"properties":{"num_assets":{"type":"number"},"num_artists":{"type":"number"},"num_releases":{"type":"number"},"opt_out_pct":{"type":"number"},"opt_in_pct":{"type":"number"}}},"opt_in_opt_out_distribution":{"title":"AiPlatformAuditOptDistribution","type":"object","required":["recordings","compositions","artists","songwriters"],"properties":{"recordings":{"title":"AiPlatformAuditOptDistributionEntry","type":"object","required":["total","opted_out","opted_in","opt_out_pct","opt_in_pct"],"properties":{"total":{"type":"number"},"opted_out":{"type":"number"},"opted_in":{"type":"number"},"opt_out_pct":{"type":"number"},"opt_in_pct":{"type":"number"}}},"compositions":{"title":"AiPlatformAuditOptDistributionEntry","type":"object","required":["total","opted_out","opted_in","opt_out_pct","opt_in_pct"],"properties":{"total":{"type":"number"},"opted_out":{"type":"number"},"opted_in":{"type":"number"},"opt_out_pct":{"type":"number"},"opt_in_pct":{"type":"number"}}},"artists":{"title":"AiPlatformAuditOptDistributionEntry","type":"object","required":["total","opted_out","opted_in","opt_out_pct","opt_in_pct"],"properties":{"total":{"type":"number"},"opted_out":{"type":"number"},"opted_in":{"type":"number"},"opt_out_pct":{"type":"number"},"opt_in_pct":{"type":"number"}}},"songwriters":{"title":"AiPlatformAuditOptDistributionEntry","type":"object","required":["total","opted_out","opted_in","opt_out_pct","opt_in_pct"],"properties":{"total":{"type":"number"},"opted_out":{"type":"number"},"opted_in":{"type":"number"},"opt_out_pct":{"type":"number"},"opt_in_pct":{"type":"number"}}}}},"ai_platforms_monitored":{"title":"AiPlatformAuditPlatformsMonitored","type":"object","required":["threshold_low","threshold_high","period","platforms","totals"],"properties":{"threshold_low":{"type":"number"},"threshold_high":{"type":"number"},"period":{"type":"string"},"platforms":{"title":"AiPlatformAuditPlatforms","type":"array","items":{"title":"AiPlatformAuditPlatform","type":"object","required":["name","model","period","tracks_analyzed","matches_above_low","matches_above_high","avg_score_pct","max_score_pct","risk_level","risk_label"],"properties":{"name":{"type":"string"},"model":{"type":"string"},"period":{"type":"string"},"tracks_analyzed":{"type":"number"},"matches_above_low":{"type":"number"},"matches_above_high":{"type":"number"},"avg_score_pct":{"type":"number"},"max_score_pct":{"type":"number"},"risk_level":{"type":"string"},"risk_label":{"type":"string"}}}},"totals":{"title":"AiPlatformAuditPlatformTotals","type":"object","required":["tracks_analyzed","matches_above_low","matches_above_high"],"properties":{"tracks_analyzed":{"type":"number"},"matches_above_low":{"type":"number"},"matches_above_high":{"type":"number"}}}}},"compliance_audit_summary":{"title":"AiPlatformAuditComplianceAuditSummary","type":"object","required":["threshold_low","threshold_high","threshold_distribution","component_stats","top_alerts"],"properties":{"threshold_low":{"type":"number"},"threshold_high":{"type":"number"},"threshold_distribution":{"title":"AiPlatformAuditThresholdDistribution","type":"object","required":["low","medium","high"],"properties":{"low":{"title":"AiPlatformAuditThresholdBucket","type":"object","required":["count","pct"],"properties":{"count":{"type":"number"},"pct":{"type":"number"}}},"medium":{"title":"AiPlatformAuditThresholdBucket","type":"object","required":["count","pct"],"properties":{"count":{"type":"number"},"pct":{"type":"number"}}},"high":{"title":"AiPlatformAuditThresholdBucket","type":"object","required":["count","pct"],"properties":{"count":{"type":"number"},"pct":{"type":"number"}}}}},"component_stats":{"title":"AiPlatformAuditComponentStats","type":"object","properties":{"recording":{"title":"AiPlatformAuditComponentStat","type":"object","required":["avg_max_score_pct","count_above_low","count_above_high","max_score_pct","total_pairs"],"properties":{"avg_max_score_pct":{"type":"number"},"count_above_low":{"type":"number"},"count_above_high":{"type":"number"},"max_score_pct":{"type":"number"},"total_pairs":{"type":"number"}}},"composition":{"title":"AiPlatformAuditComponentStat","type":"object","required":["avg_max_score_pct","count_above_low","count_above_high","max_score_pct","total_pairs"],"properties":{"avg_max_score_pct":{"type":"number"},"count_above_low":{"type":"number"},"count_above_high":{"type":"number"},"max_score_pct":{"type":"number"},"total_pairs":{"type":"number"}}},"vocals":{"title":"AiPlatformAuditComponentStat","type":"object","required":["avg_max_score_pct","count_above_low","count_above_high","max_score_pct","total_pairs"],"properties":{"avg_max_score_pct":{"type":"number"},"count_above_low":{"type":"number"},"count_above_high":{"type":"number"},"max_score_pct":{"type":"number"},"total_pairs":{"type":"number"}}}}},"top_alerts":{"title":"AiPlatformAuditTopAlerts","type":"array","items":{"title":"AiPlatformAuditTopAlert","type":"object","required":["rank","song_id","generated_audio_id","component","stem","max_score_pct","segment_density_pct","platform_name","platform_model"],"properties":{"rank":{"type":"number"},"song_id":{"type":"string"},"generated_audio_id":{"type":"string"},"component":{"type":"string"},"stem":{"type":"string"},"max_score_pct":{"type":"number"},"segment_density_pct":{"type":"number"},"platform_name":{"type":"string"},"platform_model":{"type":"string"},"file_id":{"type":"string"},"track_name":{"type":"string"},"artist_name":{"type":"string"},"signed_url":{"type":"string"},"top_tracks":{"title":"AiPlatformAuditAlertTopTracks","type":"array","items":{"title":"AiPlatformAuditTopTrack","type":"object","required":["gen_id","score_pct"],"properties":{"gen_id":{"type":"string"},"score_pct":{"type":"number"},"signed_url":{"type":"string"}}}}}}}}},"compliance_audit_breakdown":{"title":"AiPlatformAuditComplianceAuditBreakdown","type":"object","required":["total_assets","assets"],"properties":{"total_assets":{"type":"number"},"assets":{"title":"AiPlatformAuditAssets","type":"array","items":{"title":"AiPlatformAuditAsset","type":"object","required":["song_id","sureel_id","component","overall_pct","recording_pct","composition_pct","vocals_pct","confidence_pct","distribution","platforms"],"properties":{"song_id":{"type":"string"},"sureel_id":{"type":"string"},"component":{"type":"string"},"overall_pct":{"type":"number"},"recording_pct":{"type":"number"},"composition_pct":{"type":"number"},"vocals_pct":{"type":"number"},"confidence_pct":{"type":"number"},"distribution":{"title":"AiPlatformAuditAssetDistribution","type":"object","required":["low","medium","high"],"properties":{"low":{"type":"number"},"medium":{"type":"number"},"high":{"type":"number"}}},"platforms":{"type":"string"},"file_id":{"type":"string"},"track_name":{"type":"string"},"artist_name":{"type":"string"},"signed_url":{"type":"string"},"top_tracks":{"title":"AiPlatformAuditAssetTopTracks","type":"array","items":{"title":"AiPlatformAuditTopTrack","type":"object","required":["gen_id","score_pct"],"properties":{"gen_id":{"type":"string"},"score_pct":{"type":"number"},"signed_url":{"type":"string"}}}}}}}}}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostTextToAudioBody","type":"object","required":["prompt","audioLength"],"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":30,"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"]}]}}},"example":{"prompt":"Upbeat electronic track with punchy drums, warm pads, and a catchy pluck lead","audioLength":30,"genre":"Electronic","subGenre":"Synthwave","mood":"Energetic","songKey":"Am","tempo":"120","negativePrompt":"no distortion, no heavy noise, no vocals","splitStem":false,"inferenceSteps":30,"cfg":7.5,"seed":123456789,"batchSize":2,"webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key","generateAttribution":true,"surpriseMe":false,"modelName":"baseline"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostTextToArtistAudioBody","type":"object","required":["prompt","audioLength","artistPreset"],"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":30,"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","required":["collectionUuid"],"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"}}}},"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"]}]}}},"example":{"prompt":"Indie pop track with crisp drums, jangly guitars, and warm bass","audioLength":30,"artistPreset":[{"collectionUuid":"550e8400","presetAttribution":0.5}],"genre":"Indie","subGenre":"Indie Pop","mood":"Upbeat","songKey":"Gmaj","tempo":"120","negativePrompt":"no distortion, no harsh noise, no vocals","splitStem":false,"inferenceSteps":30,"cfg":7.5,"seed":123456789,"batchSize":2,"webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key","generateAttribution":true,"surpriseMe":false,"modelName":"baseline"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostAudioToAudioBody","type":"object","required":["prompt","contentAudioPath","audioLength"],"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":30,"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"},"styleStrength":{"minimum":0,"maximum":1,"description":"Determines how strongly the style described by the text prompt reshapes the input audio. Higher values deviate more from the source audio.","type":"number"},"melodyStrength":{"minimum":0,"maximum":1,"description":"Determines how strongly the input audio is preserved in the generation. Higher values keep the output closer to the original melody.","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":2,"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"},"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"]}]}}},"example":{"prompt":"Lush ambient soundscape with evolving pads, gentle piano motifs, and subtle field recordings","contentAudioPath":"https://example.com/audio/source_input.wav","audioLength":45,"genre":"Ambient","subGenre":"Downtempo","mood":"Calm","songKey":"Cmaj","tempo":"90","splitStem":false,"inferenceSteps":28,"cfg":7,"styleStrength":0.7,"melodyStrength":0.5,"seed":123456789,"batchSize":2,"webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key","generateAttribution":true,"generateProvenance":false,"surpriseMe":false,"modelName":"baseline"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostStemSplitBody","type":"object","required":["contentAudioPath"],"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"}}},"example":{"contentAudioPath":"https://example.com/audio/song.wav","webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostCalculateAttributionBodyAudio","type":"object","required":["contentAudioPath","prompt"],"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"}}},"example":{"contentAudioPath":"https://example.com/audio/input_track.wav","prompt":"Chill electronic track with soft pads and light percussion","webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostAudioAttributionAnalysisBody","type":"object","required":["contentAudioPath","topNMatches"],"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"}}},"example":{"contentAudioPath":"https://example.com/audio/input_track.wav","lyricsAnalysis":{"getAttribution":true,"desiredLanguage":"Spanish"},"topNMatches":5,"webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostOptOutAnalysisBody","type":"object","required":["contentAudioPath"],"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"}}},"example":{"contentAudioPath":"https://example.com/audio/input_track.wav","webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostAccidentalInfringementCheckBody","type":"object","required":["contentAudioPath"],"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"}}},"example":{"contentAudioPath":"https://example.com/audio/input_track.wav","webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostLyricsAnalysisBody","type":"object","required":["lyricsAnalysis"],"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"}}},"example":{"contentAudioPath":"https://example.com/audio/input_track.wav","lyricsAnalysis":{"inputLyrics":"Drifting through the night, under silver city lights","getAttribution":true,"desiredLanguage":"Spanish"},"webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"title":"PostDetectAIGeneratedAudioBody","type":"object","required":["contentAudioPath"],"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"}}},"example":{"contentAudioPath":"https://example.com/audio/input_track.wav","enableGeneratorDetection":true,"webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostSimilarSongFinderBody","type":"object","required":["contentAudioPath","topNMatches"],"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"}}},"example":{"contentAudioPath":"https://example.com/audio/input_track.wav","topNMatches":5,"webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"PostSongAnalysis","type":"object","required":["contentAudioPath","topNMatches"],"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"}}},"example":{"contentAudioPath":"https://example.com/audio/input_track.wav","musicalityAnalysisMode":"combined","lyricsAnalysis":{"getAttribution":true,"desiredLanguage":"Spanish"},"enableGeneratorDetection":true,"topNMatches":5,"webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"title":"PostAudioAttributionSetupBody","type":"object","required":["collectionUuid"],"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"}}},"example":{"collectionUuid":"550e8400","webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/v1/ai/audio-ldm/metadata-extraction":{"post":{"operationId":"audioMetadataExtraction","summary":"Audio Metadata extraction","tags":["audio-ai"],"description":"Extracts musical metadata (genre, mood, tempo, key, instruments, vocals, and more) from the audio files of the specified collection.","requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"PostAudioAttributionSetupBody","type":"object","required":["collectionUuid"],"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"}}},"example":{"collectionUuid":"550e8400","webhookUrl":"https://webhooks.example.com/audio-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/v1/ai/files/upload-files":{"post":{"operationId":"uploadFiles","summary":"Upload files as form-data","tags":["files"],"description":"Upload audio, image, video, metadata, or archive files as form-data for use with other endpoints.\nAllowed file extensions:\n- Audio: .wav, .mp3, .m4a, .flac, .aiff, .aif, .wma\n- Image: .jpeg, .jpg, .png, .tif\n- Video: .mp4\n- Metadata: .json, .npy, .xml, .npz\n- Archive: .zip\n\nAll uploads are securely stored on the server for a limited time.\nMaximum file size: 200MB. For files larger than 200MB (e.g. DDEX ZIPs), use `/files/generate-upload-urls` instead.","parameters":[{"schema":{"enum":["audio","image","video","metadata","archive"],"title":"ContentType","type":"string"},"in":"query","name":"contentType","required":true},{"schema":{"pattern":"^multipart/form-data","type":"string"},"in":"header","name":"Content-Type","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostUploadFilesResponse","type":"object","required":["filePaths"],"properties":{"filePaths":{"title":"FilePaths","type":"array","items":{"type":"string"}}}}}}}}}},"/v1/ai/files/generate-upload-urls":{"post":{"operationId":"generatePutUploadUrls","summary":"Generate signed URLs to upload files to cloud storage","tags":["files"],"description":"Returns the signed url for the given filenames.","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"UploadUrlRequest","type":"object","required":["filenames"],"properties":{"filenames":{"title":"Filenames","type":"array","items":{"type":"string"}},"fileSizes":{"title":"FileSizes","description":"Optional maximum file sizes in bytes, aligned by index with `filenames` (same length). When provided, the signed URL enforces the size as an upper bound: the PUT request must include the header `x-goog-content-length-range: 0,` (it is part of the URL signature), and larger uploads are rejected by the storage backend. Intended for files larger than the form-data upload limit, e.g. AI model artifacts up to 1GB.","type":"array","items":{"minimum":1,"maximum":1073741824,"type":"integer"}}}},"example":{"filenames":["track1.wav","cover.jpg","metadata.json"],"fileSizes":[52428800,1048576,4096]}}}},"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","required":["originalFilename","url","key"],"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 cloud storage.","type":"string"},"key":{"description":"A unique identifier for the file used to identify and retrieve it in storage.","type":"string"}}}}}}}}}},"/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","required":["key","url"],"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"}}}}}}}}}},"/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","required":["requestId"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}}}}}}}]},"provenance":{"title":"Provenance","anyOf":[{"type":"null"},{"title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}}}}}}}]},"contentImage":{"type":"string"},"styleImage":{"type":"string"},"maskImage":{"type":"string"},"artistProfilePictures":{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","required":["artistName","picture"],"properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"},"labelName":{"type":"string"}}}}]},"seed":{"type":"number"},"requestData":{"title":"GetLdmRequestData","type":"object","required":["user_id","request_id"],"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"}]}}},"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","required":["similarFiles","topMetrics"],"properties":{"similarFiles":{"title":"SimilarImageFilesWithMetrics","type":"array","items":{"title":"SimilarImageFile","type":"object","required":["attribution_likelihood","color_matching","pixelwise_similarity"],"properties":{"attribution_likelihood":{"type":"number"},"cross_correlation":{"type":"number"},"color_matching":{"title":"ColorMatching","type":"object","required":["g_channel","r_channel","b_channel"],"properties":{"g_channel":{"type":"number"},"r_channel":{"type":"number"},"b_channel":{"type":"number"}}},"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"}}}},"topMetrics":{"title":"TopMetrics","type":"object","required":["attribution_likelihood","cross_correlation","color_matching","color_matching_combined","pixelwise_similarity","identical_matches"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"cross_correlation":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"color_matching":{"title":"TopColorMatching","type":"object","required":["g_channel","r_channel","b_channel"],"properties":{"g_channel":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"r_channel":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"b_channel":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}},"color_matching_combined":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"pixelwise_similarity":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls","signed_urls_thumbnails"],"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"}]}}}}}}}},"originalFilename":{"type":"string"}}}}}}}}},"/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","required":["Painting","Digital Art","Photography","Anime"],"properties":{"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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"TextToImageRequest","type":"object","required":["prompt","resolution"],"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","required":["collectionUuid"],"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"}}}},"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"}}},"example":{"prompt":"A serene mountain landscape at sunrise with warm golden light and misty valleys","resolution":"1024x1024","negativePrompt":"no text, no watermark artifacts, no low quality","applyWatermark":true,"customWatermark":"https://example.com/images/custom_watermark.png","stylePreset":"photorealistic","artistPreset":[{"collectionUuid":"550e8400","presetAttribution":0.5}],"upscale":2,"inferenceSteps":30,"cfg":7.5,"seed":123456789,"generateAttribution":true,"batchSize":2,"removeBg":false,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"PostLdmResponse","type":"object","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ReimagineRequest","type":"object","required":["prompt","contentImagePath"],"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","required":["collectionUuid"],"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"}}}},"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"}}},"example":{"prompt":"Transform this artwork into a vintage poster style with bold typography and retro colors","contentImagePath":"https://example.com/images/input_artwork.jpg","negativePrompt":"no text, no heavy artifacts, no low resolution","applyWatermark":true,"customWatermark":"https://example.com/images/custom_watermark.png","stylePreset":"illustration","artistPreset":[{"collectionUuid":"550e8400","presetAttribution":0.5}],"upscale":2,"inferenceSteps":28,"cfg":7,"seed":123456789,"strength":0.8,"generateAttribution":true,"batchSize":2,"removeBg":false,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"StyleTransferRequest","type":"object","required":["contentImagePath","artistPreset"],"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","required":["collectionUuid"],"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"}}}},"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"}}},"example":{"prompt":"Portrait in the style of vintage film photography with soft grain and muted tones","contentImagePath":"https://example.com/images/source_photo.jpg","negativePrompt":"no text, no heavy artifacts, no low resolution","applyWatermark":true,"customWatermark":"https://example.com/images/custom_watermark.png","stylePreset":"photorealistic","artistPreset":[{"collectionUuid":"550e8400","presetAttribution":0.5}],"upscale":2,"inferenceSteps":30,"cfg":7,"seed":123456789,"strength":0.6,"generateAttribution":true,"batchSize":2,"removeBg":false,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ControlNetRequest","type":"object","required":["prompt","contentImagePath"],"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","required":["collectionUuid"],"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"}}}},"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"}}},"example":{"prompt":"Cityscape line-art outline with clean architectural edges, colored in watercolor style","contentImagePath":"https://example.com/images/source_photo.jpg","controlNet":{"conditioningScale":0.75,"guidanceStart":0.1,"guidanceEnd":0.9},"negativePrompt":"no text, no heavy artifacts, no low resolution","applyWatermark":true,"customWatermark":"https://example.com/images/custom_watermark.png","stylePreset":"illustration","artistPreset":[{"collectionUuid":"550e8400","presetAttribution":0.5}],"inferenceSteps":30,"cfg":7,"seed":123456789,"generateAttribution":true,"batchSize":2,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ControlNetRequest","type":"object","required":["prompt","contentImagePath"],"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","required":["collectionUuid"],"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"}}}},"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"}}},"example":{"prompt":"Cityscape line-art outline with clean architectural edges, colored in watercolor style","contentImagePath":"https://example.com/images/source_photo.jpg","controlNet":{"conditioningScale":0.75,"guidanceStart":0.1,"guidanceEnd":0.9},"negativePrompt":"no text, no heavy artifacts, no low resolution","applyWatermark":true,"customWatermark":"https://example.com/images/custom_watermark.png","stylePreset":"illustration","artistPreset":[{"collectionUuid":"550e8400","presetAttribution":0.5}],"inferenceSteps":30,"cfg":7,"seed":123456789,"generateAttribution":true,"batchSize":2,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"AvatarImageBlendingRequest","type":"object","required":["contentImagePath","styleImages"],"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","required":["styleImagePath"],"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"}}]}}}},"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"}}},"example":{"prompt":"Blend with a cinematic teal-and-orange portrait style while preserving facial structure","contentImagePath":"https://example.com/images/source_face.jpg","styleImages":[{"styleImagePath":"https://example.com/images/style_ref1.jpg","styleImageWeight":0.8}],"controlNet":{"conditioningScale":0.8,"guidanceStart":0.1,"guidanceEnd":0.9},"negativePrompt":"no text, no artifacts, no over-smoothing","applyWatermark":true,"customWatermark":"https://example.com/images/custom_watermark.png","stylePreset":"photorealistic","inferenceSteps":30,"cfg":7,"seed":123456789,"generateAttribution":true,"generateProvenance":false,"batchSize":2,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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 influences the content more and the style image influences the style more. By default, each user has a limit of 100 requests per minute.","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ImageBlendingRequest","type":"object","required":["contentImagePath","styleImages"],"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","required":["styleImagePath"],"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"}}]}}}},"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"}}},"example":{"prompt":"Blend city skyline with watercolor texture, soft edges and pastel tones","contentImagePath":"https://example.com/images/source_photo.jpg","contentImageWeight":0.6,"styleImages":[{"styleImagePath":"https://example.com/images/style_1.jpg","styleImageWeight":0.8},{"styleImagePath":"https://example.com/images/style_2.jpg","styleImageWeight":0.5}],"negativePrompt":"no text overlays, no heavy artifacts, no low resolution","applyWatermark":true,"customWatermark":"https://example.com/images/custom_watermark.png","stylePreset":"illustration","upscale":2,"inferenceSteps":28,"cfg":7,"seed":123456789,"generateAttribution":true,"generateProvenance":false,"batchSize":2,"removeBg":false,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"CoverArtRequest","type":"object","required":["coverContent","coverStyle","referenceCoverArt"],"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","required":["styleImagePath"],"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"}}]}}}},"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"}}},"example":{"frame":"marble.png","textFirstLine":"Aurora Fields","textSecondLine":"Golden Hour EP","fontFirstLine":"anton.ttf","fontSecondLine":"nunito.ttf","fontColorFirstLine":[255,215,0],"fontColorSecondLine":[255,255,255],"coverContent":"Abstract sunrise over rolling hills with soft gradients and subtle grain","coverStyle":"Minimalist, retro-modern","coverColorScheme":"Warm golds and creams","albumGenre":"Indie Pop","albumSeasonality":"Summer","referenceCoverArt":[{"styleImagePath":"https://example.com/reference/cover1.jpg","styleImageWeight":0.7}],"songTitles":"Aurora Fields; Dawn Chorus; Golden Hour","songPath":"https://example.com/audio/aurora_fields.wav","lyrics":"Under painted skies we chase the light...","descriptionWeight":0.8,"negativePrompt":"no text artifacts, no heavy noise","applyWatermark":true,"customWatermark":"https://example.com/images/custom_watermark.png","upscale":2,"inferenceSteps":30,"cfg":7.5,"seed":123456789,"generateAttribution":true,"batchSize":2,"removeBg":false,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"InpaintRequest","type":"object","required":["prompt","contentImagePath","maskImagePath"],"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","required":["collectionUuid"],"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"}}}},"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"}}},"example":{"prompt":"Restore and extend the background with soft bokeh lights, keep subject sharp","contentImagePath":"https://example.com/images/source_photo.png","maskImagePath":"https://example.com/images/mask_photo.png","creativeInpainting":true,"negativePrompt":"no text artifacts, no blurriness, no harsh edges","applyWatermark":true,"customWatermark":"https://example.com/images/custom_watermark.png","stylePreset":"photorealistic","artistPreset":[{"collectionUuid":"550e8400","presetAttribution":0.5}],"upscale":2,"inferenceSteps":30,"cfg":7,"seed":123456789,"strength":0.6,"generateAttribution":true,"batchSize":2,"removeBg":false,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"CalculateAttributionRequest","type":"object","required":["contentImagePath","prompt"],"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"}}},"example":{"contentImagePath":"https://example.com/images/input_artwork.jpg","prompt":"Surreal landscape with melting clocks and desert sands","webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ImageAttributionAnalysisRequest","type":"object","required":["contentImagePath","topNMatches"],"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"}}},"example":{"contentImagePath":"https://example.com/images/input_artwork.jpg","topNMatches":5,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"UpscaleRequest","type":"object","required":["contentImagePath","upscale"],"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"}}},"example":{"contentImagePath":"https://example.com/images/input_artwork.jpg","upscale":2,"applyWatermark":true,"customWatermark":"https://example.com/images/custom_watermark.png","removeBg":false,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"RemoveBackgroundRequest","type":"object","required":["contentImagePath"],"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"}}},"example":{"contentImagePath":"https://example.com/images/input_portrait.png","upscale":2,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"GeneratePreviewRequest","type":"object","required":["contentImagePath"],"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"}}},"example":{"contentImagePath":"https://example.com/images/input_artwork.jpg","applyWatermark":true,"customWatermark":"https://example.com/images/custom_watermark.png","removeBg":false,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"ApplyWatermarkRequest","type":"object","required":["contentImagePath"],"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"}}},"example":{"contentImagePath":"https://example.com/images/input_artwork.jpg","customWatermark":"https://example.com/images/custom_watermark.png","upscale":2,"removeBg":false,"generatePreview":true,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"title":"FinetuningRequest","type":"object","required":["collectionUuid","numTrainSteps"],"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"}}},"example":{"collectionUuid":"550e8400","numTrainSteps":1200,"trainTextEncoder":true,"learningRate":0.0001,"capacity":10,"seed":123456789,"webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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":{"required":true,"content":{"application/json":{"schema":{"title":"AttributionSetupRequest","type":"object","required":["collectionUuid"],"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"}}},"example":{"collectionUuid":"550e8400","webhookUrl":"https://webhooks.example.com/image-events","webhookKey":"secret-webhook-key"}}}},"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","required":["requestId"],"properties":{"requestId":{"type":"string"}}}}}}}}},"/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","required":["promptHistory","lastEvaluatedKey"],"properties":{"promptHistory":{"title":"PromptHistory","type":"array","items":{"title":"PromptHistoryEntry","type":"object","allOf":[{"title":"GetLdmResponse","type":"object","required":["requestId"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}}}}}}}]},"provenance":{"title":"Provenance","anyOf":[{"type":"null"},{"title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValue","type":"array","items":{"title":"AttributionValueObject","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"}}}}}}}]},"contentImage":{"type":"string"},"styleImage":{"type":"string"},"maskImage":{"type":"string"},"artistProfilePictures":{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","required":["artistName","picture"],"properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"},"labelName":{"type":"string"}}}}]},"seed":{"type":"number"},"requestData":{"title":"GetLdmRequestData","type":"object","required":["user_id","request_id"],"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"}]}}},"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","required":["similarFiles","topMetrics"],"properties":{"similarFiles":{"title":"SimilarImageFilesWithMetrics","type":"array","items":{"title":"SimilarImageFile","type":"object","required":["attribution_likelihood","color_matching","pixelwise_similarity"],"properties":{"attribution_likelihood":{"type":"number"},"cross_correlation":{"type":"number"},"color_matching":{"title":"ColorMatching","type":"object","required":["g_channel","r_channel","b_channel"],"properties":{"g_channel":{"type":"number"},"r_channel":{"type":"number"},"b_channel":{"type":"number"}}},"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"}}}},"topMetrics":{"title":"TopMetrics","type":"object","required":["attribution_likelihood","cross_correlation","color_matching","color_matching_combined","pixelwise_similarity","identical_matches"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"cross_correlation":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"color_matching":{"title":"TopColorMatching","type":"object","required":["g_channel","r_channel","b_channel"],"properties":{"g_channel":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"r_channel":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"b_channel":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}},"color_matching_combined":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"pixelwise_similarity":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls","signed_urls_thumbnails"],"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"}]}}}}}}}},"originalFilename":{"type":"string"}}},{"title":"GetAudioLdmResponse","type":"object","required":["requestId"],"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"},"metadataUrl":{"description":"Signed URL to the extracted-metadata JSON on S3 (metadata-extraction requests only).","type":"string"},"metadata":{"title":"ExtractedMetadata","description":"Extracted metadata keyed by track S3 key. Only inlined when the file is small; the signed URL is always provided.","type":"object","additionalProperties":{}},"seed":{"type":"number"},"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"compositionAttributionPerTrack":{"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"ipGuardrailAttributionPerCollection":{"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"ipGuardrailAttributionPerTrack":{"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"ChunkWiseAttribution","type":"array","items":{"title":"AttributionPerChunk","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"provenance":{"title":"Provenance","anyOf":[{"description":"The attribution values for the individual generated files.","title":"AttributionArray","type":"array","items":{"title":"Attribution","type":"object","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"AttributionValues","type":"array","items":{"title":"AttributionValuesInner","type":"object","required":["artist"],"properties":{"artist":{"type":"string"},"value":{"type":"number"},"values":{"title":"AttributionInnerValues","type":"array","items":{"type":"number"}},"confidence_scores":{"title":"AttributionInnerConfidenceScores","type":"array","items":{"type":"number"}},"max_attribution":{"title":"AttributionInnerMaxAttribution","description":"The maximum attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"average_attribution":{"title":"AttributionInnerAverageAttribution","description":"The average attribution value across all temporal segments. Only populated for composition attribution in attribution analysis requests.","type":"array","items":{"type":"number"}},"username":{"type":"string"},"collection_name":{"type":"string"},"collection_uuid":{"type":"string"},"track_name":{"type":"string"},"signed_url":{"description":"URL for a cropped audio preview associated with this attribution. Contains either a Spotify track URL or a signed S3 URL. Only populated when attribution analysis is enabled.","type":"string"},"is_spotify_url":{"description":"Indicates whether signed_url is a Spotify URL (true) or a signed S3 URL (false). Only populated when attribution analysis is enabled.","type":"boolean"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}},{"type":"null"}]},"artistProfilePictures":{"title":"ArtistProfilePictures","anyOf":[{"type":"null"},{"title":"ArtistProfilePicturesArray","type":"array","items":{"title":"ArtistProfilePicture","type":"object","required":["artistName","picture"],"properties":{"artistName":{"type":"string"},"picture":{"title":"Picture","anyOf":[{"type":"null"},{"type":"string"}]},"collectionName":{"type":"string"},"collectionUuid":{"type":"string"},"labelName":{"type":"string"}}}}]},"requestData":{"title":"AudioLdmRequestData","type":"object","required":["user_id","request_id"],"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"}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"instrumentals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"vocals":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"bass":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}},"drums":{"title":"SimilarAudioFilesPerDuration","type":"array","items":{"title":"SimilarAudioFilesPerDurationInner","type":"object","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"SimilarAudioFilesWithMetrics","type":"array","items":{"title":"SimilarAudioFileWithMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution","is_spotify_url"],"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"},"label_name":{"type":"string"}}}},"topMetrics":{"title":"AudioAttributionAnalysisTopMetrics","type":"object","required":["attribution_likelihood","max_attribution","average_attribution"],"properties":{"attribution_likelihood":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"identical_matches":{"title":"IdenticalMatches","type":"object","required":["value","signed_urls"],"properties":{"value":{"type":"number"},"signed_urls":{"title":"SignedUrls","type":"array","items":{"title":"SignedUrlOrNull","anyOf":[{"type":"string"},{"type":"null"}]}}}},"max_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}},"average_attribution":{"title":"TopMetric","type":"object","required":["value","signed_url"],"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"},"label_name":{"type":"string"}}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"properties":{"filename":{"type":"string"},"values":{"title":"MusicalityValues","type":"object","required":["genre_analysis","mood_analysis"],"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","required":["genre","values"],"properties":{"genre":{"type":"string"},"values":{"title":"GenreAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}}}},"mood_analysis":{"title":"MoodAnalysisValues","type":"array","items":{"title":"MoodAnalysisValuesInner","type":"object","required":["mood","values"],"properties":{"mood":{"type":"string"},"values":{"title":"MoodAnalysisValuesInnerValues","type":"array","items":{"type":"number"}}}}}}}}}}}}}}},"aiDnaVisualization":{"title":"VisualizationS3KeysResponse","type":"array","items":{"title":"AI DNA Visualization","description":"Images for the AI DNA Visualization","type":"object","required":["master"],"properties":{"master":{"title":"ChunkWiseVisualizationS3keysResponse","type":"array","items":{"title":"VisualizationS3keysResponseInner","type":"object","required":["signedUrls"],"properties":{"filename":{"type":"string"},"signedUrls":{"title":"SignedUrls","type":"array","items":{"type":"string"}}}}}}}},"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","required":["duration","period","values"],"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","required":["score","similar_lyrics_inspected","similar_lyrics_original","track","is_spotify_url"],"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"}}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}}}},"similarTracks":{"title":"SimilarTracks","type":"array","items":{"title":"SimilarTracksInner","type":"object","required":["track","signed_url","is_spotify_url"],"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"}}}},"artist_uuid":{"type":"string"},"originalFilename":{"type":"string"},"audios_rule_evaluations":{"title":"AudiosRuleEvaluations","type":"array","items":{"title":"AudioRuleEvaluation","description":"Per-AI-song rule evaluation result: blocked status, violations, and (for blocked songs) the preview duration. Parallel to audiosSignedUrls.","additionalProperties":false,"type":"object","required":["filename","blocked","rule_violations"],"properties":{"filename":{"description":"The AI-generated audio filename this entry describes.","type":"string"},"blocked":{"description":"True if any attribution rule was violated for this AI song. When blocked, the corresponding entry in audiosSignedUrls is a half-duration preview (or empty if the clipping pipeline is not yet wired).","type":"boolean"},"preview_duration_seconds":{"description":"Duration in seconds of the half-song preview returned for blocked audios.","type":"number"},"preview_failed_stems":{"description":"List of audios (master + stems) whose preview clip failed and will be retried on subsequent fetches. Absent/empty means all clips succeeded.","type":"array","items":{"anyOf":[{"type":"string","enum":["master"]},{"type":"string","enum":["vocals"]},{"type":"string","enum":["instrumentals"]},{"type":"string","enum":["bass"]},{"type":"string","enum":["drums"]}]}},"rule_violations":{"title":"AudioRuleEvaluationViolations","type":"array","items":{"title":"RuleViolation","description":"Describes a single attribution rule violation for a collection.","additionalProperties":false,"type":"object","required":["collection_uuid","rule","source","filename","message"],"properties":{"collection_uuid":{"type":"string"},"rule":{"description":"The rule that was violated.","anyOf":[{"type":"string","enum":["no_attribution_greater_than"]},{"type":"string","enum":["no_attribution_smaller_than"]},{"type":"string","enum":["no_shared_attribution_with_artist"]},{"type":"string","enum":["time_scoped_consent"]}]},"source":{"description":"Which attribution signal tripped the rule: recording or composition attribution.","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["composition"]}]},"filename":{"description":"The generated AI song (filename) that tripped the rule.","type":"string"},"source_stem":{"description":"Which stem tripped the rule, for per-stem rules (no_attribution_greater_than, no_attribution_smaller_than). Unset for rules whose semantics are not per-stem.","anyOf":[{"type":"string","enum":["master"]},{"type":"string","enum":["vocals"]},{"type":"string","enum":["instrumentals"]},{"type":"string","enum":["bass"]},{"type":"string","enum":["drums"]}]},"threshold":{"description":"The threshold the rule was configured with, where applicable.","type":"number"},"observed":{"description":"The observed attribution percentage, where applicable.","type":"number"},"message":{"type":"string"}}}}}}}}}]}},"lastEvaluatedKey":{"title":"LastEvaluatedKey","anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"/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":"Get the label profile data and one page of the artists associated with the label. Read a page at a time with `take` (default 20, at most 100) and resume the walk by passing the previous page's `lastEvaluatedKey` back as `cursor`; `lastEvaluatedKey` is absent on the last page. The optional `search` term matches an artist's username, a previous username, or their company name, and is served from the profile index alone: while that index is unavailable a searched read answers 503, an unsearched one is read from DynamoDB. The optional `signed_label` narrows the roster to one of the company's labels, from the same index and with the same 503. A cursor may only be carried between requests that agree on whether `search` or `signed_label` is set, and one this service cannot decode is refused: both answer 400.","parameters":[{"schema":{"minimum":1,"maximum":100,"type":"integer"},"in":"query","name":"take","required":false,"description":"The `take` parameter is the number of artists to return per page, at most 100. A searched page is read by key out of the profile table, which reads 100 keys per round trip."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"The optional `cursor` parameter is the `lastEvaluatedKey` in the previous page. A cursor belongs to the read that issued it: one issued by a searched page is refused on an unsearched read and the other way round, and one this service cannot decode is refused too, both with 400."},{"schema":{"minLength":1,"maxLength":100,"type":"string"},"in":"query","name":"search","required":false,"description":"Filter the roster to parties matching this term, on their username, a previous username, or their company name. Served from the profile index alone: while that index is unavailable a searched read answers 503, because DynamoDB cannot match a name without answering a different question. The search issues a cursor format of its own, so a `cursor` may only be carried between requests that agree on whether `search` is set: mixing the two is refused. Omit the parameter to read the whole roster: an empty term is refused rather than read as no search at all."},{"schema":{"minLength":1,"maxLength":100,"type":"string"},"in":"query","name":"signed_label","required":false,"description":"Narrow the roster to parties signed to this label, matched exactly against their `signed_labels`; the company's `sub_labels` are the values it holds. Combines with `search`, `roles` and `include_hidden`, and never reaches past the company's own roster. Served from the profile index like `search`, with the same 503 while that index is unavailable and the same cursor format: a `cursor` may only be carried between requests that agree on whether either parameter is set."},{"schema":{"type":"boolean"},"in":"query","name":"include_nilv","required":false,"description":"When true, each roster artist carries a `nilv` summary of their consent record: whether one exists, its version, when it changed and whether the artist or the label changed it. Only the label itself and users connected to it may ask for this. Requires an explicit `take` of at most 100, because the summary costs one read per artist."},{"schema":{"type":"boolean"},"in":"query","name":"include_music_consent","required":false,"description":"When true, each roster artist carries a `music_consent` summary of their music consent record, the track-level twin of `nilv`. Same boundary and the same explicit `take` requirement, because the summary costs one read per artist."},{"schema":{"type":"boolean"},"in":"query","name":"include_hidden","required":false,"description":"When true, roster artists that are not shown in the frontend are included, each carrying `show_in_frontend`. Only the label itself and users connected to it may ask for this; anyone else is refused."},{"schema":{"minItems":1,"uniqueItems":true,"type":"array","items":{"title":"RosterRoleFilter","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]}]}},"in":"query","name":"roles","required":false,"description":"Which parties the roster returns: artists, songwriters, or both, in one page stream. Artists and singer-songwriters join through the company's customer_name, songwriters through its customer_name (roster invitees) and its publisher_name; every party appears once. Omitted, the roster behaves exactly as before this parameter existed. Only the company itself and users connected to it may filter by roles, and the cursor format differs from the default one, so do not mix cursors across the two modes."},{"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"},"urlExternalWebsite":{"description":"The URL of the external website for the record label.","type":"string"},"profileDescription":{"description":"The description of the record label's profile.","type":"string"},"artists":{"title":"Artists","type":"array","items":{"title":"RosterArtistProfileData","type":"object","allOf":[{"title":"BaseProfileData","type":"object","required":["username"],"properties":{"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"auth0_id":{"type":"string"},"profile_picture_s3_key":{"type":"string"},"profile_picture_source":{"title":"ProfilePictureSource","anyOf":[{"type":"string","enum":["artist_photo"]},{"type":"string","enum":["promo_photo"]},{"type":"string","enum":["cover_art"]},{"type":"string","enum":["user_upload"]}]},"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":{"title":"UserRole","anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["ai_company"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["publisher"]}]},"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"},"publisher_name":{"type":"string"},"connected_publisher":{"type":"string"},"sureel_party_uuid":{"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"}},"signed_labels":{"title":"SignedLabels","type":"array","items":{"type":"string"}},"metrics":{"title":"Metrics","type":"object","required":["registry"],"properties":{"registry":{"title":"GetRegistryOptInOutMetricsResponse","type":"object","required":["optOutPercentage","optInPercentage","optOutAmount","optInAmount","numberOfReleases","numberOfAssets","rulesForOptIn"],"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":{"anyOf":[{"type":"string"},{"title":"OptInRulesForMetrics","type":"array","items":{"title":"OptInRulesForMetricsItem","type":"object","required":["collection_uuid","opt_in_rules"],"properties":{"collection_uuid":{"type":"string"},"collection_name":{"type":"string"},"username":{"type":"string"},"number_of_assets":{"type":"number"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}}}}}]}}}}},"external_id":{"type":"string"},"isni":{"type":"string"},"uaid":{"type":"string"},"party_id":{"type":"string"},"spotify_artist_id":{"type":"string"},"apple_artist_id":{"type":"string"},"date_of_birth":{"type":"string"},"identifiers":{"title":"ArtistIdentifiers","description":"Additional industry identifiers. A type may appear more than once, e.g. several IPIs for one artist.","type":"array","items":{"title":"ArtistIdentifier","type":"object","required":["type","value"],"properties":{"type":{"title":"IdentifierType","description":"The kind of identifier, e.g. IPI, IPN, MBID. Common industry types are listed; identifiers specific to the delivering partner's system are accepted as free strings.","anyOf":[{"type":"string","enum":["IPI"]},{"type":"string","enum":["IPN"]},{"type":"string","enum":["MBID"]},{"type":"string","enum":["DISCOGS"]},{"type":"string","enum":["WIKIDATA"]},{"type":"string","enum":["AMAZON"]},{"type":"string","enum":["DEEZER"]},{"type":"string","enum":["SONGKICK"]},{"type":"string","enum":["INSTAGRAM"]},{"type":"string","enum":["TIKTOK"]},{"type":"string","enum":["YOUTUBE"]},{"minLength":1,"type":"string"}]},"value":{"minLength":1,"description":"The identifier value, exactly as the source holds it.","type":"string"}}}},"spotify_user_id":{"type":"string"},"spotify_display_name":{"type":"string"},"verified":{"type":"boolean"},"tutorial_completed_at":{"type":"number"},"terms_accepted_at":{"description":"When the profile first accepted the terms and conditions, in epoch milliseconds. Stamped by the server on the first acceptance and never moved by a later one.","type":"number"}}},{"title":"ArtistSpecificProfileData","type":"object","properties":{"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","allOf":[{"title":"ArtistCollectionRecord","type":"object","required":["collection_uuid","username","status"],"properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"ean":{"type":"string"},"grid":{"type":"string"},"project_id":{"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_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"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"},"artist_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"}}},{"title":"AttributionSetupResponse","type":"object","properties":{"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}}}}}}]}},"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"company_name":{"description":"The name of the company/record label associated with the artist.","type":"string"},"deal_territories":{"title":"DealTerritories","description":"Territories the delivering partner's deal with this party covers, as supplied by the partner. Descriptive only: it is not evaluated for permissions.","type":"array","items":{"type":"string"}},"related_artist_names":{"title":"RelatedArtistNames","description":"Names of recording artists this party is associated with, as supplied by the delivering partner. Plain strings for display and disambiguation, deliberately not resolved to profile records.","type":"array","items":{"type":"string"}},"lastEvaluatedKey":{"type":"string"}}},{"title":"ArtistOnlyProfileData","type":"object","properties":{"user_role":{"title":"ArtistOnlyRole","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["publisher"]}]}}},{"title":"RosterArtistNilv","type":"object","properties":{"nilv":{"title":"NilvRosterSummary","additionalProperties":false,"type":"object","required":["state"],"properties":{"state":{"title":"NilvRosterSummaryState","anyOf":[{"type":"string","enum":["present"]},{"type":"string","enum":["absent"]},{"type":"string","enum":["unavailable"]}]},"record_version":{"minimum":1,"type":"integer"},"updated_at":{"type":"integer"},"updated_by":{"title":"NilvRosterUpdatedBy","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["rightsholder_rep"]}]},"updated_by_name":{"minLength":1,"type":"string"},"updated_by_username":{"minLength":1,"type":"string"},"consent":{"title":"NilvConsentResponse","additionalProperties":false,"type":"object","required":["default_decision","grants","revocations"],"properties":{"default_decision":{"title":"NilvDefaultDecisionResponse","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"grants":{"type":"array","items":{"title":"NilvGrantResponse","additionalProperties":false,"type":"object","required":["id","decision","scope","styles","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"NilvDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":5,"uniqueItems":true,"type":"array","items":{"title":"NilvScope","anyOf":[{"type":"string","enum":["name"]},{"type":"string","enum":["image"]},{"type":"string","enum":["voice"]},{"type":"string","enum":["video"]},{"type":"string","enum":["persona"]}]}},"styles":{"minItems":1,"maxItems":101,"uniqueItems":true,"type":"array","items":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}},"uses":{"maxItems":4,"uniqueItems":true,"description":"The finer-grained voice action, when the grant answers one of the dashboard's voice uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Every use is about the voice, so the grant's scope must include voice, or the write is refused with 422.","type":"array","items":{"title":"NilvAiUse","anyOf":[{"type":"string","enum":["voice_cover"]},{"type":"string","enum":["voice_translation_cover"]},{"type":"string","enum":["voice_create"]},{"type":"string","enum":["voice_create_filters"]}]}},"asset_refs":{"minItems":1,"maxItems":2001,"uniqueItems":true,"description":"Asset ids, or ['*'] for every asset in scope. A grant naming specific assets answers only questions that name one of them: it takes no part in a scope-wide question, meaning one sent without an asset_ref. That holds for a block as much as for an allow, so a scope-wide question can answer allow while a specific asset is blocked by a narrower grant, and the trace shows that grant as unmatched on asset_refs. Ask a per-asset question to get a per-asset answer.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"NilvAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":500,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"NilvGrantStatusResponse","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"NilvGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"NilvGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["rightsholder_rep"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"NilvEvidenceResponse","type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}},"revocations":{"type":"array","items":{"title":"NilvRevocation","additionalProperties":false,"type":"object","required":["grant_id","revoked_at","revoked_by","reason"],"properties":{"grant_id":{"type":"string"},"revoked_at":{"format":"date-time","type":"string"},"revoked_by":{"type":"string"},"revoked_by_username":{"minLength":1,"type":"string"},"reason":{"type":"string"}}}},"audit_log_ref":{"type":"string"}}}}},"music_consent":{"title":"MusicRosterSummary","additionalProperties":false,"type":"object","required":["state"],"properties":{"state":{"title":"MusicRosterSummaryState","anyOf":[{"type":"string","enum":["present"]},{"type":"string","enum":["absent"]},{"type":"string","enum":["unavailable"]}]},"record_version":{"minimum":1,"type":"integer"},"updated_at":{"type":"integer"},"updated_by":{"title":"MusicRosterUpdatedBy","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["publisher"]}]},"updated_by_name":{"minLength":1,"type":"string"},"updated_by_username":{"minLength":1,"type":"string"},"consent":{"title":"MusicConsent","additionalProperties":false,"type":"object","required":["default_decision","grants","revocations"],"properties":{"default_decision":{"title":"MusicDefaultDecisionStored","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"grants":{"type":"array","items":{"title":"MusicGrant","additionalProperties":false,"type":"object","required":["id","decision","scope","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"MusicDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":2,"uniqueItems":true,"description":"The track layers the grant covers: the recording (the master) and/or the publishing side (the work: composition and lyrics).","type":"array","items":{"title":"MusicScope","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"asset_refs":{"minItems":1,"maxItems":500,"uniqueItems":true,"description":"Catalog references, or ['*'] for the party's whole catalog. Party-level today; per-track references (ISRC/ISWC) are an intended later narrowing.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"description":"Training consent covers ['training']; derivative consent covers ['inference', 'output']. Stages, not the frontend's use labels, so finer-grained actions stay an additive change.","type":"array","items":{"title":"MusicLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"MusicAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"MusicPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"uses":{"maxItems":9,"uniqueItems":true,"description":"The finer-grained AI action, when the grant answers one of the dashboard's uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Each use belongs to one layer (remix_* to recording, song_* to publishing) and the grant's scope must cover it, or the write is refused with 422.","type":"array","items":{"title":"MusicAiUse","anyOf":[{"type":"string","enum":["remix_vocal_kept"]},{"type":"string","enum":["remix_different_voice"]},{"type":"string","enum":["remix_with_others"]},{"type":"string","enum":["remix_with_others_new_vocal"]},{"type":"string","enum":["remix_in_style"]},{"type":"string","enum":["song_remix"]},{"type":"string","enum":["song_translation"]},{"type":"string","enum":["song_lyric_changes"]},{"type":"string","enum":["song_lyric_changes_filters"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":200,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"MusicGrantStatus","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"MusicGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"MusicGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["publisher"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"MusicEvidence","additionalProperties":false,"type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}},"revocations":{"type":"array","items":{"title":"MusicRevocation","additionalProperties":false,"type":"object","required":["grant_id","revoked_at","revoked_by","reason"],"properties":{"grant_id":{"type":"string"},"revoked_at":{"format":"date-time","type":"string"},"revoked_by":{"type":"string"},"revoked_by_username":{"minLength":1,"type":"string"},"reason":{"type":"string"}}}}}}}},"has_login":{"type":"boolean"}}}]}},"roster":{"title":"RosterParties","type":"array","items":{"title":"RosterParty","type":"object","required":["id","org","display_name","address","roles","status","expires_at","joined_at","invited_by","username","target_username"],"properties":{"id":{"format":"uuid","type":"string"},"org":{"title":"RosterPartyOrg","type":"object","required":["id","name"],"properties":{"id":{"format":"uuid","type":"string"},"name":{"type":"string"}}},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"roles":{"type":"array","items":{"type":"string"}},"status":{"anyOf":[{"type":"string","enum":["invited"]},{"type":"string","enum":["active"]},{"type":"string","enum":["removed"]}]},"expires_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"joined_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"invited_by":{"title":"RosterInvitedBy","type":"object","required":["auth0_id","acting_as"],"properties":{"auth0_id":{"type":"string"},"username":{"type":"string"},"user_role":{"type":"string"},"acting_as":{"anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["staff"]},{"type":"string","enum":["impersonation"]},{"type":"string","enum":["system"]}]}}},"username":{"anyOf":[{"type":"string"},{"type":"null"}]},"target_username":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"metrics":{"title":"Metrics","type":"object","required":["registry"],"properties":{"registry":{"title":"GetRegistryOptInOutMetricsResponse","type":"object","required":["optOutPercentage","optInPercentage","optOutAmount","optInAmount","numberOfReleases","numberOfAssets","rulesForOptIn"],"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":{"anyOf":[{"type":"string"},{"title":"OptInRulesForMetrics","type":"array","items":{"title":"OptInRulesForMetricsItem","type":"object","required":["collection_uuid","opt_in_rules"],"properties":{"collection_uuid":{"type":"string"},"collection_name":{"type":"string"},"username":{"type":"string"},"number_of_assets":{"type":"number"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}}}}}]}}}}},"subLabels":{"title":"RosterSubLabels","description":"The labels this company holds, the values `signed_label` filters on. Sent only on a read the company itself is entitled to (`include_hidden`, `include_nilv`, `include_music_consent` or `roles`), and absent when the company lists none.","type":"array","items":{"type":"string"}},"lastEvaluatedKey":{"description":"The `lastEvaluatedKey` is used for pagination. It indicates the last item returned in the current page.","type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"BadRequestResponse","additionalProperties":true,"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string"},"message":{"type":"string"},"name":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"title":"ServiceUnavailableResponse","type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"number"},"error":{"type":"string"},"message":{"type":"string"}}}}}}}}},"/v1/ai/record-label/{labelName}/roster/{username}":{"get":{"operationId":"getRosterArtist","summary":"Get one artist on a label's roster","tags":["record-label"],"description":"One roster artist as a roster page shows them, with the org's roster rows about them, so a record opened by link does not have to walk the roster to find its artist. Needs the X-Sureel-Org header and `roster:read` on that org, plus `identity:read` for `include_nilv` and `works:read` for `include_music_consent`. An artist the org does not hold answers 404, the same as one that does not exist.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"include_nilv","required":false,"description":"When true, the artist carries the same `nilv` summary a roster page gives each artist."},{"schema":{"type":"boolean"},"in":"query","name":"include_music_consent","required":false,"description":"When true, the artist carries the same `music_consent` summary a roster page gives each artist."},{"schema":{"minLength":1,"type":"string"},"in":"path","name":"labelName","required":true},{"schema":{"minLength":1,"type":"string"},"in":"path","name":"username","required":true}],"security":[{"OAuth2":["read:ldm"]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"RosterArtistResponse","type":"object","required":["artist","roster"],"properties":{"artist":{"title":"RosterArtistProfileData","type":"object","allOf":[{"title":"BaseProfileData","type":"object","required":["username"],"properties":{"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"auth0_id":{"type":"string"},"profile_picture_s3_key":{"type":"string"},"profile_picture_source":{"title":"ProfilePictureSource","anyOf":[{"type":"string","enum":["artist_photo"]},{"type":"string","enum":["promo_photo"]},{"type":"string","enum":["cover_art"]},{"type":"string","enum":["user_upload"]}]},"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":{"title":"UserRole","anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["ai_company"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["publisher"]}]},"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"},"publisher_name":{"type":"string"},"connected_publisher":{"type":"string"},"sureel_party_uuid":{"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"}},"signed_labels":{"title":"SignedLabels","type":"array","items":{"type":"string"}},"metrics":{"title":"Metrics","type":"object","required":["registry"],"properties":{"registry":{"title":"GetRegistryOptInOutMetricsResponse","type":"object","required":["optOutPercentage","optInPercentage","optOutAmount","optInAmount","numberOfReleases","numberOfAssets","rulesForOptIn"],"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":{"anyOf":[{"type":"string"},{"title":"OptInRulesForMetrics","type":"array","items":{"title":"OptInRulesForMetricsItem","type":"object","required":["collection_uuid","opt_in_rules"],"properties":{"collection_uuid":{"type":"string"},"collection_name":{"type":"string"},"username":{"type":"string"},"number_of_assets":{"type":"number"},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}}}}}]}}}}},"external_id":{"type":"string"},"isni":{"type":"string"},"uaid":{"type":"string"},"party_id":{"type":"string"},"spotify_artist_id":{"type":"string"},"apple_artist_id":{"type":"string"},"date_of_birth":{"type":"string"},"identifiers":{"title":"ArtistIdentifiers","description":"Additional industry identifiers. A type may appear more than once, e.g. several IPIs for one artist.","type":"array","items":{"title":"ArtistIdentifier","type":"object","required":["type","value"],"properties":{"type":{"title":"IdentifierType","description":"The kind of identifier, e.g. IPI, IPN, MBID. Common industry types are listed; identifiers specific to the delivering partner's system are accepted as free strings.","anyOf":[{"type":"string","enum":["IPI"]},{"type":"string","enum":["IPN"]},{"type":"string","enum":["MBID"]},{"type":"string","enum":["DISCOGS"]},{"type":"string","enum":["WIKIDATA"]},{"type":"string","enum":["AMAZON"]},{"type":"string","enum":["DEEZER"]},{"type":"string","enum":["SONGKICK"]},{"type":"string","enum":["INSTAGRAM"]},{"type":"string","enum":["TIKTOK"]},{"type":"string","enum":["YOUTUBE"]},{"minLength":1,"type":"string"}]},"value":{"minLength":1,"description":"The identifier value, exactly as the source holds it.","type":"string"}}}},"spotify_user_id":{"type":"string"},"spotify_display_name":{"type":"string"},"verified":{"type":"boolean"},"tutorial_completed_at":{"type":"number"},"terms_accepted_at":{"description":"When the profile first accepted the terms and conditions, in epoch milliseconds. Stamped by the server on the first acceptance and never moved by a later one.","type":"number"}}},{"title":"ArtistSpecificProfileData","type":"object","properties":{"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","allOf":[{"title":"ArtistCollectionRecord","type":"object","required":["collection_uuid","username","status"],"properties":{"collection_uuid":{"type":"string"},"username":{"type":"string"},"old_usernames":{"type":"array","items":{"type":"string"}},"collection_name":{"type":"string"},"collection_description":{"type":"string"},"upc":{"type":"string"},"ean":{"type":"string"},"grid":{"type":"string"},"project_id":{"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_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"embeddings_s3_key":{"type":"string"},"embeddings_s3_keys":{"title":"EmbeddingsS3Keys","type":"array","items":{"type":"string"}},"synthesis_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"opt_in_rules":{"title":"OptInRules","description":"Rules for opting in of AI training, including specific consents and restrictions.","additionalProperties":false,"type":"object","properties":{"ai_company_scoped_consent":{"title":"AiCompanyScopedConsent","description":"List of AI company-specific consent rules.","type":"array","items":{"title":"AiCompanyScopedConsent","additionalProperties":false,"type":"object","required":["ai_company_name","allow_ai_training"],"properties":{"ai_company_name":{"description":"The name of the AI company. Must match an existing AI company in the system.","type":"string"},"allow_ai_training":{"description":"Whether to allow AI training for this specific AI company.","type":"boolean"},"_delete":{"description":"Set to true to remove this AI company consent entry during a merge update.","type":"boolean"}}}},"time_scoped_consent":{"title":"TimeScopedConsent","description":"Time range during which AI training consent is valid.","additionalProperties":false,"type":"object","properties":{"start_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The start UNIX timestamp (in milliseconds) from which AI training consent is valid.","type":"integer"},"end_timestamp":{"minimum":1000000000000,"maximum":9999999999999,"description":"The end UNIX timestamp (in milliseconds) until which AI training consent is valid.","type":"integer"}}},"no_attribution_greater_than":{"description":"No attribution greater than x% for any AI generated music.","type":"number"},"no_attribution_smaller_than":{"description":"No attribution smaller than x% if music in your style is requested.","type":"number"},"no_shared_attribution_with_artist":{"description":"No shared attribution with artist xyz.","type":"string"},"no_shared_attribution_with_genre":{"description":"No shared attribution with genre xyz.","type":"string"},"allow_cover_art_in_motion_picture":{"description":"Allow using cover art in motion picture productions.","type":"boolean"},"allow_lyrics":{"description":"Allow using lyrics for AI training.","type":"boolean"}}},"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"},"artist_role":{"type":"string"},"artist_isni":{"type":"string"},"artist_uaid":{"type":"string"},"artist_party_id":{"type":"string"},"artist_spotify_id":{"type":"string"},"artist_apple_id":{"type":"string"},"artist_date_of_birth":{"type":"string"}}}},"number_of_assets":{"type":"number"},"backfill_timestamp":{"type":"number"}}},{"title":"AttributionSetupResponse","type":"object","properties":{"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["duration","period","values"],"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","required":["filename","values"],"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"}}}}}}}}}}}},"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","required":["master","instrumentals","vocals","bass","drums"],"properties":{"master":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"instrumentals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"vocals":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"bass":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}},"drums":{"title":"AIDetectionResultPerStem","type":"array","items":{"title":"AIDetectionResultPerStemInner","type":"object","required":["filename","duration","period"],"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","required":["average_probability","max_probability","per_segment_probabilities"],"properties":{"average_probability":{"type":"number"},"max_probability":{"type":"number"},"per_segment_probabilities":{"title":"PerSegmentProbabilities","type":"array","items":{"type":"number"}}}}},{"type":"null"}]}}}}}}}}]}},"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","required":["trackName","histogramValues"],"properties":{"artistName":{"type":"string"},"albumName":{"type":"string"},"trackName":{"type":"string"},"originalSong":{"type":"string"},"histogramValues":{"title":"HistogramValues","type":"object","required":["master"],"properties":{"master":{"title":"HistogramValuesPerChunk","type":"array","items":{"title":"HistogramValuesPerChunkInner","type":"object","required":["duration","period","values"],"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","required":["binStart","binEnd","count"],"properties":{"binStart":{"type":"number"},"binEnd":{"type":"number"},"count":{"title":"Count","type":"array","items":{"type":"number"}}}}}}}}}}}}},"company_name":{"description":"The name of the company/record label associated with the artist.","type":"string"},"deal_territories":{"title":"DealTerritories","description":"Territories the delivering partner's deal with this party covers, as supplied by the partner. Descriptive only: it is not evaluated for permissions.","type":"array","items":{"type":"string"}},"related_artist_names":{"title":"RelatedArtistNames","description":"Names of recording artists this party is associated with, as supplied by the delivering partner. Plain strings for display and disambiguation, deliberately not resolved to profile records.","type":"array","items":{"type":"string"}},"lastEvaluatedKey":{"type":"string"}}},{"title":"ArtistOnlyProfileData","type":"object","properties":{"user_role":{"title":"ArtistOnlyRole","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["label"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["publisher"]}]}}},{"title":"RosterArtistNilv","type":"object","properties":{"nilv":{"title":"NilvRosterSummary","additionalProperties":false,"type":"object","required":["state"],"properties":{"state":{"title":"NilvRosterSummaryState","anyOf":[{"type":"string","enum":["present"]},{"type":"string","enum":["absent"]},{"type":"string","enum":["unavailable"]}]},"record_version":{"minimum":1,"type":"integer"},"updated_at":{"type":"integer"},"updated_by":{"title":"NilvRosterUpdatedBy","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["rightsholder_rep"]}]},"updated_by_name":{"minLength":1,"type":"string"},"updated_by_username":{"minLength":1,"type":"string"},"consent":{"title":"NilvConsentResponse","additionalProperties":false,"type":"object","required":["default_decision","grants","revocations"],"properties":{"default_decision":{"title":"NilvDefaultDecisionResponse","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"grants":{"type":"array","items":{"title":"NilvGrantResponse","additionalProperties":false,"type":"object","required":["id","decision","scope","styles","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"NilvDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["license_required"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":5,"uniqueItems":true,"type":"array","items":{"title":"NilvScope","anyOf":[{"type":"string","enum":["name"]},{"type":"string","enum":["image"]},{"type":"string","enum":["voice"]},{"type":"string","enum":["video"]},{"type":"string","enum":["persona"]}]}},"styles":{"minItems":1,"maxItems":101,"uniqueItems":true,"type":"array","items":{"minLength":1,"title":"NilvStyleRef","description":"A style id from the record's styles[], or '*' for all eras.","type":"string"}},"uses":{"maxItems":4,"uniqueItems":true,"description":"The finer-grained voice action, when the grant answers one of the dashboard's voice uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Every use is about the voice, so the grant's scope must include voice, or the write is refused with 422.","type":"array","items":{"title":"NilvAiUse","anyOf":[{"type":"string","enum":["voice_cover"]},{"type":"string","enum":["voice_translation_cover"]},{"type":"string","enum":["voice_create"]},{"type":"string","enum":["voice_create_filters"]}]}},"asset_refs":{"minItems":1,"maxItems":2001,"uniqueItems":true,"description":"Asset ids, or ['*'] for every asset in scope. A grant naming specific assets answers only questions that name one of them: it takes no part in a scope-wide question, meaning one sent without an asset_ref. That holds for a block as much as for an allow, so a scope-wide question can answer allow while a specific asset is blocked by a narrower grant, and the trace shows that grant as unmatched on asset_refs. Ask a per-asset question to get a per-asset answer.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"NilvAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"NilvPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":500,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"NilvGrantStatusResponse","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"NilvGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"NilvGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["rightsholder_rep"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"NilvEvidenceResponse","type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}},"revocations":{"type":"array","items":{"title":"NilvRevocation","additionalProperties":false,"type":"object","required":["grant_id","revoked_at","revoked_by","reason"],"properties":{"grant_id":{"type":"string"},"revoked_at":{"format":"date-time","type":"string"},"revoked_by":{"type":"string"},"revoked_by_username":{"minLength":1,"type":"string"},"reason":{"type":"string"}}}},"audit_log_ref":{"type":"string"}}}}},"music_consent":{"title":"MusicRosterSummary","additionalProperties":false,"type":"object","required":["state"],"properties":{"state":{"title":"MusicRosterSummaryState","anyOf":[{"type":"string","enum":["present"]},{"type":"string","enum":["absent"]},{"type":"string","enum":["unavailable"]}]},"record_version":{"minimum":1,"type":"integer"},"updated_at":{"type":"integer"},"updated_by":{"title":"MusicRosterUpdatedBy","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["publisher"]}]},"updated_by_name":{"minLength":1,"type":"string"},"updated_by_username":{"minLength":1,"type":"string"},"consent":{"title":"MusicConsent","additionalProperties":false,"type":"object","required":["default_decision","grants","revocations"],"properties":{"default_decision":{"title":"MusicDefaultDecisionStored","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"grants":{"type":"array","items":{"title":"MusicGrant","additionalProperties":false,"type":"object","required":["id","decision","scope","asset_refs","lifecycle_stages","ai_companies","purposes","valid_from","valid_until","license_terms_ref","pricing","supersedes","status","granted_by","evidence"],"properties":{"id":{"minLength":1,"type":"string"},"decision":{"title":"MusicDecision","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["block"]},{"type":"string","enum":["review_required"]}]},"scope":{"minItems":1,"maxItems":2,"uniqueItems":true,"description":"The track layers the grant covers: the recording (the master) and/or the publishing side (the work: composition and lyrics).","type":"array","items":{"title":"MusicScope","anyOf":[{"type":"string","enum":["recording"]},{"type":"string","enum":["publishing"]}]}},"asset_refs":{"minItems":1,"maxItems":500,"uniqueItems":true,"description":"Catalog references, or ['*'] for the party's whole catalog. Party-level today; per-track references (ISRC/ISWC) are an intended later narrowing.","type":"array","items":{"minLength":1,"type":"string"}},"lifecycle_stages":{"minItems":1,"maxItems":4,"uniqueItems":true,"description":"Training consent covers ['training']; derivative consent covers ['inference', 'output']. Stages, not the frontend's use labels, so finer-grained actions stay an additive change.","type":"array","items":{"title":"MusicLifecycleStage","anyOf":[{"type":"string","enum":["training"]},{"type":"string","enum":["inference"]},{"type":"string","enum":["output"]},{"type":"string","enum":["distribution"]}]}},"ai_companies":{"minItems":1,"maxItems":250,"uniqueItems":true,"type":"array","items":{"title":"MusicAiCompanyRef","additionalProperties":false,"type":"object","required":["id"],"properties":{"id":{"minLength":1,"description":"AI company id, or '*' for every company.","type":"string"}}}},"purposes":{"minItems":1,"maxItems":4,"uniqueItems":true,"type":"array","items":{"title":"MusicPurpose","anyOf":[{"type":"string","enum":["commercial_music_generation"]},{"type":"string","enum":["editorial"]},{"type":"string","enum":["satire"]},{"type":"string","enum":["educational"]}]}},"uses":{"maxItems":9,"uniqueItems":true,"description":"The finer-grained AI action, when the grant answers one of the dashboard's uses. Absent: the coarse stage grant. Empty: every use. A request naming a use matches grants carrying `uses`, and coarse grants that restrict (anything but allow), so naming a use never gets past a restriction. Each use belongs to one layer (remix_* to recording, song_* to publishing) and the grant's scope must cover it, or the write is refused with 422.","type":"array","items":{"title":"MusicAiUse","anyOf":[{"type":"string","enum":["remix_vocal_kept"]},{"type":"string","enum":["remix_different_voice"]},{"type":"string","enum":["remix_with_others"]},{"type":"string","enum":["remix_with_others_new_vocal"]},{"type":"string","enum":["remix_in_style"]},{"type":"string","enum":["song_remix"]},{"type":"string","enum":["song_translation"]},{"type":"string","enum":["song_lyric_changes"]},{"type":"string","enum":["song_lyric_changes_filters"]}]}},"valid_from":{"format":"date","description":"Inclusive, YYYY-MM-DD.","type":"string"},"valid_until":{"description":"Inclusive, or null for open-ended.","anyOf":[{"format":"date","type":"string"},{"type":"null"}]},"license_terms_ref":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"pricing":{"anyOf":[{"title":"NilvPricing","additionalProperties":false,"type":"object","required":["model","currency","amount","minimum_guarantee","revshare_percent"],"properties":{"model":{"title":"NilvPricingModel","anyOf":[{"type":"string","enum":["per_use"]},{"type":"string","enum":["subscription"]},{"type":"string","enum":["revshare"]},{"type":"string","enum":["flat_fee"]}]},"currency":{"minLength":3,"maxLength":3,"type":"string"},"amount":{"minimum":0,"type":"number"},"minimum_guarantee":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}]},"revshare_percent":{"anyOf":[{"exclusiveMinimum":0,"maximum":100,"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"supersedes":{"maxItems":200,"uniqueItems":true,"type":"array","items":{"type":"string"}},"notes":{"type":"string"},"status":{"title":"MusicGrantStatus","anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["superseded"]}]},"granted_by":{"title":"MusicGrantedBy","additionalProperties":false,"type":"object","required":["role","entity_id","entity_name","verified_via","timestamp"],"properties":{"role":{"title":"MusicGrantorRoleStored","anyOf":[{"type":"string","enum":["artist"]},{"type":"string","enum":["songwriter"]},{"type":"string","enum":["singer_songwriter"]},{"type":"string","enum":["label"]},{"type":"string","enum":["publisher"]}]},"entity_id":{"type":"string"},"entity_name":{"type":"string"},"acting_username":{"minLength":1,"type":"string"},"verified_via":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}}},"evidence":{"anyOf":[{"title":"MusicEvidence","additionalProperties":false,"type":"object","properties":{"agreement_uri":{"type":"string"},"signature_ref":{"type":"string"}}},{"type":"null"}]}}}},"revocations":{"type":"array","items":{"title":"MusicRevocation","additionalProperties":false,"type":"object","required":["grant_id","revoked_at","revoked_by","reason"],"properties":{"grant_id":{"type":"string"},"revoked_at":{"format":"date-time","type":"string"},"revoked_by":{"type":"string"},"revoked_by_username":{"minLength":1,"type":"string"},"reason":{"type":"string"}}}}}}}},"has_login":{"type":"boolean"}}}]},"roster":{"title":"RosterArtistParties","type":"array","items":{"title":"RosterParty","type":"object","required":["id","org","display_name","address","roles","status","expires_at","joined_at","invited_by","username","target_username"],"properties":{"id":{"format":"uuid","type":"string"},"org":{"title":"RosterPartyOrg","type":"object","required":["id","name"],"properties":{"id":{"format":"uuid","type":"string"},"name":{"type":"string"}}},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"roles":{"type":"array","items":{"type":"string"}},"status":{"anyOf":[{"type":"string","enum":["invited"]},{"type":"string","enum":["active"]},{"type":"string","enum":["removed"]}]},"expires_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"joined_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"invited_by":{"title":"RosterInvitedBy","type":"object","required":["auth0_id","acting_as"],"properties":{"auth0_id":{"type":"string"},"username":{"type":"string"},"user_role":{"type":"string"},"acting_as":{"anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["staff"]},{"type":"string","enum":["impersonation"]},{"type":"string","enum":["system"]}]}}},"username":{"anyOf":[{"type":"string"},{"type":"null"}]},"target_username":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"title":"BadRequestResponse","additionalProperties":true,"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string"},"message":{"type":"string"},"name":{"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":"record-label","description":"Music rights partners like record labels, publishers, and distributors"},{"name":"artist","description":"Artist profiles, collections, and catalog management"},{"name":"asset-metadata","description":"Metadata management for audio and media assets"},{"name":"ai-model-artifacts","description":"AI model artifacts tracking"},{"name":"ai-company","description":"AI company partnerships"}]}