Analyze audio from a URL

Analyze audio fetched from a public URL — a direct audio link or a video/social page whose audio track is extracted automatically.

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

application/json

TypeScript Definitions

Use the request body type in TypeScript.

url*string

HTTPS URL of the audio, or of a page/video whose audio is extracted.

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)

textInput?string

contextHints?string

Response Body

`application/json`

cURL

curl -X POST "https://example.com/api/app/voice-analysis/process-from-url" \  -H "Content-Type: application/json" \  -d '{    "url": "http://example.com"  }'

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

package mainimport (  "fmt"  "net/http"  "io/ioutil"  "strings")func main() {  url := "https://example.com/api/app/voice-analysis/process-from-url"  body := strings.NewReader(`{    "url": "http://example.com"  }`)  req, _ := http.NewRequest("POST", url, body)  req.Header.Add("Content-Type", "application/json")  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.ofString("""{  "url": "http://example.com"}""");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-from-url"))  .header("Content-Type", "application/json")  .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": "string",
  "workflowType": 1,
  "transcript": "string",
  "analysis": "string",
  "contextUsed": "string",
  "isAiDetected": true,
  "detectionConfidence": 0,
  "detectionClassification": "string",
  "processingTimeMs": 0,
  "creditsUsed": 0,
  "metadata": {}
}

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."
  }
}

Analyze audio from a URL

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`