블로그

AI API, 아키텍처, 안정적인 LLM 도구에 관한 실용적인 글입니다.

API 및 통합

OpenAI API 키 거버넌스: 생성 규칙, 소유권, 만료와 무중단 로테이션

OpenAI는 2026년 9월 조직·프로젝트 수준의 새 API 키 생성 제한과 새 프로젝트 키의 만료일 및 최대 유효기간을 추가했습니다. 이 글은 조직 정책의 우선순위, 서비스 계정 키와 사용자 소유 키 선택, 기존 키 이전, 애플리케이션을 멈추지 않는 중첩 로테이션 절차를 실무 관점에서 정리합니다.

글 읽기
API 및 통합

Gemini API를 활용한 장시간 비디오 인덱싱: 타임스탬프, 시각 정보 및 누락 구간 감사

Gemini API를 활용하여 장시간 비디오 녹화본을 인덱싱하는 엔지니어링 워크플로입니다. Files API를 통한 대용량 파일 업로드, Interactions API에서의 에이전틱(Agentic) 모드 초안 생성, 구조화된 데이터 행의 프로그래밍 방식 유효성 검증, 그리고 타임라인 누락 구간에 대한 정밀한 타깃 검수 파이프라인을 제시합니다.

글 읽기
API 및 통합

대용량 PDF에서 표 데이터를 추출하고 수치를 검증하는 방법

대용량 PDF에서 표를 추출할 때는 Files API와 nullable 스키마를 적용한 Gemini API 워크플로를 구성하는 것이 적절합니다. 모델이 생성한 페이지 번호와 인용 스니펫은 원문 위치를 찾기 위한 미검증 단서일 뿐, 사실을 입증하거나 환각을 방지하는 수단이 아닙니다. 따라서 추출된 값은 시각적으로 렌더링된 원본 PDF와 직접 대조하여 일치 여부를 확인해야 합니다.

글 읽기
일상 업무용 AI

Gemini 3.5 Transcribe를 활용한 회의 전사 실무: 화자 분리, 타임스탬프, 커스텀 어휘 적용 가이드

Gemini 3.5 Transcribe를 활용해 전문 기술 용어가 포함된 45분 분량의 2인 비즈니스 회의 녹음본을 검증된 회의록 및 자막용 타임라인으로 변환하는 실무 가이드입니다. API 설정 플래그(smart 모드, diarization_mode, timestamp_granularities, custom_vocabulary)의 호환성 및 제약 사항을 분석하고, 30분 오디오 길이 제한을 극복하기 위한 오디오 분할 전략을 제시합니다. 공식 Python SDK를 이용해 2개 파트로 분할된 음원을 처리하고, 타임스탬프 오프셋 보정 및 화자 매핑을 거쳐 예비 데이터 구조를 생성하는 완전한 파이프라인을 다룹니다. 또한 자동 생성된 초안 파일(meeting_transcript.txt, word_timestamps.json)을 실무에 전달하기 전 수행해야 하는 청취 기반의 3단계 수동 품질 검증(화자 식별, 용어·수치 검증, 구간 연속성) 및 프로세스 중단 조건(Stop Conditions)을 상세히 설명합니다.

글 읽기
AI 코딩

Claude Code Auto Mode의 서버 측 분류기: 과금, 게이트웨이 및 Fallback 로직

Claude Code v2.1.278 업데이트 심층 분석: Auto Mode의 서버 측 보안 검사가 추가 비용을 발생시키지 않는 이유, 과금 대상인 클라이언트 Fallback이 트리거되는 시점, 트래픽 투명 패스스루(pass-through)를 위한 기업용 게이트웨이 설정 방법, 그리고 CLAUDE_CODE_AUTO_MODE_SERVER 환경 변수의 실제 역할과 영향을 살펴봅니다.

글 읽기
API 및 통합

이메일에서 JSON 추출하기: 스키마 유효성이 데이터의 진실성을 보장하지 못하는 이유와 자동화 보호 방법

JSON Schema와의 구문적 일치성이 추출된 데이터의 사실적 정확성을 보장하지 못하는 이유를 분석하고, 내부 프로덕션 시스템으로 값을 라우팅하기 전에 애플리케이션 레벨에서 구축해야 하는 2단계 검증 파이프라인 설계 및 구현 방안을 설명합니다.

글 읽기
일상 업무용 AI

OpenAI Image API의 트루 알파 채널: 투명 PNG 생성 및 검증 방법

OpenAI Image API를 통해 트루 알파 채널이 포함된 투명 PNG 그래픽 애셋을 생성하는 실무 가이드입니다. API 파라미터 설정과 단일 프롬프트 내에서 원치 않는 요소를 배제하는 문구 작성법, 그리고 Python Pillow를 활용해 가장자리 품질 및 알파 채널을 빠르고 정확하게 검증하는 방법을 다룹니다.

글 읽기