Analyze an audio file

Analyze an audio file. By default (`input.WorkflowType` 4) this detects whether a voice is AI-generated or cloned; other workflows transcribe speech, run intelligence analysis, or combine both. Max 50 MB per file; formats `wav`, `mp3`, `flac`, `m4a`, `opus`.

Authorization

BearerAuth

AuthorizationBearer <token>

Send your secret API token as a bearer token in the Authorization header: Authorization: Bearer <token>. Keep it server-side and never expose it in client code.

In: header

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

audioFile*file

The audio file to analyze.

input.WorkflowType?VoiceWorkflowType

Which voice workflow to run:

1 — Transcription only
2 — Intelligence (text analysis) only
3 — Combined transcription + intelligence
4 — AI-voice detection only (default)

input.TextInput?string

Text to analyze for the Intelligence or Combined workflows (max 50,000 chars).

input.ContextHints?string

Optional context to guide analysis (max 500 chars).

sourceUrl?string

Optional source URL of the audio, recorded for your own auditing.

Response Body

`application/json`

cURL

curl -X POST "https://example.com/api/app/voice-analysis/process" \  -F audioFile="string"

import requestsurl = "https://example.com/api/app/voice-analysis/process"body = {  "audioFile": "string"}response = requests.request("POST", url, data = body, headers = {  "Content-Type": "multipart/form-data"})print(response.text)

package mainimport (  "fmt"  "net/http"  "io/ioutil"  "mime/multipart"  "bytes")func main() {  url := "https://example.com/api/app/voice-analysis/process"  body := new(bytes.Buffer)  mp := multipart.NewWriter(payload)  mp.WriteField("audioFile", `string`)  req, _ := http.NewRequest("POST", url, body)  req.Header.Add("Content-Type", "multipart/form-data")  res, _ := http.DefaultClient.Do(req)  defer res.Body.Close()  body, _ := ioutil.ReadAll(res.Body)  fmt.Println(res)  fmt.Println(string(body))}

import java.net.URI;import java.net.http.HttpClient;import java.net.http.HttpRequest;import java.net.http.HttpResponse;import java.net.http.HttpResponse.BodyHandlers;import java.time.Duration;import java.net.http.HttpRequest.BodyPublishers;var body = BodyPublishers.ofByteArray(new byte[] { ... });HttpClient client = HttpClient.newBuilder()  .connectTimeout(Duration.ofSeconds(10))  .build();HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()  .uri(URI.create("https://example.com/api/app/voice-analysis/process"))  .header("Content-Type", "multipart/form-data")  .POST(body)  .build();try {  HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());  System.out.println("Status code: " + response.statusCode());  System.out.println("Response body: " + response.body());} catch (Exception e) {  e.printStackTrace();}

{
  "isSuccessful": true,
  "errorMessage": null,
  "workflowType": 4,
  "transcript": null,
  "analysis": null,
  "contextUsed": null,
  "isAiDetected": true,
  "detectionConfidence": 0.93,
  "detectionClassification": "fake",
  "processingTimeMs": 2110,
  "creditsUsed": 1,
  "metadata": null
}

File too large

{
  "error": {
    "code": "IMAGE_FORENSICS:FILE_TOO_LARGE",
    "message": "File photo.jpg exceeds the maximum size of 50 MB."
  }
}

Unsupported format

{
  "error": {
    "code": "IMAGE_FORENSICS:UNSUPPORTED_FORMAT",
    "message": "Unsupported file format. Allowed — jpg, jpeg, png, webp, heic, heif, tiff."
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API token."
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`