V-Spark Online Help

Web Services Audio Upload

Audio files can also be uploaded using a POST request made to V‑Spark 's /transcribe API with the audio data to be decoded. File size is limited according to your system's configuration. The default limit is 250 MB. POST must be encoded as a multi-part/form-data request, with the audio to be decoded in a file field and the V‑Spark Authorization token in the token field.

The V‑Spark Authorization Token can be found on the Settings page with Company information, as shown in the following screenshot:

vspark-auth-token.png

The following is an example POST to a V‑Spark installation on the host example.company.com made using the curl command:

curl –F token=00112233445566778899aabbccddeeff \
     -F "file=@path/to/sampleaudio.zip;type= application/zip" \
     -X POST http://example.company.com:3000/transcribe/org_shortname/samplefolder

Note that org_shortname in this sample curl command refers to the Short Name assigned to the target organization, which can be found on the Settings page containing the Organization information, as shown in the following screenshot:

vspark-org-short-name.png

Users who have Amazon Web Services (AWS) Simple Storage Service (S3) configured can also import zipped input directly from S3 via the V‑Spark API, such as in this example:

curl -F token=0123456789abcde0123456789abcde01 \
     -F aws_id=012345678901234567890 \
     -F aws_secret=01234567890123456789012345678901234567890 \
     -F s3key=s3://example.company.com/documentation-TEST.zip \
     -F region=us-east-1 \
     -X POST http://example.company.com:3000/transcribe/Test-Testing/Test01

9700fc31-f608-48b5-aaaf-bd264e811d9a

For more detailed information on using the V‑Spark API, refer to the V‑Spark API Reference.