Every API here is available over the APIs.io API and to AI agents over MCP.
{
"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.net",
"description": "OVC"
}
],
"paths": {
"/api/changeaudiofile": {
"post": {
"summary": "Change Audio File",
"operationId": "ChangeAudioFile",
"tags": ["Audio Management"],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FileChangeReqModel"
}
}
}
},
"parameters": [
{
"name": "Authorization",
"in": "header",
"required": true,
"schema": {
"type": "string"
},
"description": "Bearer token for authentication.",
"example": "Bearer eyJhbGciOiJIUzI1NiIsInR5cC..."
}
],
"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.0
},
"speed": {
"type": "number",
"format": "float",
"description": "Speed adjustment value.",
"example": 1.0
},
"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."
}
}
}
}
}
}