API에 대한 인증

Red Hat AI Inference 서비스에 API 호출을 수행하기 전에 요청에 대한 인증을 완료해야 합니다. 베어러 토큰이나 IBM Cloud API 키 중 하나를 사용하여 인증할 수 있습니다.

시작하기 전에

  • IBM Cloud 계정을 종량제 또는 구독형으로 생성하세요. 체험 계정은 지원되지 않습니다. 자세한 내용을 확인하거나 계정을 업그레이드하려면 ‘계정 유형’을 참조하세요.

  • Red Hat AI Inference 프로젝트를 생성합니다.

  • Red Hat AI Inference 서비스에서 ‘Writer’ 역할 이상을 보유하고 있는지 확인하십시오. 자세한 내용은 ‘IAM 액세스 관리’를 참조하십시오.

베어러 토큰을 사용한 인증

베어러 토큰은 프로젝트의 추론 기능에 대한 안전한 액세스를 보장하며, IBM Cloud API 키를 통해 생성됩니다. 무기명 토큰은 정해진 기간이 지나면 만료되므로, 주기적으로 갱신해야 합니다.

다음 예제는 베어러 토큰을 가져오는 방법을 보여줍니다.

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

보유자 토큰은 응답에 포함된 ‘ access_token ’입니다. 이 토큰에는 유효 기간이 있으므로 주기적으로 갱신해야 합니다.

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

API 키를 사용하여 인증하기

서비스 ID API 키나 사용자 API 키 중 하나를 사용하여 API 키로 인증할 수 있습니다.

서비스 ID를 사용하는 것이 액세스 권한을 관리하고 위임하는 데 권장되는 방법입니다. 서비스 ID를 생성한 후, 요청을 인증하기 위해 서비스 ID API 키를 생성하십시오. 프로젝트 내에서 서비스 ID 및 API 키를 생성하는 방법에 대한 자세한 내용은 ‘ Red Hat AI Inference 시작하기’를 참조하세요.

IAM에서 서비스 ID를 생성할 때, 채팅 자동 완성 기능을 생성하려면 ‘Writer’ 서비스 액세스 역할을 할당하십시오. 모델 정보를 확인하거나 채팅 완성 내용을 읽기만 하면 되는 경우, ‘Reader’ 서비스 액세스 역할을 할당하세요. API에 액세스하는 데는 플랫폼 액세스 역할이 필요하지 않습니다.

또는 개인 사용자 API 키를 사용하여 인증할 수도 있습니다. 자세한 정보는 사용자 API 키 관리를 참조하십시오.