import type * as ElevenLabs from "../../../../index"; /** * @example * {} */ export interface BodyComposeMusicWithADetailedResponseV1MusicDetailedPost { /** Output format of the generated audio. Formatted as codec_sample_rate_bitrate. Use "auto" (the default) to let the API pick the best format for the selected model: mp3_44100_128 for v1 models and mp3_48000_192 for v2 models. */ outputFormat?: ElevenLabs.MusicComposeDetailedRequestOutputFormat; /** A simple text prompt to generate a song from. Cannot be used in conjunction with `composition_plan`. */ prompt?: string; /** A detailed composition plan to guide music generation. Cannot be used in conjunction with `prompt`. */ compositionPlan?: ElevenLabs.BodyComposeMusicWithADetailedResponseV1MusicDetailedPostCompositionPlan; /** The length of the song to generate in milliseconds. Used only in conjunction with `prompt`. Must be between 3000ms and 600000ms. Optional - if not provided, the model will choose a length based on the prompt. */ musicLengthMs?: number; /** The model to use for the generation. */ modelId?: ElevenLabs.BodyComposeMusicWithADetailedResponseV1MusicDetailedPostModelId; /** Random seed to initialize the music generation process. Providing the same seed with the same parameters can help achieve more consistent results, but exact reproducibility is not guaranteed and outputs may change across system updates. Cannot be used in conjunction with prompt. */ seed?: number; /** If true, guarantees that the generated song will be instrumental. If false, the song may or may not be instrumental depending on the `prompt`. Can only be used with `prompt`. */ forceInstrumental?: boolean; /** Controls how strictly section durations in the `composition_plan` are enforced. Only used with `composition_plan` and only applies to `music_v1`; for `music_v2` section durations are always enforced and this is ignored. When false for `music_v1`, the model may adjust individual section durations for better quality and latency, while preserving the total song duration from the plan. */ respectSectionsDurations?: boolean; /** Whether to store the generated song for inpainting. */ storeForInpainting?: boolean; /** Whether to return the timestamps of the words in the generated song. */ withTimestamps?: boolean; /** Whether to sign the generated song with C2PA. Applicable only for mp3 files. */ signWithC2Pa?: boolean; }