---
title: "O que uma chave de API do Qomni carrega dentro"
description: "O formato das chaves sk_produto_modo_celula e o que cada parte poupa ao edge, ao cliente e ao suporte."
version: "pt-br"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.qomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# O que uma chave de API do Qomni carrega dentro

Uma chave de API parece uma cadeia aleatória, mas a do Qomni conta uma
história: `sk_agents_live_co1_8fK2…Qa91Zx`. Cada parte está ali por uma razão
concreta, e as razões são o tema desta nota.

## O produto, na chave

Cada produto do Qomni tem sua API, seu consumo e sua fatura. Uma chave vale
para um único produto. Com uma chave do Agents você pode chamar
`api.qomni.ai/agents/v1` e nada mais; em outra API falha com
`401 api_key_wrong_product`.

É uma decisão de superfície de ataque. Um sistema que cria chamadas recebe
uma chave do Agents e, se essa chave vazar, o atacante não entra no app
web nem na conta. E revogar uma chave não toca nas demais.

## O modo, na chave

`live` ou `test` não é uma configuração da conta: quem decide é a chave. Uma chave
de teste trabalha sobre dados separados, não disca nenhum número e não fatura.
O código é o mesmo; muda uma variável de ambiente. Assim, o que você testa
é exatamente o que vai rodar em produção.

## A célula, para não consultar nada

`co1` diz onde vivem os dados do workspace. O edge lê esse prefixo e
envia a requisição à célula correta sem buscar em nenhum banco de dados.
É a razão pela qual a URL da API nunca carrega região.

## O checksum, para falhar cedo

Os últimos seis caracteres são um CRC32 do restante, em base62. Uma chave mal
copiada é rejeitada no edge, com `401 api_key_malformed`, antes de chegar a
qualquer servidor. O suporte reconhece esse erro sem olhar mais nada.

## O que não está na chave

O Qomni guarda só o hash SHA-256 de cada chave. Por isso a chave completa é
mostrada uma única vez, ao criá-la, e depois só se veem seu prefixo e seus
últimos quatro caracteres. Uma chave perdida não se recupera: cria-se outra e
revoga-se a anterior.

```mermaid
flowchart LR
  K["sk_agents_live_co1_8fK2…Qa91Zx"] --> P[sk: secreta]
  K --> R[agents: produto]
  K --> M[live: modo]
  K --> C[co1: célula]
  K --> S[30 caracteres: segredo]
  K --> X[6 caracteres: checksum]
```

## E os limites

Cada chave tem seu próprio orçamento: 120 requisições por minuto. As
requisições rejeitadas com `401` são contadas à parte, por endereço IP, para que
um cliente mal configurado não esgote o orçamento das chaves válidas da
mesma rede.

A anatomia completa está em
[Chaves de API e autenticação](/pt-br/concepts/authentication/).

Source: https://docs.qomni.ai/pt-br/blog/una-clave-por-producto/index.mdx
