Creación de un proxy REST para " Gemini " con " AI Gateway

Crear un proxy REST que utilice el ' AI Gateway ' para controlar el acceso a los modelos AI.

1. En el panel de navegación, haga clic en " .

2. En la página Desarrollo, haga clic en Añadir > API.

3. En la página Seleccionar tipo de API, haga clic en la pestaña OpenAPI 3.0.

4. En la sección Crear, seleccione Pasarela AI y, a continuación, haga clic en Siguiente.

5. En la página Crear API desde pasarela de IA, utilice el campo Plataforma para seleccionar Google Gemini como el servicio de IA que utiliza la nueva API.

6. Utilice la sección "Info" para proporcionar información básica sobre la API y, a continuación, haga clic en Siguiente:
   • La versión OpenAPI se basa en la selección del paso 3, en el que ha hecho clic en OpenAPI 3.0

   • Título : El título puede incluir caracteres especiales, pero debe ser corto para que pueda mostrarse fácilmente en la interfaz de usuario.

   • El nombre se rellena en función del título. El valor es una cadena única que se utiliza para identificar la API en los comandos CLI del kit de herramientas para desarrolladores.

   • Versión: Acepte el valor predeterminado o modifíquelo según sea necesario. La versión corresponde al valor de la propiedad ' info.version ' de la definición OpenAPI. Se recomienda el esquema de numeración de versiones version.release.modification ; por ejemplo, 1.0.0.

   • Ruta base: Acepta el valor por defecto o modifícalo según necesites. La "ruta base" de la API es el servidor URL, que se utiliza para determinar el punto final completo URL para la llamada a la API, teniendo en cuenta cualquier configuración de punto final de vanidad en el catálogo en el que se publica la API. Para una API reforzada por DataPower® API Gateway, sólo es necesario proporcionar el valor de la ruta base. Además:
     • No incluya el nombre de host ni segmentos adicionales para rutas u operaciones
     • No incluya caracteres especiales
     • Comienza URL con una barra oblicua ( / ) aunque esté vacía

   • Descripción: La descripción opcional ayuda a identificar la API.
7. Proporcione el valor de la clave de API o la variable $(nombre de una propiedad del catálogo) cuyo valor es la clave de API y, a continuación, haga clic en Siguiente. La clave API permite a la API autenticarse con Google Studio, y es necesaria para acceder al servicio Gemini .
8. Proporcione información sobre cómo la API accede a ' Gemini ' para enviar solicitudes y, a continuación, haga clic en Crear:
   • Rutas expuestas: Acepte la lista predeterminada de rutas expuestas o seleccione solo las rutas a las que desea que acceda su API. Las rutas expuestas definen qué operaciones ' Gemini ' se incluyen en la API generada.

   • Activar cach é de respuesta: La caché de respuesta está activada por defecto para optimizar el rendimiento de la API; sin embargo, puede desactivarla si es necesario para su API. Si utiliza la caché de respuesta, puede especificar la duración de la caché en la propiedad Expiración de la caché de respuesta de la interfaz de usuario de la política.

     Cuando la caché de respuesta está activada, cuando se envía una solicitud al servicio " Gemini ", se inspecciona la caché de respuesta para determinar si la carga útil de la solicitud tiene una respuesta en caché asociada. Si es así, esa respuesta y sus cabeceras de respuesta HTTP asociadas se colocan en el mensaje de contexto DataPower API Gateway (que por defecto se llama message ). La propiedad Mensaje de salida de la interfaz de usuario de la política puede modificarse una vez generada la API si se necesita un mensaje diferente.

     Si no hay respuesta en caché, la solicitud se pasa al servicio Gemini , y la respuesta se almacena en caché para operaciones posteriores utilizando el tiempo de vida especificado en la propiedad Expiración de caché de respuesta.

     Si activa la caché de respuesta, configure la duración de la caché en el campo Caducidad de la caché de respuesta de la interfaz de usuario de la política aceptando el valor predeterminado o seleccionando (o escribiendo) un nuevo valor. La duración mínima es de 60 segundos y la duración máxima es de 86400 segundos (1 día) - cualquier valor fuera de ese rango fallará la validación cuando se publique la API, incluso si el valor es aceptado en este campo.
   • En la sección Limitación de tarifa, seleccione Crear producto si desea generar un producto " API Connect " que controle la limitación de tarifa para la API.

     En " API Connect", un producto sirve de contenedor para una API y sus planes de uso asociados, que definen los límites de las tarifas. Al establecer aquí los límites de tarifa de producto se crea un plan que contiene los límites de tarifa de montaje " gemini-default " y " gemini-token-weighted requeridos y se especifican los límites definidos por usted.

     Si decide no generar un producto automáticamente, deberá crearlo como se explica en Creación de un proxy REST para Gemini con AI Gateway.

     Atención: Un producto creado posteriormente con la función de autopublicación (al publicar su API) no incluye el plan necesario para utilizar el servicio AI. Cree el producto ahora o cree un producto personalizado antes de publicar la API.

     Configure los tipos de limitación de velocidad que se aplicarán a las llamadas a la API:

     Nota: Si decide no especificar los valores de un límite de tarifa, se asignarán valores por defecto para ese límite de tarifa.
     • Establecer límite de velocidad : (Basado en el tiempo) Acepte el límite de velocidad predeterminado o configure un nuevo límite basado en el número de solicitudes de API enviadas en un periodo de tiempo especificado. Este tipo de límite de tarifa no utiliza fichas.

     • Establecer límite de tokens AI : (Basado en tokens) Acepta el límite de tarifa por defecto o configura un nuevo límite basado en el número de tokens basados en costes utilizados en un periodo de tiempo determinado. La limitación de tarifa basada en tokens utiliza la operación " /chat/completions " para realizar un seguimiento del uso de tokens.

       El límite de tokens AI aplica una limitación de tarifa basada en el uso de tokens. El límite de velocidad determina cuántos tokens pueden pasar por la pasarela en un periodo de tiempo determinado.

9. Revise la página Resumen para comprobar que la API no presenta problemas.

10. Edite la nueva API y añada políticas y construcciones lógicas que controlen el flujo de trabajo de la API.

    La API creada contiene las políticas de invocación Gemini para las rutas expuestas que se solicitaron. Sus propiedades pueden editarse según sea necesario.