api.vdsluis.net

Each endpoint requires Bearer Authorization using your 32-byte API key.

/tts Text-to-speech
/detect-person Analyzes the uploaded image to see if a person is visible.

GET /v1/tts

Creates a text-to-speech audio sample in MP3-format in a semi-Flemish calm accent. Works with most languages, but is optimized for Dutch/Flemish.
Returns a binary in MP3 format.
Request:

{
  "text": "Pa's wijze lynx, bezag vroom het fikse aquaduct."
}

Response on success:
200 OK binary

Response on failure:
500 Internal Server Error

{
  "success": false,
  "errorcode": 101,
  "errormsg": "Unable to create audio file."
}

Possible error codes:
101: Unable to create audio file.
102: No text, or invalid text, provided.

POST /v1/detect-person

Analyzes the uploaded image to see if a person is visible. Returns a JSON-object with key "person_visible", containing boolean true in case a person is visible, false if not or string "unknown" if the AI-response is not clear. See the message response for more info.
Request:
POST "file" with multipart encoding.
Response on success:

200 OK

{
  "success": true,
  "person_visible": false,
  "message": "No, there is no person visible in this image."
}

Response on failure:
500 Internal Server Error

{
  "success": false,
  "errorcode": 103,
  "errormsg": "No file uploaded."
}

Possible error codes:
103: No file uploaded.
104: Uploaded file is not in JPEG format.