> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-86b9f77a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Generar una clave de API

> Crea una clave de API de Venice desde el panel, guarda el bearer de forma segura y verifica con una primera llamada autenticada al API.

Las solicitudes a la API de Venice se autentican con claves de API tipo Bearer. Esta guía muestra cómo crear una clave desde el panel de Venice, almacenarla de forma segura y verificar que funciona.

<Note>
  Si estás construyendo un agente autónomo que necesita generar su propia clave con una wallet, utiliza en su lugar la guía [Creación de claves de API para agentes autónomos](/guides/integrations/generating-api-key-agent).
</Note>

## Antes de comenzar

* Inicia sesión en tu cuenta de Venice.
* Asegúrate de que la cuenta tenga un saldo disponible antes de llamar a endpoints de pago. Puedes crear una clave antes de financiar la cuenta, pero las solicitudes a los modelos no se completarán hasta que la cuenta pueda consumir DIEM, créditos incluidos o USD.

<Steps>
  <Step title="Abrir la configuración de la API">
    Visita [https://venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation). También puedes abrir esta página desde la aplicación de Venice seleccionando **API** en tu configuración.

    El panel de configuración de la API muestra tus saldos, el nivel de la API, el uso y las claves de API existentes.
  </Step>

  <Step title="Iniciar una nueva clave">
    Selecciona **Generate New API Key** y luego configura la clave:

    * **Description:** Usa un nombre corto que identifique la aplicación, el entorno o la integración que utilizará esta clave.
    * **API Key Type:** Usa **Inference Only** para solicitudes normales a los modelos. Usa **Admin** solo cuando la clave deba gestionar claves de API de forma programática.
    * **Expires at:** Opcionalmente, establece una fecha de expiración. Si lo dejas en blanco, la clave no expirará automáticamente.
    * **Epoch Consumption Limits:** Opcionalmente, limita cuánto DIEM o USD puede gastar esta clave durante un epoch de 24 horas. Si lo dejas en blanco, la clave podrá usar el saldo disponible de la cuenta sujeto a los límites de tu cuenta.
  </Step>

  <Step title="Generar y copiar la clave">
    Haz clic en **Generate**. Venice mostrará la clave de API completa una sola vez.

    <Warning>
      Copia la clave de inmediato y guárdala en un lugar seguro. Después de cerrar el cuadro de diálogo, Venice solo mostrará metadatos identificativos como la descripción de la clave y los últimos caracteres. Si pierdes el valor secreto, elimina la clave y crea una nueva.
    </Warning>

    Añade la clave a tu entorno local o gestor de secretos:

    ```bash theme={null}
    export VENICE_API_KEY="your-api-key-here"
    ```
  </Step>

  <Step title="Verificar la clave">
    Realiza una solicitud de bajo riesgo para confirmar que la autenticación funciona:

    ```bash theme={null}
    curl --request GET \
      --url https://api.venice.ai/api/v1/models \
      --header "Authorization: Bearer $VENICE_API_KEY"
    ```

    Una respuesta exitosa devuelve los modelos disponibles. Si recibes un error de autenticación, confirma que la clave se copió por completo y que el encabezado `Authorization` tiene el formato `Bearer <api-key>`.
  </Step>
</Steps>

<Warning>
  Deshabilitar el gasto en USD al crear una clave API en la aplicación de Venice establece tu límite de gasto en USD en cero para esa clave API. Las llamadas a la API pueden fallar con un error de saldo insuficiente cuando tu DIEM disponible o los créditos agrupados no puedan cubrir la solicitud, incluso si tu cuenta tiene saldo en USD.
</Warning>

## Solución de errores de límite de gasto

Los límites de gasto por clave son independientes del saldo de tu cuenta. Una clave puede quedar bloqueada para gastar incluso cuando tu cuenta todavía tiene créditos en USD financiados, DIEM o créditos incluidos. Si una solicitud devuelve un 402 con uno de estos códigos, la causa es el propio límite de la clave y no el saldo de tu cuenta:

* `API_KEY_USD_SPEND_LIMIT_EXCEEDED` — el límite de gasto en USD de la clave está establecido en cero (el gasto en USD se deshabilitó al crearla) o el epoch actual ha alcanzado su tope en USD.
* `API_KEY_DIEM_SPEND_LIMIT_EXCEEDED` — la clave ha alcanzado su tope de DIEM para el epoch actual de 24 horas.

Para confirmar el estado actual de una clave, llama a [Obtener límites de tasa y saldos de la clave de API](/api-reference/endpoint/api_keys/rate_limits) e inspecciona `data.accessPermitted`, `data.balances` y los límites de consumo por clave.

Para resolver el error, aumenta o elimina los Epoch Consumption Limits de la clave en [venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation), o llama a [Actualizar clave de API](/api-reference/endpoint/api_keys/update) con nuevos `consumptionLimits`. Los saldos a nivel de cuenta (USD, DIEM y créditos incluidos) son fuentes de pago independientes y se consumen automáticamente según estén disponibles; no es necesario elegir una en el momento de la solicitud.

Consulta [Códigos de error](/api-reference/error-codes) para ver la lista completa de respuestas relacionadas con la facturación.

## Buenas prácticas

* Crea claves separadas para desarrollo, staging y producción.
* Prefiere claves **Inference Only** para aplicaciones que solo llaman a endpoints de modelos.
* Mantén las claves **Admin** como excepcionales, con un alcance estricto y almacenadas únicamente en entornos confiables del lado del servidor.
* Nunca subas claves de API al control de versiones ni las expongas en código del lado del cliente.
* Establece fechas de expiración y límites de consumo para claves usadas en entornos temporales, compartidos o de mayor riesgo.
* Elimina las claves que no uses y rota cualquier clave que pueda haber sido expuesta.

## Gestión programática de claves

Las claves Admin pueden gestionar claves de API mediante los endpoints de la referencia de la API:

<CardGroup cols={2}>
  <Card title="Crear clave de API" icon="plus" href="/api-reference/endpoint/api_keys/create">
    Crea una nueva clave de API estilo dashboard a partir de una clave admin existente.
  </Card>

  <Card title="Listar claves de API" icon="list" href="/api-reference/endpoint/api_keys/list">
    Visualiza las claves activas y sus metadatos.
  </Card>

  <Card title="Actualizar clave de API" icon="pen-to-square" href="/api-reference/endpoint/api_keys/update">
    Actualiza la descripción de una clave, su fecha de expiración o los límites de consumo.
  </Card>

  <Card title="Eliminar clave de API" icon="trash" href="/api-reference/endpoint/api_keys/delete">
    Revoca una clave que ya no se necesita.
  </Card>
</CardGroup>