Tudo o que o KIT faz, em um lugar só

Cada capacidade é uma tarefa: você manda a entrada, recebe o resultado. Não tem token, não tem janela de contexto, não tem engenharia de prompt. Cada tarefa tem preço publicado, unidade documentada e formato fixo.

São quatro jeitos de rodar. Web — cada capacidade tem a sua própria página e roda no navegador; as grátis não saem do seu aparelho. API — um POST autenticado, documentado aqui embaixo. E-mail e Telegram — você manda a tarefa para um endereço do KIT. A API é um canal, não o produto.

Crie a sua conta, pegue a sua chave, rode uma tarefa. Sem ligação de vendas, sem lista de espera.

Toda requisição à API leva Authorization: Bearer kit_live_…. As chaves têm 48 caracteres hexadecimais depois do prefixo.

A gente guarda só o hash SHA-256 da sua chave. Isso é de propósito: um vazamento de banco de dados não entrega a credencial de ninguém — mas também quer dizer que a gente realmente não tem como mandar a sua chave de volta por e-mail. Perdeu? A gente revoga e emite outra.

Chave errada sempre devolve 401 e nunca diz o motivo. Revogada, digitada errada e nunca existiu são indistinguíveis de propósito: contar para você qual foi é contar para um atacante também.

As rotas não têm prefixo de versão. /v1/* continua resolvendo para clientes antigos, mas não é a forma canônica e código novo não deve usar.

Informe webhook_url ao criar a tarefa e a gente faz o POST do resultado lá quando ficar pronto. É o caminho recomendado: custa menos que polling e chega antes.

Confira a assinatura antes de confiar no corpo. Toda entrega leva KIT-Signature: v1=<hex> e KIT-Timestamp: <segundos unix>. A assinatura é um HMAC-SHA256 sobre a string <timestamp>.<corpo cru> — o timestamp e o ponto fazem parte do payload assinado, não são enfeite. Assine os bytes crus que você recebeu, não um objeto re-serializado.

A entrega é tentada até 5 vezes, com backoff exponencial. Um 4xx vindo do seu endpoint interrompe as tentativas na hora — a gente lê isso como “o seu handler está errado”, não como “tente mais tarde”. Só 5xx e erro de rede geram nova tentativa. Depois disso, a entrega vai para a dead-letter.

Todo erro traz no corpo um slug estável em error. Trate pelo slug, não pela mensagem: as mensagens são traduzidas e podem mudar.

Pague apenas pelo que usar. Adicione saldo à sua conta (a partir de US$ 10,00) — ele nunca expira — e cada tarefa é descontada dele pelo preço publicado por tarefa. Dólares de verdade, não pontos.

Cada tarefa custa uma taxa base mais uma taxa por unidade, as duas publicadas na página da própria capacidade e no catálogo aqui embaixo — a partir de US$ 0,002 por chamada. POST /estimate faz o orçamento da tarefa sem rodar, e max_cost_usd na tarefa recusa a execução se ela for custar mais do que você disse.

Tarefa que falha não é cobrada. As capacidades grátis rodam no seu navegador e não custam absolutamente nada.

O polling de uma tarefa é limitado a 1 requisição por segundo; passou disso, você recebe 429 com Retry-After: 1. Use o webhook. Os resultados ficam guardados conforme o tamanho: 168 h até 1 MB e 6 h para os muito grandes. GET /tasks devolve 25 por padrão e 100 no máximo. O signup é limitado a 10 contas por hora por IP.

Cada capacidade leva para a sua página, onde você roda, vê um exemplo de verdade e o preço publicado. Os preços daqui vêm do mesmo catálogo que o Worker usa para cobrar — não tem como divergir.