Saltar al contenido principal
Clasifica un audio de voz

Autorizaciones

X-Api-Key
string
header
requerido

Tu API key.

Encabezados

Accept
enum<string>

Tipo de contenido de la respuesta. Valores admitidos: application/json, text/plain.

Opciones disponibles:
application/json,
text/plain

Cuerpo

multipart/form-data
audio
file
requerido

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.

ref_id
string

ID de referencia opcional que se asocia a la solicitud de clasificación.

webhook_url
string

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.

deferred_webhook_url
string

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.

no_cache
boolean

Establécelo en true para obligar al sistema a volver a procesar la imagen aunque ya se haya enviado con las mismas opciones. Esto puede suponer costes adicionales.

prevent_c2pa_forces
boolean

Si es true, la firma C2PA no fuerza el origen a artificial. Si es false o no está definido, la firma C2PA fuerza el origen a artificial (comportamiento actual).

audio_timestamps
string

[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.

Ejemplo:

"00:00:05.000,00:01:12.500"

Respuesta

El identificador de la clasificación. El formato depende del header Accept.

identifier
string
Ejemplo:

"8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"