Saltar al contenido principal
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.
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.

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

Abrir la configuración de la API

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

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

Generar y copiar la clave

Haz clic en Generate. Venice mostrará la clave de API completa una sola vez.
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.
Añade la clave a tu entorno local o gestor de secretos:
export VENICE_API_KEY="your-api-key-here"
4

Verificar la clave

Realiza una solicitud de bajo riesgo para confirmar que la autenticación funciona:
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>.

​
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:

Crear clave de API

Crea una nueva clave de API estilo dashboard a partir de una clave admin existente.

Listar claves de API

Visualiza las claves activas y sus metadatos.

Actualizar clave de API

Actualiza la descripción de una clave, su fecha de expiración o los límites de consumo.

Eliminar clave de API

Revoca una clave que ya no se necesita.