Referência da API
Todas as rotas da v1, uma página por rota, com os parâmetros, o corpo, as respostas, os erros e exemplos em cURL, Python e JavaScript.
Rotas
| Método | Rota | O que faz |
|---|---|---|
| GET | /v1/health | Situação dos modelos |
| GET | /v1/models | Modelos, preços e unidades |
| GET | /v1/voices | As 5 vozes |
| GET | /v1/balance | Saldo da organização |
| POST | /v1/tokens | Token temporário para o navegador e o SDK do avatar |
| POST | /v1/tts | Texto para áudio |
| WS | /v1/tts/stream | Voz em streaming |
| POST | /v1/stt/transcriptions | Cria uma transcrição em lote (arquivo ou URL) |
| GET | /v1/stt/transcriptions | Lista as transcrições, das mais novas para as mais velhas |
| GET | /v1/stt/transcriptions/{job_id} | Situação e resultado de uma transcrição |
| GET | /v1/stt/transcriptions/{job_id}/export | Texto ou legenda (txt, srt ou vtt) de uma transcrição concluída |
| DELETE | /v1/stt/transcriptions/{job_id} | Cancela (na fila ou processando) ou apaga o resultado |
| WS | /v1/stt/stream | Transcrição ao vivo |
| WS | /v1/avatar/stream | Avatar |
Convenções
- Endereço:
https://api.int8labs.com(WebSockets emwss://api.int8labs.com). - Credencial:
Authorization: Bearer int8_live_…ouBearer int8_tmp_…. No WebSocket do navegador,?token=int8_tmp_…. - Corpo: JSON em
snake_case, menos o upload do lote (multipart/form-data). - Datas: ISO 8601 em UTC, com milissegundos.
- Dinheiro: reais, com até 8 casas.
- Rastreio: toda resposta leva
X-Request-Id. - Erros:
{"error": {"code", "message", "request_id"}}; a lista está em Erros.
OpenAPI
O esquema OpenAPI 3.1 das rotas REST está em /docs/openapi.json e em GET https://api.int8labs.com/v1/openapi.json. Os WebSockets ficam fora do OpenAPI e estão descritos nas páginas WS da lista acima.