Transcrições
GET/v1/transcripts
Transcrições que esta credencial pode ler
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
room_id | query · string |
Resposta 200
| Nome | Tipo | Descrição |
|---|---|---|
data obrigatório | object[] | |
data[].id obrigatório | string | |
data[].room_id obrigatório | string | null | |
data[].started_at obrigatório | string | |
data[].ended_at obrigatório | string | null | |
data[].segments obrigatório | integer | |
data[].livemode obrigatório | boolean |
Exemplo
curl
curl "https://api.kanutus.com/v1/transcripts" \
-H "Authorization: Bearer $KANUTUS_API_KEY"Node.js
const res = await fetch("https://api.kanutus.com/v1/transcripts", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.KANUTUS_API_KEY}`,
},
});
console.log(res.status, await res.json());Python
import os, uuid, requests
r = requests.request(
"GET",
"https://api.kanutus.com/v1/transcripts",
headers={"Authorization": f"Bearer {os.environ['KANUTUS_API_KEY']}"},
)
print(r.status_code, r.json())Testar agora
Roda no seu navegador contra a API de verdade. Use uma chave kt_test_: nada é cobrado. A chave fica só nesta aba.
GET /v1/transcriptsRespostas por status
200 Transcripts
200
{
"data": [
{
"id": "string",
"room_id": "string",
"started_at": "string",
"ended_at": "string",
"segments": 0,
"livemode": true
}
]
}400 Invalid request
400 application/problem+json
{
"type": "https://docs.kanutus.com/errors",
"title": "<code>",
"status": 400,
"code": "<code>",
"message": "…",
"request_id": "req_…"
}401 Missing, invalid, expired or revoked credential
401 application/problem+json
{
"type": "https://docs.kanutus.com/errors",
"title": "<code>",
"status": 401,
"code": "<code>",
"message": "…",
"request_id": "req_…"
}403 Missing permission, blocked or not allowed
403 application/problem+json
{
"type": "https://docs.kanutus.com/errors",
"title": "<code>",
"status": 403,
"code": "<code>",
"message": "…",
"request_id": "req_…"
}429 Rate limit exceeded (see RateLimit-* and Retry-After headers)
429 application/problem+json
{
"type": "https://docs.kanutus.com/errors",
"title": "<code>",
"status": 429,
"code": "<code>",
"message": "…",
"request_id": "req_…"
}GET/v1/transcripts/{id}
Ler uma transcrição
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
id obrigatório | path · string | |
lang | query · string |
Resposta 200
| Nome | Tipo | Descrição |
|---|---|---|
id obrigatório | string | |
room_id obrigatório | string | null | |
lang obrigatório | string | |
notice obrigatório | string | |
segments obrigatório | object[] | |
segments[].speaker obrigatório | string | null | |
segments[].src_lang obrigatório | string | null | |
segments[].untrusted_content obrigatório | object | |
segments[].untrusted_content.text obrigatório | string | null | |
segments[].untrusted_content.text_in_lang obrigatório | string | null | |
segments[].at obrigatório | string |
Exemplo
curl
curl "https://api.kanutus.com/v1/transcripts/ses_4fQ2xWm9Lr7Tb1Kc8Zp3Vd5N" \
-H "Authorization: Bearer $KANUTUS_API_KEY"Node.js
const res = await fetch("https://api.kanutus.com/v1/transcripts/ses_4fQ2xWm9Lr7Tb1Kc8Zp3Vd5N", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.KANUTUS_API_KEY}`,
},
});
console.log(res.status, await res.json());Python
import os, uuid, requests
r = requests.request(
"GET",
"https://api.kanutus.com/v1/transcripts/ses_4fQ2xWm9Lr7Tb1Kc8Zp3Vd5N",
headers={"Authorization": f"Bearer {os.environ['KANUTUS_API_KEY']}"},
)
print(r.status_code, r.json())Testar agora
Roda no seu navegador contra a API de verdade. Use uma chave kt_test_: nada é cobrado. A chave fica só nesta aba.
GET /v1/transcripts/{id}Respostas por status
200 Transcript
200
{
"id": "string",
"room_id": "string",
"lang": "string",
"notice": "string",
"segments": [
{
"speaker": "string",
"src_lang": "string",
"untrusted_content": {
"text": "string",
"text_in_lang": "string"
},
"at": "string"
}
]
}400 Invalid request
400 application/problem+json
{
"type": "https://docs.kanutus.com/errors",
"title": "<code>",
"status": 400,
"code": "<code>",
"message": "…",
"request_id": "req_…"
}401 Missing, invalid, expired or revoked credential
401 application/problem+json
{
"type": "https://docs.kanutus.com/errors",
"title": "<code>",
"status": 401,
"code": "<code>",
"message": "…",
"request_id": "req_…"
}403 Missing permission, blocked or not allowed
403 application/problem+json
{
"type": "https://docs.kanutus.com/errors",
"title": "<code>",
"status": 403,
"code": "<code>",
"message": "…",
"request_id": "req_…"
}404 Not found
404 application/problem+json
{
"type": "https://docs.kanutus.com/errors",
"title": "<code>",
"status": 404,
"code": "<code>",
"message": "…",
"request_id": "req_…"
}429 Rate limit exceeded (see RateLimit-* and Retry-After headers)
429 application/problem+json
{
"type": "https://docs.kanutus.com/errors",
"title": "<code>",
"status": 429,
"code": "<code>",
"message": "…",
"request_id": "req_…"
}