Résumé d'une entrevue

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

On this page

Mode de transcription
Mode de fichier
Réponse
Le calendrier
Les erreurs

Il n'y a pas d'État. Transforme une interview en highlights,red_flags,skills_mentioned,decision_recommendation,decision_reasoning et analyticsen temps de parole facultatif . Envoyer une transcription sous forme de texte, d'un document de transcription ou d'un enregistrement à transcrire et à résumer en une seule demande.

Prix: $ 0.01 par demande de transcription. Pour un enregistrement, $0.002 par minute d'audio plus $0.01. Voir Prix et facturation.

Mode de transcription

application/json- Je ne sais pas . Envoyez un objet JSON pour une entrevue, ou un tableau JSON jusqu'à 10. Chaque entretien a sa propre identité.

champs	Type	Remarques
`interview_id`	la chaîne	Votre propre identifiant. Je me suis retourné, je n'ai jamais regardé.
`transcript_text` (obligatoire)	la chaîne	Une transcription brute, jusqu'à 200 000 caractères.
`transcript_entries`	objet[]	Tournées structurées facultatives (`participant`,`text`,`startTime`,`endTime`). Il permet l'analyse du temps de parole.
`language`	la chaîne	Code ISO 639-1 pour rendre la prose résumée. Par défaut en anglais.

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

Mode de fichier

multipart/form-data sur le même chemin. Télécharger des enregistrements ou des documents de transcription.

champs	Type	Remarques
`media`	fichier[]	Répétez jusqu'à 10 dossiers. Le contenu de chaque fichier décide de la manière dont il est lu: PDF, DOCX et DOC sont lus en tant que transcriptions (jusqu'à 50 MB); tout autre est traité comme audio ou vidéo (par exemple mp4, mov, mkv, mp3, m4a, wav) et transcrit en premier (jusqu'à 100 MB).
`interview_id`	la chaîne	Votre identifiant, partagé par tous les fichiers de la demande. Par défaut, le nom du fichier téléchargé.
`language`	la chaîne	Code ISO 639-1 pour la prose résumée.

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'

Un enregistrement revient avec sa transcription à côté de l'analyse, donc aucun fournisseur de transcription séparé n'est nécessaire. Parce qu'un téléchargement mal étiqueté est lu par son contenu, une transcription enregistrée avec l'extension incorrecte atterrit toujours correctement.

Un appel synchrone doit être terminé en 300 secondes. Pour les longues entrevues, envoyez un lien vers POST /summary/async à la place: enregistrements jusqu'à 1 GB et 2 heures.

Lorsque la transcription multimédia n'est pas activée, un enregistrement renvoie 503. Envoyez plutôt une transcription.

Réponse

Les champs de résumé ci-dessus, avec votre interview_id ont fait écho. Un tableau JSON d'entretiens renvoie un tableau results dans l'ordre de saisie. Voir Batchage.

Le calendrier

15 à 20 secondes pour une transcription. Les enregistrements prennent plus de temps, selon la longueur.

Les erreurs

Le statut	Cause typique
`400`	Une transcription vide, un fichier illisible, ou une clé JSON dupliquée.
`413`	Une transcription de plus de 200 000 caractères, plus de 10 entrevues ou fichiers, ou un fichier au-dessus de sa taille limite.
`422`	`transcript_text` est manquant, ou un champ est mal nommé.
`503`	La transcription médiatique n'est pas activée. Envoyez plutôt une transcription.
`504`	Le traitement a dépassé 300 secondes. Utilisation `/summary/async`.

Updated 12 October 2026