AI 실전 가이드

AI를 쓰다가 막혔을 때

요금제를 고를 때, API가 멈췄을 때, 새 모델로 옮길 때.지금 풀어야 할 문제부터 찾아보세요.

본문·공식 문서 확인

실전 가이드 글 전체 보기

01 / 비용

요금과 사용 한도

유료 결제 전에 무엇을 비교해야 할까?

한 달에 내는 돈과 얼마나 쓸 수 있는지는 다른 질문입니다. 먼저 웹·앱 구독인지, 개발용 API인지 확인하고 아래 항목을 나눠 적어보세요.

웹·앱 구독
결제 주기와 세금, 원하는 모델의 사용 한도, 파일·이미지 기능을 확인합니다. 무료 체험과 정기 결제 조건도 따로 봅니다.
개발용 API
입력·출력·캐시 단가를 구분하고 월 호출 수를 곱합니다. 검색 도구, 이미지, 오디오 등 추가 과금 항목은 토큰 비용에 별도로 더합니다.
호출 한도
분당 요청 수와 토큰 수, 일일 한도 중 무엇에 먼저 걸리는지 확인합니다. 예산이 남아도 순간 호출량 때문에 요청이 막힐 수 있습니다.

예산을 잡을 때는 실제 업무 몇 건의 입력·출력 토큰을 기록해 평균을 구하세요. 짧은 질문 하나로 긴 문서 요약이나 여러 번 도구를 쓰는 작업의 비용까지 추정하면 오차가 커집니다.

토큰 수로 API 비용 계산하기

한도 구조 참고: Gemini API 사용 한도. 계정별 현재 한도는 해당 서비스의 사용량 화면에서 확인하세요.

02 / 오류

API 오류와 운영

429 오류가 났을 때 재시도해도 될까?

상태 코드와 오류 본문을 같이 읽어야 합니다. 같은 429라도 일시적인 호출량 제한인지, 결제·사용량 상한인지에 따라 조치가 달라집니다.

API 오류를 받았을 때의 첫 점검 순서
응답먼저 확인다음 조치
401 · 403키, 프로젝트, 접근 권한인증·권한 설정을 고친 뒤 다시 요청
400 · 404오류 본문, 모델 ID, 파라미터지원 종료와 요청 형식을 확인
429호출량·토큰·결제 상한일시 제한이면 대기, 상한이면 설정 확인
5xx공급사 상태와 실패 범위횟수를 제한해 재시도하거나 대체 경로 사용

재시도에는 최대 횟수와 전체 제한 시간을 두세요. 서버의 대기 시간 안내가 있으면 따르고, 없으면 요청 간격을 점차 늘립니다. SDK가 이미 재시도하는지 먼저 확인하면 재시도가 겹쳐 비용과 대기 시간이 불어나는 일을 줄일 수 있습니다.

지원 요청에는 발생 시각, 모델 ID, 오류 코드, 요청 ID를 남깁니다. API 키와 사용자가 보낸 원문은 공유 로그에서 제외하세요.

공식 오류 정의: Claude API errors · 재시도 근거: Gemini API troubleshooting. 공급사마다 세부 의미가 달라 해당 오류 본문이 우선입니다.

03 / 연결

로컬 AI와 MCP

내 컴퓨터에서 돌리면 데이터가 밖으로 안 나갈까?

모델이 실행되는 위치와 연결된 도구가 데이터를 보내는 위치를 따로 확인해야 합니다. MCP는 AI 앱이 도구와 데이터를 연결하는 규약이며, MCP 서버는 내 컴퓨터에서도 원격 서버에서도 실행할 수 있습니다.

  1. 1.모델 실행 위치 확인. 선택한 모델이 로컬인지 클라우드인지 확인합니다. Ollama의 로컬 전용 설정을 쓴다면 클라우드 기능을 끈 뒤 재시작하고 로그에서 적용 여부를 봅니다.
  2. 2.메모리와 속도 확인. 모델을 불러온 뒤 ollama ps로 CPU·GPU 사용 위치를 봅니다. 실제로 넣을 문서 길이에서 응답 시간과 메모리 사용량을 확인합니다.
  3. 3.MCP 연결별 권한 확인. 접근할 폴더, 외부 서비스, 읽기·쓰기 기능을 적어봅니다. 처음에는 테스트용 폴더와 계정으로 필요한 도구만 연결합니다.
  4. 4.실제 전송 경로 확인. 로컬 모델을 선택해도 검색·원격 MCP 연결은 외부 통신을 할 수 있습니다. 연결 목록과 서버 설정을 보고 민감한 문서를 넣을 수 있는지 판단합니다.

설정 근거: Ollama 공식 FAQ · 연결 구조: MCP architecture. 위 순서는 설정 점검 안내이며 특정 기기의 성능 측정 결과는 아닙니다.

04 / 이전

모델 교체와 지원 종료

모델 이름만 바꾸면 이전이 끝날까?

호출 성공만으로 이전이 끝났다고 판단하기는 어렵습니다. 응답 JSON의 모양, 스트리밍 종료 처리, 도구 호출 인자가 바뀌면 화면과 후속 작업이 실패할 수 있습니다.

변경 전에 기록할 것
현재 모델 ID · 교체할 모델 ID · SDK 버전 · 지원 종료일과 시간대 · 대체 모델 · 담당자 · 되돌릴 설정
같은 입력으로 비교할 것
평소 쓰는 요청, 긴 입력, JSON 응답, 도구 호출, 오류 응답을 각각 실행합니다. 통과 조건을 먼저 적고 결과·지연·비용을 나란히 기록하세요.
전환 후 확인할 것
일부 트래픽부터 바꾸고 실패율과 응답 시간을 확인합니다. 이미 종료된 모델로는 되돌릴 수 없으므로 복구용 모델의 가용성도 확인해야 합니다.

‘지원 종료 예고’와 ‘실제 호출 중단’은 구분해서 읽으세요. 예를 들어 Gemini의 종료 일정표에는 가장 이른 종료 가능일이 표시될 수 있습니다. 날짜만 복사하지 말고 원문의 조건을 함께 남겨야 합니다.

일정 표기 근거: Gemini API 지원 종료 문서. 이전 절차는 편집 제안이며, 개별 서비스의 테스트 결과에 맞춰 통과 기준을 정하세요.

이 페이지는 공식 문서의 설명과 코딩하는 상인의 점검 제안을 구분해 정리했습니다. 연결된 글은 글마다 수정일이 다릅니다. 수치와 출처를 읽는 기준은 비교 방법과 검증 기준에서 확인할 수 있습니다.