curl --request POST \
--url https://backend.identifai.net/api/classification_audio \
--header 'Content-Type: multipart/form-data' \
--header 'X-Api-Key: <api-key>' \
--form 'audio=@example-file;type=audio/mpeg' \
--form 'ref_id=<string>' \
--form 'webhook_url=<string>' \
--form 'deferred_webhook_url=<string>' \
--form no_cache=true \
--form prevent_c2pa_forces=true \
--form 'audio_timestamps=00:00:05.000,00:01:12.500'import requests
url = "https://backend.identifai.net/api/classification_audio"
files = { "audio": ("example-file", open("example-file", "rb"), "audio/mpeg") }
payload = {
"ref_id": "<string>",
"webhook_url": "<string>",
"deferred_webhook_url": "<string>",
"no_cache": "true",
"prevent_c2pa_forces": "true",
"audio_timestamps": "00:00:05.000,00:01:12.500"
}
headers = {"X-Api-Key": "<api-key>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('audio', '<string>');
form.append('ref_id', '<string>');
form.append('webhook_url', '<string>');
form.append('deferred_webhook_url', '<string>');
form.append('no_cache', 'true');
form.append('prevent_c2pa_forces', 'true');
form.append('audio_timestamps', '00:00:05.000,00:01:12.500');
const options = {method: 'POST', headers: {'X-Api-Key': '<api-key>'}};
options.body = form;
fetch('https://backend.identifai.net/api/classification_audio', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://backend.identifai.net/api/classification_audio",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: audio/mpeg\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Content-Type: multipart/form-data",
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://backend.identifai.net/api/classification_audio"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: audio/mpeg\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://backend.identifai.net/api/classification_audio")
.header("X-Api-Key", "<api-key>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: audio/mpeg\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://backend.identifai.net/api/classification_audio")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: audio/mpeg\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"identifier": "8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"
}Clasifica un audio de voz
Envía un audio de voz para su clasificación
🔁 El formato de la respuesta depende del header Accept:
Accept: application/json → { "identifier": "..." }
Otros valores (p. ej., text/plain) → texto plano con solo la cadena del identificador.
curl --request POST \
--url https://backend.identifai.net/api/classification_audio \
--header 'Content-Type: multipart/form-data' \
--header 'X-Api-Key: <api-key>' \
--form 'audio=@example-file;type=audio/mpeg' \
--form 'ref_id=<string>' \
--form 'webhook_url=<string>' \
--form 'deferred_webhook_url=<string>' \
--form no_cache=true \
--form prevent_c2pa_forces=true \
--form 'audio_timestamps=00:00:05.000,00:01:12.500'import requests
url = "https://backend.identifai.net/api/classification_audio"
files = { "audio": ("example-file", open("example-file", "rb"), "audio/mpeg") }
payload = {
"ref_id": "<string>",
"webhook_url": "<string>",
"deferred_webhook_url": "<string>",
"no_cache": "true",
"prevent_c2pa_forces": "true",
"audio_timestamps": "00:00:05.000,00:01:12.500"
}
headers = {"X-Api-Key": "<api-key>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('audio', '<string>');
form.append('ref_id', '<string>');
form.append('webhook_url', '<string>');
form.append('deferred_webhook_url', '<string>');
form.append('no_cache', 'true');
form.append('prevent_c2pa_forces', 'true');
form.append('audio_timestamps', '00:00:05.000,00:01:12.500');
const options = {method: 'POST', headers: {'X-Api-Key': '<api-key>'}};
options.body = form;
fetch('https://backend.identifai.net/api/classification_audio', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://backend.identifai.net/api/classification_audio",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: audio/mpeg\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Content-Type: multipart/form-data",
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://backend.identifai.net/api/classification_audio"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: audio/mpeg\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://backend.identifai.net/api/classification_audio")
.header("X-Api-Key", "<api-key>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: audio/mpeg\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://backend.identifai.net/api/classification_audio")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: audio/mpeg\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ref_id\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"deferred_webhook_url\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"no_cache\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"prevent_c2pa_forces\"\r\n\r\ntrue\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio_timestamps\"\r\n\r\n00:00:05.000,00:01:12.500\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"identifier": "8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"
}Encabezados
Cuerpo
El audio de voz que se va a clasificar. Formatos admitidos: MP3, WAV, OGG, FLAC, AAC, 3GP, M4A, M4B, M4P, M4R, MP4. Tipos MIME: audio/mpeg, audio/wav, audio/ogg, audio/flac, audio/aac, audio/3gp, audio/m4a, audio/m4b, audio/m4p, audio/m4r, video/mp4. Tamaño máximo del archivo: 15MB.
Si se indica, el resultado de la clasificación también se envía automáticamente a la URL introducida. Si no, el resultado se obtiene mediante polling del endpoint correspondiente. Ten en cuenta que para usar una URL de callback del webhook debes solicitar una habilitación específica; si no, el parámetro se ignora. Además, el sistema puede guardar en caché los resultados de los análisis de envíos repetidos, es decir, envíos del mismo archivo con las mismas opciones: en este caso no se llama al webhook y los resultados solo están accesibles mediante polling del endpoint correspondiente.
Si se indica, la URL se notifica una sola vez cuando los resultados diferidos del envío están completos (p. ej., las explicaciones textuales de los mapas XAI y de la heatmap), después de los resultados principales enviados a webhook_url. La notificación lleva el evento submission.deferred.completed: consulta Resultados diferidos para ver el payload. Se aplican la misma habilitación, las mismas restricciones de dominio y la misma autenticación que en webhook_url. La entrega es at least once: deduplica por identifier, y ten en cuenta que una notificación expired puede ir seguida de una segunda con el resultado real, que la sustituye. Si se omite o está vacía, no se envía ninguna notificación de resultados diferidos.
[Funcionalidad del plan] Momentos específicos del audio de voz que se van a analizar. Lista de timecodes separados por comas en formato HH:MM:SS.mmm, medidos desde el inicio del archivo (p. ej., 00:00:05.000,00:01:12.500). Cuando se indica, en lugar de dividir el audio en segmentos a lo largo de toda su duración, el sistema analiza un breve segmento de audio centrado en cada momento indicado; los momentos lo bastante cercanos como para caer en el mismo segmento se analizan juntos en un único segmento. Los momentos duplicados se cuentan una sola vez. Puedes indicar hasta 30 momentos si tu plan de precios te permite elegir el número de segmentos de audio; si no, hasta 5. Se cobra un segmento de audio por cada momento distinto: los segmentos que no se generan (momentos agrupados, momentos posteriores al final del audio) se reembolsan al terminar el análisis. Si ningún momento cae dentro del audio, la clasificación termina con un error. Para usar esta opción debe estar habilitada en tu plan de precios; si no, el parámetro se ignora.
"00:00:05.000,00:01:12.500"