Request Video Conversion

Requesting an AI enhanced video conversion is a simple post request, allowing ease of use in your current workflow.

Endpoint

https://api.motovizion.ai/video/

Request Format

HTTP Method:

Copy

POST

Content-Type:

Copy

application/json

Request Body:

Parameter	Type	Required	Description
appointment_uuid	String	Yes	The unique identifier for the appointment.
video_url	String	Yes	Raw video URL in .mp4 format
translate_to	String	No	Language to ouput video in.
voice	String	No	Voice selection
type	String	No	Allows you to remove background noise, or enhance with AI

Making an Authorized API Request

curl -X POST https://api.motovizion.ai/customer/chat/ \
-H "Content-Type: application/json" \
-H "X-API-Key: {API Key}" \
-d '{
    "appointment_uuid": "{Appointment ID}"
    "video_url": "{https://yoursite.com/video.mp4}"
    "translate_to": "{spanish}"
    "voice": "{Billy Bob}"
    "type":"{Blank for AI Enhancement, Use `noise` to just remove background noise}",
}'

Error Responses

If your API key is missing or invalid, the server will respond with an error

Missing API Key

{
    "status": "error",
    "response": "Invalid API Key"
}

Invalid API Key

{
    "status": "error",
    "response": "Unauthorized"
}

Code Examples

Python

import requests
import json

# API endpoint
url = 'https://api.motovizion.ai/video/'

# Input data
video_url = 'https://example.com/video.mp4'
translate_to = 'spanish'  # Change to 'none' if no translation is required
voice = 'Billy Bob'
appointment_uuid = ''

# Set API key
api_key = ''

# Prepare the data to send
data = {
    'appointment_uuid': appointment_uuid,
    'video_url': video_url,
    'translate_to': translate_to,
    'voice': voice
}

# Set headers
headers = {
    'Content-Type': 'application/json',
    'X-API-Key': api_key,
    'Accept': 'application/json'
}

try:
    # Make the POST request
    response = requests.post(url, data=json.dumps(data), headers=headers)

    # Check for HTTP errors
    response.raise_for_status()

    # Parse the JSON response
    response_data = response.json()
    print("Response:", json.dumps(response_data, indent=4))

except requests.exceptions.RequestException as e:
    # Handle any errors that occur during the request
    print("Error:", e)

PHP

NodeJS

cURL

Response Data

When you send a valid request to the Motovizion AI API, the response contains structured JSON data. Below is a detailed explanation of the fields included in the response.

{
  "status": "success",
  "cleaned_transcription": "Walking around a 2020 Jeep Grand Cherokee Laredo, the tires look good, the air filter did need to be replaced, plugs and wires looked good. Overall it was satisfactory service.",
  "final_video_path": "api.motovizion.ai/video/complete/video.mp4",
  "video_no_audio_path": "api.motovizion.ai/video/raw/video.mp4"
}

Response Details

Top-Level Fields:

Field Name	Type	Desciption
status	String	Indicates the success ("success") or failure ("error") of the request.

Video Details

Field Name	Type	Description
cleaned_transcription	String	The full transcription of enhanced video.
final_video_path	String	The final video path for use in application.
video_no_audio_path	String	Video path with no audio, used to make transcription edits.

Error Codes

HTTP Status Code	Description
400	Missing required fields (e.g., appointment_uuid).
401	Invalid or missing API key.
500	Server error