메인 콘텐츠로 건너뛰기
Guard API를 사용하면 직접 만든 애플리케이션에 Starfort 가드레일을 내장할 수 있습니다 — 모델로 들어가는 입력 경로에서 호출하여(프롬프트를 마스킹하거나 차단) 그리고 나가는 출력 경로에서 호출하여(응답을 검사) 사용할 수 있습니다.

​
1. API 키 발급

API 키는 API 프로젝트 내의 Guardian에 속합니다. 콘솔에서 Guardian을 열고 → API Keys → Add API Key를 선택한 뒤 키를 복사하세요(키는 한 번만 표시되며 sf_로 시작합니다). API 키 관리를 참고하세요. 엔드포인트와 바로 사용할 수 있는 예제는 Guardian의 How to use 탭에 있습니다.

​
2. 요청 보내기

curl -X POST "https://bastion-guardian-api.starfort.io/v1/guard/api" \
  -H "Content-Type: application/json" \
  -H "X-Starfort-Guard-Api-Key: sf_your_key_here" \
  -d '{
    "messages": [
      { "role": "user", "content": "What time does the library open on weekends?" }
    ],
    "processType": "input"
  }'
processType는 Guardian이 선언하는 레이블입니다(일반적으로 들어오는 요청에는 input, 나가는 모델 응답에는 output을 사용). Guardian이 지원하는 값이어야 합니다 — 요청 형식을 참고하세요.

​
3. action 읽기

무해한 요청은 그대로 통과합니다: 
{ "action": "PASS", "input_results": [] }
PII가 포함된 내용을 보내면 Guardian이 이를 마스킹합니다(PII 정책이 할당된 경우): 
{
  "action": "MASK",
  "input_results": [{
    "index": 0, "type": "text", "action": "MASK",
    "processed_content": "My number is [PHONE_NUMBER_1].",
    "results": [ /* … */ ]
  }]
}
애플리케이션은 최상위 action 값에 따라 동작해야 합니다: MASK인 경우 processed_content를 전달하고, BLOCK인 경우 요청을 거부합니다. Topic 정책은 CHECK(검토가 필요한 논쟁적 주제로 표시됨)를 반환할 수도 있습니다 — API 호출자는 CHECK를 그대로 수신합니다. Actions를 참고하세요. Guardian이 분석할 수 없는 요청은 HTTP 오류를 반환하며, 탐지 결과가 빈 PASS를 반환하지 않습니다 — 따라서 오류가 “아무것도 탐지되지 않음”으로 오인되는 일이 결코 없습니다. 오류 및 상태를 참고하세요.
1

키 생성

콘솔에서 Guardian → API Keys 메뉴 아래에서 생성합니다.
2

엔드포인트 호출

X-Starfort-Guard-Api-Key 헤더와 함께 POST /v1/guard/api를 호출합니다.
3

action 처리

PASS → 계속 · MASK → processed_content 사용 · BLOCK → 중단.

​
다음 단계

인증

요청 형식

응답 형식

오류 및 상태