> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Upload and Cover Audio > Transform audio tracks into new styles while preserving the original melody 1. After submission, a `task_id` will be returned. If you provided a `callback_url`, when the task status becomes `finished` or `failed`, a POST request will be sent to the `callback_url`. 2. Regardless of whether `callback_url` is provided, you can retrieve the response result through the unified [Query Music Detail](/api-manual/music-series/query-music-detail) endpoint. ## Usage Guide * This endpoint transforms an uploaded audio track into a new style while preserving the original melody * Upload your audio file and specify the desired transformation style * The original melody and structure are maintained while applying new musical characteristics ## Parameter Details * **Audio Upload Requirement**: * The uploaded audio must not exceed **8 minutes** in length * **Note**: For the V4\_5ALL model, the uploaded audio must not exceed **1 minute** in length * Provide a valid URL pointing to your audio file via `upload_url` * In Custom Mode ( `custom_mode: true` ): * `style` and `title` are **required** * `prompt` is **required** if `instrumental` is `false` * Character limits vary by model: * **V4**: `prompt` 3000 characters, `style` 200 characters, `title` 80 characters * **V4\_5 & V4\_5PLUS**: `prompt` 5000 characters, `style` 1000 characters, `title` 100 characters * **V4\_5ALL**: `prompt` 5000 characters, `style` 1000 characters, `title` 80 characters * **V5**: `prompt` 5000 characters, `style` 1000 characters, `title` 100 characters * In Non-custom Mode ( `custom_mode: false` ): * `prompt` is **required** to describe the desired transformation (max 500 characters) * `style` and `title` should be left empty ## Developer Notes * Ensure your audio URL is publicly accessible and the file is under 8 minutes (1 minute for V4\_5ALL) * For best results, use high-quality source audio with clear melody lines * The `audio_weight` parameter can help balance between preserving the original and applying the new style ## Optional parameters * `negative_tags` (string): Music styles or characteristics to exclude from the cover. * `vocal_gender` (string): Vocal gender preference. Use `m` for male, `f` for female. Note: This parameter increases the probability but cannot guarantee adherence. * `style_weight` (number): Strength of adherence to the new style. Range 0-1, up to 2 decimals. * `weirdness_constraint` (number): Controls creative deviation. Range 0-1, up to 2 decimals. * `audio_weight` (number): Balance weight for preserving original audio features. Range 0-1, up to 2 decimals. * `persona_id` (string): Persona ID to apply to the covered track. How to generate persona\_id, visit [generate-persona](/api-manual/music-series/generate-persona). ## OpenAPI ````yaml /api-manual/music-series/upload-and-cover-audio.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Upload and Cover Audio API description: Transform audio tracks into new styles while preserving the original melody version: 1.0.0 servers: - url: https://api.vidgo.ai description: Production server security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Audio Cover summary: Submit Upload and Cover Audio Task description: >- Transform audio tracks into new styles while preserving the original melody operationId: submitUploadCoverAudioTask requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SubmitRequest' examples: custom-mode: summary: Custom Mode - Full Control value: model: upload-and-cover-audio callback_url: https://your-domain.com/callback input: upload_url: https://example.com/audio/my-track.mp3 prompt: Transform into an upbeat electronic dance version style: EDM, Electronic title: Dance Remix custom_mode: true instrumental: false mv: V5 negative_tags: Slow, Sad style_weight: 0.8 simple-mode: summary: Simple Mode - Basic Cover value: model: upload-and-cover-audio callback_url: https://your-domain.com/callback input: upload_url: https://example.com/audio/my-track.mp3 prompt: Create a jazz version of this track custom_mode: false instrumental: false mv: V4_5PLUS instrumental: summary: Instrumental Cover value: model: upload-and-cover-audio callback_url: https://your-domain.com/callback input: upload_url: https://example.com/audio/my-track.mp3 prompt: Epic orchestral transformation style: Orchestral, Cinematic title: Epic Orchestra Version custom_mode: true instrumental: true mv: V5 responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/SubmitResponse' components: schemas: SubmitRequest: type: object required: - model - input properties: model: type: string description: |- API model identifier. Must be `upload-and-cover-audio` for this endpoint. enum: - upload-and-cover-audio example: upload-and-cover-audio callback_url: type: string format: uri description: |- Webhook callback URL for result notifications. Endpoint that receives task completion updates. example: https://your-domain.com/callback input: type: object required: - upload_url - prompt - custom_mode - instrumental - mv description: Input parameters for audio cover generation properties: upload_url: type: string format: uri description: >- The URL for uploading audio files, required regardless of whether `custom_mode` and `instrumental` are true or false. Ensure the uploaded audio does not exceed 8 minutes in length. **Note**: For the V4_5ALL model, the uploaded audio must not exceed 1 minute in length. example: https://example.com/audio/my-track.mp3 prompt: type: string description: >- Description of the desired style transformation. - In Custom Mode ( `custom_mode: true` ): Required if `instrumental` is `false`. The prompt will be used as the lyrics content. - In Non-custom Mode ( `custom_mode: false` ): Always required. The prompt serves as the core idea for transformation. Character limits by model: - **V4**: Maximum 3000 characters - **V4_5 & V4_5PLUS**: Maximum 5000 characters - **V4_5ALL**: Maximum 5000 characters - **V5**: Maximum 5000 characters maxLength: 5000 example: Transform into an upbeat electronic dance version style: type: string description: |- Music style specification for the cover version. Required when `custom_mode` is `true`. Character limits by model: - **V4**: Maximum 200 characters - **V4_5 & V4_5PLUS**: Maximum 1000 characters - **V4_5ALL**: Maximum 1000 characters - **V5**: Maximum 1000 characters maxLength: 200 example: EDM, Electronic title: type: string description: |- Title for the covered track. Required when `custom_mode` is `true`. Character limits by model: - **V4**: Maximum 80 characters - **V4_5 & V4_5PLUS**: Maximum 100 characters - **V4_5ALL**: Maximum 80 characters - **V5**: Maximum 100 characters maxLength: 80 example: Dance Remix custom_mode: type: boolean description: >- Enable advanced parameter customization mode. - When `true`: Enables full control over style, title, and other parameters. `style` and `title` become required fields. - When `false`: Simplified mode where only `prompt` is needed for style transformation. example: true instrumental: type: boolean description: >- Specifies whether the output should be instrumental (no vocals). - When `true`: Produces pure instrumental track without any vocals. - When `false`: Generates music with vocals based on the original track. example: false mv: type: string description: >- AI model version for audio cover generation. - **V5**: Superior musical expression, faster generation. - **V4_5PLUS**: V4_5PLUS delivers richer sound, new ways to create, max 8 min. - **V4_5**: V4_5 enables smarter prompts, faster generations, max 8 min. - **V4_5ALL**: V4_5ALL enables smarter prompts, faster generations, max 8 min. - **V4**: V4 improves vocal quality, max 4 min. enum: - V4 - V4_5 - V4_5ALL - V4_5PLUS - V5 example: V5 negative_tags: type: string description: >- Music styles or characteristics to exclude from the cover. Specify unwanted genres, moods, or instruments to avoid in the output. example: Slow, Sad vocal_gender: type: string description: >- Preferred vocal gender for the cover version. - `m`: Male vocals - `f`: Female vocals Only effective when `instrumental` is `false`. **Note**: This parameter increases the probability but cannot guarantee the specified gender. enum: - m - f example: f style_weight: type: number description: >- Controls how strongly the specified style influences the cover. Range: 0-1, up to 2 decimals. Higher values result in stronger adherence to the specified style. minimum: 0 maximum: 1 example: 0.8 weirdness_constraint: type: number description: >- Controls the level of experimental creativity and unconventional elements. Range: 0-1, up to 2 decimals. - Lower values: More conventional music - Higher values: More experimental and unique outputs minimum: 0 maximum: 1 example: 0.5 audio_weight: type: number description: >- Balances how much the original audio characteristics are preserved. Range: 0-1, up to 2 decimals. Higher values preserve more of the original melody and structure. minimum: 0 maximum: 1 example: 0.7 persona_id: type: string description: >- Persona ID to apply to the covered track. Only available when Custom Mode ( `custom_mode: true` ) is enabled. Use this to apply a specific persona style to your audio cover. How to generate persona_id, visit [generate-persona](/api-manual/music-series/generate-persona). example: persona_456 SubmitResponse: type: object required: - code - data properties: code: type: integer example: 200 description: HTTP status code data: type: object required: - task_id - status - created_time properties: task_id: type: string example: task-unified-1757165031-uyujaw3d description: Unique task identifier for status tracking status: type: string enum: - not_started example: not_started description: Initial task status created_time: type: string format: date-time example: '2025-11-12T10:30:00' description: ISO 8601 timestamp when the task was created securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- All API endpoints require Bearer Token authentication Get your API Key: Visit the [API Key Management Page](https://vidgo.ai/apis/dashboard/api-key) to get your API Key Add it to the request header: ``` Authorization: Bearer VIDGO_API_KEY ``` ````