Autenticação na API
Antes de poder fazer chamadas de API para o serviço Red Hat AI Inference, você precisa autenticar suas solicitações. Você pode se autenticar usando um token de portador ou uma chave de API do IBM Cloud.
Antes de Iniciar
-
Crie uma conta no IBM Cloud no modelo “pague conforme usar” ou por assinatura. Não são oferecidas contas de teste. Para obter mais informações ou para fazer o upgrade da sua conta, consulte Tipos de conta.
-
Certifique-se de que você tenha a função “Writer” ou superior no serviço Red Hat AI Inference. Para obter mais informações, veja Gerenciando acesso ao IAM.
Autenticação por meio de um token de portador
Os tokens de portador garantem acesso seguro aos recursos de inferência do seu projeto e são gerados a partir da sua chave da API do IBM Cloud. Os tokens ao portador expiram após um período determinado, por isso devem ser atualizados periodicamente.
O exemplo a seguir mostra como recuperar um 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>"
O token de portador é o “ access_token ” na resposta. Esses tokens têm uma data de validade e devem ser atualizados periodicamente.
{"access_token":"xxxxx","refresh_token":"not_supported","token_type":"Bearer","expires_in":3600,"expiration":1770058324,"scope":"ibm openid"}
Autenticação por meio de uma chave de API
Você pode se autenticar com uma chave de API usando uma chave de API de ID de serviço ou uma chave de API de usuário.
O uso de um ID de serviço é o método recomendado para gerenciar e delegar permissões de acesso. Depois de criar um ID de serviço, crie uma chave de API de ID de serviço para autenticar suas solicitações. Para obter detalhes sobre como criar um ID de serviço e uma chave de API no seu projeto, consulte “Introdução ao Red Hat AI Inference ”.
Ao criar o ID do serviço no IAM, atribua a função de acesso “Writer” ao serviço para criar sugestões de chat. Atribua a função de acesso “Leitor” se você precisar apenas visualizar informações do modelo ou ler respostas automáticas do chat. Não são necessárias funções de acesso à plataforma para acessar a API.
Como alternativa, você pode se autenticar usando uma chave de API pessoal de usuário. Para obter mais informações, consulte Gerenciando as chaves de API do usuário.