Autenticazione all'API

Prima di poter effettuare chiamate API al servizio Red Hat AI Inference, è necessario autenticare le richieste. È possibile effettuare l'autenticazione utilizzando un token "bearer" oppure una chiave API " IBM Cloud ".

Prima di iniziare

  • Crea un account " IBM Cloud " con pagamento a consumo o in abbonamento. Non sono supportati gli account di prova. Per ulteriori informazioni o per passare a un account di livello superiore, consulta la sezione " Tipi di account ".

  • Crea un progetto " Red Hat AI Inference ".

  • Assicurati di disporre del ruolo "Writer" o di un ruolo superiore nel servizio " Red Hat AI Inference ". Per ulteriori informazioni, vedi Gestione dell'accesso IAM.

Autenticazione tramite token bearer

I token al portatore garantiscono un accesso sicuro alle funzionalità di inferenza del tuo progetto e vengono generati dalla tua chiave API IBM Cloud. I token al portatore scadono dopo un determinato periodo, pertanto devono essere aggiornati periodicamente.

L'esempio seguente illustra come recuperare un token bearer.

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

Il token al portatore è l' access_token " presente nella risposta. Questi token hanno una data di scadenza e devono essere aggiornati periodicamente.

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

Autenticazione tramite chiave API

È possibile effettuare l'autenticazione con una chiave API utilizzando sia una chiave API con ID servizio che una chiave API utente.

L'utilizzo di un ID servizio è il metodo consigliato per gestire e delegare le autorizzazioni di accesso. Dopo aver creato un ID servizio, crea una chiave API dell'ID servizio per autenticare le tue richieste. Per ulteriori informazioni sulla creazione di un ID servizio e di una chiave API all'interno del proprio progetto, consultare la guida introduttiva su Red Hat AI Inference.

Quando crei l'ID del servizio in IAM, assegna il ruolo di accesso al servizio Writer per creare i completamenti della chat. Assegna il ruolo di accesso “Reader” se devi solo visualizzare le informazioni del modello o leggere i completamenti delle chat. Per l'accesso alle API non sono richiesti ruoli di accesso alla piattaforma.

In alternativa, è possibile effettuare l'autenticazione utilizzando una chiave API utente personale. Per ulteriori informazioni, vedi Gestione delle chiavi API utente.