Antes de empezar

• Crea una cuenta de IBM Cloud con pago por uso o por suscripción. No se admiten cuentas de prueba. Para obtener más información o para actualizar tu cuenta, consulta Tipos de cuenta.

• Crea un proyecto Red Hat AI Inference.

• Asegúrate de tener el rol de Writer o superior en el servicio Red Hat AI Inference. Para obtener más información, consulta Gestión del acceso a IAM.

Autenticación mediante un token de portador

Los tokens de portador garantizan un acceso seguro a las capacidades de inferencia de tu proyecto y se generan a partir de tu clave de API de IBM Cloud. Los tokens de portador caducan tras un periodo determinado, por lo que deben renovarse periódicamente.

El siguiente ejemplo muestra cómo recuperar un token de portador.

curl -X POST "https://iam.cloud.ibm.com/identity/token" --header "Content-Type: application/x-www-form-urlencoded" --header "Accept: application/json" --data-urlencode "grant_type=urn:ibm:params:oauth:grant-type:apikey" --data-urlencode "apikey=$<IBM_CLOUD_API_KEY>"

El token de portador es el que aparece en access_token la respuesta. Estos tokens tienen una fecha de caducidad y deben renovarse periódicamente.

{"access_token":"xxxxx","refresh_token":"not_supported","token_type":"Bearer","expires_in":3600,"expiration":1770058324,"scope":"ibm openid"}

Autenticación mediante una clave de API

Puede autenticarse con una clave API utilizando bien una clave API de ID de servicio, bien una clave API de usuario.

El uso de un ID de servicio es el método recomendado para gestionar y delegar permisos de acceso. Una vez creado el ID de servicio, crea una clave API de ID de servicio para autenticar tus solicitudes. Para obtener más información sobre cómo crear un ID de servicio y una clave de API en tu proyecto, consulta Primeros pasos con Red Hat AI Inference.

Cuando crees el ID del servicio en IAM, asigna el rol de acceso al servicio Writer para crear sugerencias de chat. Asigna el rol de acceso al servicio Lector si solo necesitas ver información sobre modelos o leer las respuestas automáticas del chat. No se requieren roles de acceso a la plataforma para acceder a la API.

También puedes autenticarte utilizando una clave API de usuario personal. Para obtener más información, consulte Gestión de claves de API de usuario.