Clave de API de Gemini: obtener, configurar y probar

01Cree una clave de API de OmniaKey

Inicie sesión, abra API Keys y cree una clave para su aplicación. Revise su cuota, caducidad y restricciones de modelos. Añada saldo antes de lanzar solicitudes de generación.

02Defina la clave y la URL de la API

Ejecute los comandos en su terminal y sustituya el marcador de posición por su clave. Guarde la clave en su servidor o en un gestor de secretos. Nunca la incluya en código del navegador ni en un repositorio público.

export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03Compruebe la autenticación

Solicite la lista de modelos sin iniciar una tarea de generación. Una respuesta correcta es JSON con un array data. Esto comprueba el acceso de la clave; no demuestra que todos los modelos estén habilitados para su cuenta.

curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04Use el formato de solicitud del modelo

Seleccione un modelo en la página de la familia, copie su ID de API y siga la documentación de API correspondiente. La autenticación por sí sola no comprueba sus parámetros de generación.

Su cliente debe admitir el protocolo del modelo elegido. Revise la documentación del modelo antes de cambiar entre Chat Completions, Responses o un endpoint nativo del proveedor.

Solicitud de generación de ejemplo (con cargo)

Esta solicitud usa el saldo de su cuenta. Revise primero el precio del modelo elegido. El ejemplo sigue el formato de solicitud documentado; su cuenta aún necesita acceso al modelo.

curl --fail-with-body 'https://api.omniakey.com/v1beta/models/gemini-4-argon:generateContent' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {
      "parts": [
        {
          "text": "Explain what an API key does in one sentence."
        }
      ]
    }
  ]
}'