Começar em 5 minutos

Do zero até a sua primeira chamada à API em uns cinco minutos. Não existe uma conta separada para desenvolvedores: você usa a sua própria conta Kanutus.

#1. Crie sua conta e escolha um plano

1. Acesse app.kanutus.com e entre com o Google ou com um link enviado para o seu e-mail.
2. A API faz parte dos planos pagos e dos planos para empresas. No app, abra Assinatura e minutos e escolha um plano. Se a sua empresa já usa o Kanutus, peça acesso a um Dono ou Gestor da organização.

#2. Abra Desenvolvedores

No menu do app, abra Desenvolvedores:

• Conta pessoal: no menu principal, logo abaixo de Assinatura e minutos (https://app.kanutus.com/developers).
• Organização: em Gestão → Desenvolvedores (https://app.kanutus.com/org/developers). Donos e Gestores veem essa opção.

#3. Crie uma chave

1. Mude para Teste e clique em Criar chave.
2. Dê um nome (por exemplo, "Meu primeiro teste") e escolha um papel (Somente leitura basta para começar), um limite de gasto e a validade.
3. Clique em Criar e copie a chave na hora. Ela só aparece uma vez. Se perder, crie outra.

Guarde a chave no seu servidor, numa variável de ambiente. Nunca a coloque num navegador, num app de celular ou num repositório público.

export KANUTUS_API_KEY="kt_test_..."

#4. Faça a primeira chamada

GET /v1/me mostra a quem a chave pertence, que permissões ela tem e quais são os limites dela:

curl https://api.kanutus.com/v1/me -H "Authorization: Bearer $KANUTUS_API_KEY"

{
  "credential": { "kind": "key", "id": "…", "name": "Meu primeiro teste", "mode": "test", "needs_review": false },
  "organization": null,
  "user": { "id": "…", "name": "Ana" },
  "permissions": ["usage:read", "rooms:read", "calls:read", "calendar:read", "voices:read", "transcripts:read"],
  "limits": { "spend_day_minutes": 60, "spend_month_minutes": null, "per_call_minutes": null, "requests_per_minute": 60, "spent_today_minutes": 0, "spent_month_minutes": 0 },
  "pricing": { "api_minute_factor": 1, "listen_text_factor": 0.1 }
}

Agora crie uma sala. Toda requisição que cria algo precisa do cabeçalho Idempotency-Key. Use qualquer valor único: se você repetir a mesma requisição com o mesmo valor, recebe o mesmo resultado em vez de criar a sala duas vezes. Para criar salas, a chave precisa da permissão rooms:write, que vem, por exemplo, no papel Assistente de reuniões:

curl -X POST https://api.kanutus.com/v1/rooms \
  -H "Authorization: Bearer $KANUTUS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"title": "Proposta com a Andes", "langs": ["pt", "es"]}'

const res = await fetch("https://api.kanutus.com/v1/rooms", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KANUTUS_API_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ title: "Proposta com a Andes", langs: ["pt", "es"] }),
});
const room = await res.json();
console.log(room.url);

import os, uuid, requests

r = requests.post(
    "https://api.kanutus.com/v1/rooms",
    headers={
        "Authorization": f"Bearer {os.environ['KANUTUS_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={"title": "Proposta com a Andes", "langs": ["pt", "es"]},
)
print(r.json()["url"])

A resposta traz a url da sala. Abra ou compartilhe esse link: cada pessoa ouve as outras na própria língua.

#Próximos passos