---
title: "Qué lleva dentro una clave de API de Qomni"
description: "El formato de las claves sk_producto_modo_celda y lo que cada parte le ahorra al edge, al cliente y a soporte."
version: "es"
---

> 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.

# Qué lleva dentro una clave de API de Qomni

Una clave de API parece una cadena aleatoria, pero la de Qomni cuenta una
historia: `sk_agents_live_co1_8fK2…Qa91Zx`. Cada parte está ahí por una razón
concreta, y las razones son el tema de esta nota.

## El producto, en la clave

Cada producto de Qomni tiene su API, su consumo y su factura. Una clave vale
para un solo producto. Con una clave de Agents puedes llamar a
`api.qomni.ai/agents/v1` y a nada más; en otra API falla con
`401 api_key_wrong_product`.

Es una decisión de superficie de ataque. Un sistema que crea llamadas recibe
una clave de Agents y, si esa clave se filtra, el atacante no entra a la app
web ni a la cuenta. Y revocar una clave no toca a las demás.

## El modo, en la clave

`live` o `test` no es un ajuste de la cuenta: lo decide la clave. Una clave
de prueba trabaja sobre datos separados, no marca ningún número y no factura.
El código es el mismo; cambia una variable de entorno. Así, lo que pruebas
es exactamente lo que va a correr en producción.

## La celda, para no consultar nada

`co1` dice dónde viven los datos del workspace. El edge lee ese prefijo y
envía la petición a la celda correcta sin buscar en ninguna base de datos.
Es la razón por la que la URL de la API nunca lleva región.

## El checksum, para fallar temprano

Los últimos seis caracteres son un CRC32 del resto, en base62. Una clave mal
copiada se rechaza en el edge, con `401 api_key_malformed`, antes de llegar a
ningún servidor. Soporte reconoce ese error sin mirar nada más.

## Lo que no está en la clave

Qomni guarda sólo el hash SHA-256 de cada clave. Por eso la clave completa se
muestra una sola vez, al crearla, y después sólo se ven su prefijo y sus
últimos cuatro caracteres. Una clave perdida no se recupera: se crea otra y
se revoca la anterior.

```mermaid
flowchart LR
  K["sk_agents_live_co1_8fK2…Qa91Zx"] --> P[sk: secreta]
  K --> R[agents: producto]
  K --> M[live: modo]
  K --> C[co1: celda]
  K --> S[30 caracteres: secreto]
  K --> X[6 caracteres: checksum]
```

## Y los límites

Cada clave tiene su propio presupuesto: 120 peticiones por minuto. Las
peticiones rechazadas con `401` se cuentan aparte, por dirección IP, para que
un cliente mal configurado no agote el presupuesto de las claves válidas de
la misma red.

La anatomía completa está en
[API keys y autenticación](/es/concepts/authentication/).

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