> ## Documentation Index
> Fetch the complete documentation index at: https://api.fineshare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Step 3: Start Audio Conversion



## OpenAPI

````yaml POST /api/changeaudiofile
openapi: 3.0.1
info:
  title: 'Step 3: Start Audio Conversion'
  version: 1.0.0
  description: API for modifying an audio file with various transformation parameters.
servers:
  - url: https://voiceai.fineshare.com
    description: OVC
security: []
paths:
  /api/changeaudiofile:
    post:
      tags:
        - Audio Management
      summary: Change Audio File
      operationId: ChangeAudioFile
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
          description: Bearer token for authentication.
          example: Bearer eyJhbGciOiJIUzI1NiIsInR5cC...
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FileChangeReqModel'
      responses:
        '200':
          description: Audio file transformed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChangeAudioFileResponse'
        '400':
          description: Bad request - missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
        '401':
          description: Unauthorized - invalid or missing Authorization header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
        '500':
          description: Server error - unable to process the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
components:
  schemas:
    FileChangeReqModel:
      type: object
      properties:
        uuid:
          type: string
          description: Unique identifier of the audio file.
          example: task_id
        voice:
          type: string
          description: Voice type for transformation.
          example: spongebob
        pitch:
          type: number
          format: float
          description: Pitch adjustment value.
          example: 0
        speed:
          type: number
          format: float
          description: Speed adjustment value.
          example: 1
        from:
          type: string
          enum:
            - fv-file-changer
          description: Source format or language.
          example: fv-file-changer
        outputFormat:
          type: string
          description: Desired output format for the audio file.
          example: .mp3
        audioName:
          type: string
          description: Name of the audio file.
          example: sample_audio
        platform:
          type: string
          description: Platform information for the transformation.
          example: web
        pitch_control:
          type: string
          description: Advanced pitch control settings.
          example: semi-tone
        operation:
          type: string
          enum:
            - FVC
          description: Type of operation to perform.
          example: FVC
        engine:
          type: string
          enum:
            - v5
            - v7
          description: Engine used for processing.
          example: v5
        auto_f0_adjust:
          type: boolean
          description: Indicates if automatic F0 adjustment is applied.
          example: true
    ChangeAudioFileResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        message:
          type: string
          example: Audio file transformed successfully.
        data:
          type: object
          properties:
            audioUrl:
              type: string
              example: http://example.com/transformed_audio.mp3
            processingTime:
              type: integer
              description: Time taken to process the audio in milliseconds.
              example: 1500
    ErrorModel:
      type: object
      properties:
        error:
          type: string
          example: Invalid parameters.
        details:
          type: string
          example: The 'pitch' parameter must be a positive number.

````