0 / 0
영어 버전 문서로 돌아가기

프로그래밍 방식 액세스를 위한 인증 정보 (IBM Cloud API키 및 IAM 토큰)

마지막 업데이트 날짜: 2025년 2월 03일
프로그래밍 방식 액세스를 위한 인증 정보 (IBM Cloud API키 및 IAM 토큰)

IBM watsonx.ai 에서 프로그래밍 방식으로 기본 모델에 대해 작업하려면 watsonx.ai 자원에 액세스할 수 있는 권한이 있음을 증명하도록 인증해야 합니다.

REST API 신임 정보

대부분의 API 메서드의 경우 요청에 IBM Cloud Identity and Access Management (IAM) 베어러 토큰을 액세스 토큰으로 포함해야 합니다. IBM Cloud API 키를 사용하여 IAM 무기명 토큰을 생성합니다.

REST API 요청을 인증하려면 다음 단계를 완료하십시오.

  1. 다양한 방법으로 IBM Cloud API키를 작성할 수 있습니다.

    자세한 내용은 IBM Cloud API 키를 참조하세요.

  2. IBM Cloud API키를 사용하여 IAM 베어러 토큰을 작성하십시오.

    자세한 정보는 API 키를 사용하여 IBM Cloud IAM 토큰 생성을 참조하십시오.

  3. REST 요청을 제출할 때 IAM 토큰을 지정하십시오.

    curl -X 'POST' https://{region}.ml.cloud.ibm.com/ml/v1/text/generation
    --header "Authorization: Bearer {IAM-token}..."
    

토큰이 만료되면 토큰을 새로 고쳐야 합니다. 토큰을 새로 고치려면 2단계에서시작하는 프로시저를 반복하십시오.

Python 라이브러리 신임 정보

Python 라이브러리를 사용할 때 API키 또는 IAM 토큰을 사용하도록 선택할 수 있습니다.

IAM 토큰을 직접 작성하고 라이브러리에 토큰을 전달하는 경우, 만기되기 전에 토큰 새로 고치기를 관리해야 합니다.

API키를 라이브러리의 APIClient에 전달하면 클라이언트가 IAM 토큰을 생성하고 필요에 따라 토큰을 새로 고칩니다.

라이브러리에서 IBM Cloud API키 사용

다양한 방법으로 IBM Cloud API키를 작성할 수 있습니다. 자세한 내용은 IBM Cloud API 키를 참조하세요.

다음 샘플 코드 스니펫은 Python 라이브러리를 사용할 때 인증을 위해 API키를 직접 사용하는 방법을 보여줍니다.

from ibm_watsonx_ai.foundation_models import ModelInference

model_inference = ModelInference(
    model_id="ibm/granite-13b-chat-v2",
    credentials={
        "apikey": "***",
        "url": "https://{region}.ml.cloud.ibm.com"
    },
    project_id="*****"
    )

 

APIClient 사용

또는 라이브러리에서 사용 가능한 APIClient 를 사용할 수 있습니다. 클라이언트를 인스턴스화한 후에는 각 메소드를 사용하여 신임 정보를 지정할 필요가 없습니다.

from ibm_watsonx_ai import APIClient
from ibm_watsonx_ai import Credentials

credentials = Credentials(
  url = "https://{region}.ml.cloud.ibm.com",
  api_key = "{api-key}"
)

client = APIClient(credentials)

자세한 내용은 인증을 참조하세요.

기본 프로젝트 또는 공간 ID를 설정할 수도 있습니다. 자세한 정보는 프로젝트 ID찾기를 참조하십시오.

 

작업 자격 증명 만들기

기초 모델 조정과 같은 일부 장기 작업이나 작업의 경우 작업 자격 증명이 필요합니다.

작업 자격 증명을 생성하려면:

task_credentials_details = client.task_credentials.store()

자격 증명을 나열하려면:

client.task_credentials.list()

반환되는 자격 증명 목록에는 각 작업 자격 증명에 대한 작업 자격 증명 ID인 자격 증명 ID( asset_id )가 포함됩니다.

인증서의 ID를 알고 있다면 다음과 같이 삭제할 수 있습니다

client.task_credentials.delete(task_credentials_id)

더 자세한 정보를 원하시면, Python 라이브러리의 작업 자격 증명 클래스를 참고하세요.

또는 제품 UI를 사용하여 작업 자격 증명을 생성하거나 삭제할 수 있습니다. 자세한 내용은 작업 자격 증명 관리를 참고하세요.

자세히 알아보기

상위 주제: 제너레이티브 AI 솔루션 코딩하기