> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-d2fddb8a.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, almacena el token bearer de forma segura y verifica que funciona con una primera solicitud autenticada a chat completions.

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/getting-started/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). 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>

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