GenAI Shield API

기본 정보

Base URL

http://shield.gensapps.com/v1

인증 헤더

Authorization: Bearer sk-genai-…

엔드포인트

POST /v1/chat/completions GET /v1/models

호환

OpenAI Chat Completions API (스트리밍 stream:true 지원)

curl http://shield.gensapps.com/v1/chat/completions \
  -H "Authorization: Bearer sk-genai-발급받은키" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "안녕하세요"}]
  }'

# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="http://shield.gensapps.com/v1",
    api_key="sk-genai-발급받은키",
)

resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    messages=[{"role": "user", "content": "안녕하세요"}],
)
print(resp.choices[0].message.content)

// npm i openai
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "http://shield.gensapps.com/v1",
  apiKey: "sk-genai-발급받은키",
});

const r = await client.chat.completions.create({
  model: "google/gemini-2.5-pro",
  messages: [{ role: "user", content: "안녕하세요" }],
});
console.log(r.choices[0].message.content);

# pip install langchain-openai
from langchain_openai import ChatOpenAI

# 기존 LangChain 코드에서 base_url·api_key·model 만 바꾸면 그대로 동작
llm = ChatOpenAI(
    base_url="http://shield.gensapps.com/v1",
    api_key="sk-genai-발급받은키",
    model="openai/gpt-4o",
)
print(llm.invoke("안녕하세요").content)

스트리밍은 요청 본문에 "stream": true 를 추가하면 SSE로 응답합니다.

LangChain·LlamaIndex·Vercel AI SDK 등 OpenAI 호환 프레임워크는 base URL·키만 바꾸면 기존 코드 그대로 동작합니다.

보안 동작

• 요청이 벤더로 나가기 전에 정책에 따라 민감정보를 마스킹·차단합니다.
• 차단 정책에 걸리면 벤더로 보내지 않고 400 으로 거부합니다.
• 응답(출력) 스캔을 켜면 AI 답변 속 개인정보도 되돌려 가립니다.
• 탐지 내역은 원문을 저장하지 않고 마스킹된 표본으로만 남깁니다(개인정보보호법 대응).