Resumir una entrevista

POSThttps://api.curriculo.me/public/summary/

On this page

Modo de transcripción
Modo de archivo
Respuesta
Tiempo
Errores

Sin estado. Convierte una entrevista en highlights,red_flags,skills_mentioned,decision_recommendation,decision_reasoning y tiempo de habla opcional analytics. Envíe una transcripción como texto, un documento de transcripción o una grabación para ser transcrita y resumida en una sola solicitud.

Precio: $0.01 por solicitud de transcripción. Para una grabación, $0.002 por minuto de audio más $0.01. Consulte Precios y facturación.

Modo de transcripción

application/json. Envíe un objeto JSON para una entrevista o una matriz JSON para hasta 10. Cada entrevista tiene su propio id.

Campo	Tipo	Notas
`interview_id`	cadena	Identificador propio. Devuelto, nunca buscado.
`transcript_text` (obligatorio)	cadena	Transcripción sin procesar, de hasta 200,000 caracteres.
`transcript_entries`	objeto[]	Vueltas estructuradas opcionales (`participant`,`text`,`startTime`,`endTime`). Permite análisis de tiempo de habla.
`language`	cadena	Código ISO 639-1 para renderizar la prosa del resumen. Por defecto, en inglés se cambia a español como 'es'

curl -X POST https://api.curriculo.me/public/summary/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'Content-Type: application/json' \
  -d '{"interview_id": "int_0042", "transcript_text": "Interviewer: Tell me about a system you shipped. Candidate: …", "language": "en"}'

Modo de archivo

multipart/form-data en el mismo camino. Subir grabaciones o documentos de transcripción.

Campo	Tipo	Notas
`media`	archivo[]	Repetir hasta 10 archivos. El contenido de cada archivo decide cómo se lee: PDF, DOCX y DOC se leen como transcripciones (hasta 50 MB); cualquier otro se trata como audio o video (por ejemplo mp4, mov, mkv, mp3, m4a, wav) y se transcribe primero (hasta 100 MB).
`interview_id`	cadena	Su identificador, compartido por cada archivo en la solicitud. De forma predeterminada, es el nombre del archivo subido.
`language`	cadena	Código ISO 639-1 para la prosa del resumen.

curl -X POST https://api.curriculo.me/public/summary/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F '[email protected]' \
  -F 'interview_id=int_0042' \
  -F 'language=en'

Una grabación se devuelve con su transcripción junto con el análisis, por lo que no se necesita un proveedor de transcripción separado. Debido a que una carga mal etiquetada se lee por su contenido, una transcripción guardada con la extensión incorrecta todavía aterriza correctamente.

Una llamada síncrona debe finalizar dentro de 300 segundos. Para entrevistas largas, envíe un enlace a POST /summary/async en su lugar: grabaciones de hasta 1 GB y 2 horas.

Donde la transcripción de medios no está habilitada, una grabación devuelve 503. Envíe una transcripción en su lugar.

Respuesta

Los campos de resumen anteriores, con su interview_id devuelto. Una matriz de JSON de entrevistas devuelve una matriz de results en orden de entrada. Consulte Procesamiento por lotes.

Tiempo

De 15 a 20 segundos para una transcripción. Las grabaciones tardan más, dependiendo de la longitud.

Errores

Estado	Causa típica
`400`	Transcripción en blanco, archivo ilegible o una clave de JSON duplicada.
`413`	Una transcripción de más de 200.000 caracteres, más de 10 entrevistas o archivos, o un archivo que supera su límite de tamaño.
`422`	`transcript_text` está falta, o un campo tiene un nombre incorrecto.
`503`	La transcripción de medios no está habilitada. Envíe una transcripción en su lugar.
`504`	El procesamiento superó 300 segundos. Utilice `/summary/async`.

Updated 12 October 2026