Pular para o conteúdo
int8labs

Situação e resultado de uma transcrição

GEThttps://api.int8labs.com/v1/stt/transcriptions/{job_id}

A situação de uma transcrição e, quando concluída, o resultado: o texto e os trechos, com início e fim em milissegundos.

EscoposttAuthBearer int8_live_ ou int8_tmp_Limite120/min por chave

Parâmetros

job_idstringobrigatóriouuid

Resposta 200

O objeto abaixo, em JSON.

idstringobrigatório
statusstringobrigatório
queuedprocessingcompletedfailedcanceled
sourcestringobrigatório
apiplayground
inputstringobrigatório
uploadurl
file_namestring | nullobrigatório
size_bytesinteger | nullobrigatório
duration_msinteger | nullobrigatório
keytermsarray<string>obrigatório
webhook_urlstring | nullobrigatório
cost_brlnumber | nullobrigatório

Custo cobrado quando o job concluiu; job que falha não cobra.

errorobject | nullobrigatório
error.codestringobrigatório
error.messagestringobrigatório
resultobject | nullopcional

Só no job concluído; a lista não traz este campo.

result.textstringobrigatório

Em minúsculas, sem pontuação e com os números por extenso.

result.segmentsarray<object>obrigatório

Cortes em pontos de silêncio, de até 30 s.

result.segments[].start_msintegerobrigatório
result.segments[].end_msintegerobrigatório
result.segments[].textstringobrigatório
result.duration_msintegerobrigatório
created_atstringobrigatório
started_atstring | nullobrigatório
completed_atstring | nullobrigatório
expires_atstring | nullobrigatório

O resultado vale 30 dias depois de terminar.

Erros

HTTPCódigoO que fazer
400invalid_requestLeia a message, que diz o campo, e corrija o pedido. Repetir igual dá o mesmo erro.
401invalid_api_keyMande Authorization: Bearer int8_live_… no servidor, ou ?token=int8_tmp_… no WebSocket do navegador.
401api_key_expiredCrie uma chave nova no console, ou peça um token novo em POST /v1/tokens.
401api_key_revokedTroque pela chave nova. Os tokens emitidos pela chave revogada param de valer junto.
403ip_not_allowedInclua o IP (ou a faixa CIDR) na chave, em console › Chaves de API › Editar.
403scope_deniedEdite os escopos da chave no console, ou emita o token com o escopo certo.
404not_foundConfira o id. Depois de 30 dias o resultado não volta: guarde o que precisar.
429rate_limitedEspere os segundos do Retry-After e repita. Na transcrição ao vivo, mande o áudio no ritmo da fala.
429concurrency_limitedEspere um pedido terminar, ou enfileire do seu lado.