Cancela (na fila ou processando) ou apaga o resultado
DELETE
https://api.int8labs.com/v1/stt/transcriptions/{job_id}Cancela uma transcrição na fila ou processando (200, nada é cobrado) ou apaga o resultado de uma que já terminou (204).
EscoposttAuthBearer int8_live_ ou int8_tmp_Limite120/min por chave
Parâmetros
job_idstringobrigatóriouuidResposta 200
O job foi cancelado; nada é cobrado.
idstringobrigatóriostatusstringobrigatórioqueuedprocessingcompletedfailedcanceled
sourcestringobrigatórioapiplayground
inputstringobrigatóriouploadurl
file_namestring | nullobrigatóriosize_bytesinteger | nullobrigatórioduration_msinteger | nullobrigatóriokeytermsarray<string>obrigatóriowebhook_urlstring | nullobrigatóriocost_brlnumber | nullobrigatórioCusto cobrado quando o job concluiu; job que falha não cobra.
errorobject | nullobrigatórioerror.codestringobrigatórioerror.messagestringobrigatórioresultobject | nullopcionalSó no job concluído; a lista não traz este campo.
result.textstringobrigatórioEm minúsculas, sem pontuação e com os números por extenso.
result.segmentsarray<object>obrigatórioCortes em pontos de silêncio, de até 30 s.
result.segments[].start_msintegerobrigatórioresult.segments[].end_msintegerobrigatórioresult.segments[].textstringobrigatórioresult.duration_msintegerobrigatóriocreated_atstringobrigatóriostarted_atstring | nullobrigatóriocompleted_atstring | nullobrigatórioexpires_atstring | nullobrigatórioO resultado vale 30 dias depois de terminar.
Resposta 204
O resultado foi apagado.
Erros
| HTTP | Código | O que fazer |
|---|---|---|
| 400 | invalid_request | Leia a message, que diz o campo, e corrija o pedido. Repetir igual dá o mesmo erro. |
| 401 | invalid_api_key | Mande Authorization: Bearer int8_live_… no servidor, ou ?token=int8_tmp_… no WebSocket do navegador. |
| 401 | api_key_expired | Crie uma chave nova no console, ou peça um token novo em POST /v1/tokens. |
| 401 | api_key_revoked | Troque pela chave nova. Os tokens emitidos pela chave revogada param de valer junto. |
| 403 | ip_not_allowed | Inclua o IP (ou a faixa CIDR) na chave, em console › Chaves de API › Editar. |
| 403 | scope_denied | Edite os escopos da chave no console, ou emita o token com o escopo certo. |
| 404 | not_found | Confira o id. Depois de 30 dias o resultado não volta: guarde o que precisar. |
| 429 | rate_limited | Espere os segundos do Retry-After e repita. Na transcrição ao vivo, mande o áudio no ritmo da fala. |
| 429 | concurrency_limited | Espere um pedido terminar, ou enfileire do seu lado. |