Resumir uma entrevista

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

On this page

Modo de Transcrição
Modo de arquivo
Resposta
Temporização
Erros

Sem Estado. Transforma uma entrevista em highlights,red_flags,skills_mentioned,decision_recommendation,decision_reasoning e tempo de fala opcional analytics. Envie uma transcrição como texto, um documento de transcrição ou uma gravação para ser transcrita e resumida em uma solicitação.

Preço: $0.01 por solicitação para uma transcrição. Para uma gravação, $0.002 por minuto de áudio mais $0.01. Veja Preços e faturamento.

Modo de Transcrição

application/json. Envie um objeto JSON para uma entrevista, ou um array JSON para até 10. Cada entrevista recebe seu próprio id.

Campo	Tipo	Notas
`interview_id`	cadeia de caracteres	Seu próprio identificador. Devolvido, nunca procurado.
`transcript_text` (obrigatório)	cadeia de caracteres	Transcrição bruta, de até 200.000 caracteres.
`transcript_entries`	objeto[]	Voltas estruturadas opcionais (`participant`,`text`,`startTime`,`endTime`). Permite análise de tempo de fala.
`language`	cadeia de caracteres	Código ISO 639-1 para renderizar o resumo em prosa. Padrão em Português.

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 arquivo

multipart/form-data no mesmo caminho. Faça upload de gravações ou documentos de transcrição.

Campo	Tipo	Notas
`media`	arquivo[]	Repita por até 10 arquivos. O conteúdo de cada arquivo decide como ele é lido: PDF, DOCX e DOC são lidos como transcrições (até 50 MB); qualquer outro é tratado como áudio ou vídeo (por exemplo mp4, mov, mkv, mp3, m4a, wav) e transcrito primeiro (até 100 MB).
`interview_id`	cadeia de caracteres	Seu identificador, compartilhado por todos os arquivos na solicitação. Padrão é o nome do arquivo enviado.
`language`	cadeia de caracteres	Código ISO 639-1 para o resumo em prosa.

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'

Uma gravação é devolvida com sua transcrição ao lado da análise, então não é necessário um fornecedor de transcrição separado. Como um upload mal rotulado é lido por seu conteúdo, uma transcrição salva com a extensão errada ainda é processada corretamente.

Uma chamada síncrona deve ser concluída dentro de 300 segundos. Para entrevistas longas, envie um link para POST /summary/async em vez disso: gravações de até 1 GB e 2 horas.

Onde a transcrição de mídia não está habilitada, uma gravação retorna 503. Envie uma transcrição em vez disso.

Resposta

Os campos de resumo acima, com seu interview_id ecoado de volta. Uma matriz de JSON entrevistas retorna uma matriz de results na ordem de entrada. Consulte Lote.

Temporização

15 a 20 segundos para uma transcrição. As gravações levam mais tempo, dependendo do comprimento.

Erros

Status	Causa típica
`400`	Transcrição em branco, arquivo ilegível ou uma chave de JSON duplicada.
`413`	Uma transcrição com mais de 200.000 caracteres, mais de 10 entrevistas ou arquivos, ou um arquivo maior que o limite de tamanho.
`422`	`transcript_text` está faltando, ou um campo está com nome incorreto.
`503`	A transcrição de mídia não está habilitada. Envie uma transcrição em vez disso.
`504`	Processamento excedeu 300 segundos. Use `/summary/async`.

Updated 12 October 2026