이전 강의에서는 Google AI Studio에서 Gemini API 키를 발급받는 방법을 살펴봤어요. 이번에는 발급받은 키를 활용해 플렉스튜디오에서 연동하는 과정을 살펴볼게요.
1. 플렉스튜디오 워크스페이스 > 좌측 메뉴에서 데이터 > ‘API 연동’ 버튼을 클릭해주세요.
2. ‘+’ 모양의 버튼을 클릭해 API 모듈을 새로 생성해주세요.
3. ‘New API’가 기본적으로 선택되어 있어요. API 명을 자유롭게 입력해주세요.
4. 새 API가 만들어졌어요.
Gemini는 텍스트 모델 뿐만 아니라 이미지, 비디오, 음성 등 다양한 AI 모델을 지원해요. 이번 강의에서는 기본적인 텍스트 모델들을 사용해 볼 거에요. 자세한 내용은 구글의 Gemini API 문서를 참조해주세요.
저희는 API를 사용하기 때문에, REST 탭으로 들어가볼게요. 복잡하지만 차근차근 분석해볼게요!
1️⃣ HTTP Method (-X 부분)
2️⃣ Endpoint (curl 부분)
https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent
gemini-2.5-flash-lite: 사용할 모델명generateContent: 텍스트를 생성하는 액션3️⃣ Header (-H 부분)
Content-Type = ‘application/json’
x-goog-api-key = 이곳에 API 키를 삽입해요!
저희는 플렉스튜디오의 Advanced Key Settings를 사용하기 때문에, 해당 부분을 {=Token}으로 변경해줄게요.
Advanced Key Setting > Secret Key 탭에서 Key를 Token으로, Value를 아까 복사한 Gemini API Key로 삽입할게요.
이 방법은 클라이언트에 Key가 노출되지 않아 안전해요.
4️⃣ Body (-d 부분)
다음과 같이 변경해줄게요. {=ParamBlocks}는 플렉스튜디오에서 컬렉션의 데이터를 전달하는 데이터 블록이에요.
Script 탭에서 저희가 원하는 방식으로 ParamBlocks를 꾸며줄 겁니다.
Script를 다음과 같이 작성해주세요.
ParamBlocks Convert Script:
let params = [];
for (let item of paramBlocks[0]) {
params.push({
"role": item.role,
"parts": [
{
"text": item.content
}
]
});
}
return params;
ResultBlocks Convert Script:
if (resultBlocks && resultBlocks[0][0]) {
let candidates = resultBlocks[0][0].candidates || [];
let geminiMessage = []
for (let geminiItem of candidates){
geminiMessage.push(geminiItem.content.parts[0].text)
}
resultBlocks[0] = geminiMessage
}
각각 {=ParamBlocks}와 {=ResultBlocks}에 대체되어 들어갈 스크립트랍니다. {=ParamBlocks}의 경우, Body의 형식에 맞게 수정했어요.
이외에도 Body 부분에 다양한 옵션을 추가할 수 있어요.
온도, Top P, Top K 등을 설정할 수 있고, 최대 토큰을 설정할 수 있어요. 또한 추론 기능도 사용할 수 있습니다.
저희는 가장 기본적인 기능만 사용해볼게요.
1. 테스트 탭으로 이동한 후, Test Param Blocks를 다음과 같이 작성해주세요.
이전에 ParamBlocks Convert Script에서 ParamBlock의 아이템 명칭을 각각 ‘role’과 ‘content’로 정했기 때문에, 다음과 같이 넣어주고 content는 자유롭게 작성해도 상관없어요!
2. 아래의 ‘Test Call’ 버튼을 클릭하면 테스트 호출을 진행할 수 있어요. Status 200이 나오면서 정상적으로 API가 동작한 것을 확인하실 수 있어요. 또한 ResultBlocks 탭에서 결과물도 확인하실 수 있답니다.
3. 모두 확인하셨으면, 오른쪽 밑의 ‘배포’ 버튼을 클릭하여 배포를 완료하고 API를 완성할 수 있어요. 변경사항이 있을 때마다 ‘배포’ 버튼을 클릭해 저장하시는 걸 추천해요.
플렉스튜디오에서 Gemini API를 모듈로 등록하는 과정을 완료했어요. 다음 글에서는 실제 시나리오에서 API를 호출하고 활용하는 방법을 이어서 소개할게요.