이 글에서 가장 먼저 확인할 것은 무엇인가요?

Mistral Studio Free mode는 개발용 API 경로예요. 이 가이드에서는 Small 4에 공지문 요약을 요청하고 터미널에서 답변을 확인해요.

모델별 실행 레시피

최종 업데이트 2026-10-30

Mistral Studio 무료 API 시작: Small 4 요청 보내기

Mistral Studio Free mode에서 `mistral-small-2603`에 텍스트 요청을 보내요.

Mistral Studio Free mode는 개발용 API¹ 경로예요. 이 가이드에서는 Small 4에 공지문 요약을 요청하고 터미널에서 답변을 확인해요.

실행 조건과 핵심 내용

Free mode는 기본 활성 상태이며, 카드 없이 API 접근과 키 생성을 시작할 수 있어요.
무료 입력과 응답은 학습에 사용될 수 있어요. Studio/API용 opt-out은 Admin의 Privacy 메뉴에서 설정해요.

Free mode는 제한이 있는 개발용 API 경로예요

Mistral Studio API는 메시지와 모델 ID를 HTTPS 요청으로 보내면 호스팅 모델의 응답을 돌려주는 서비스예요. Studio의 Free mode는 새 계정에서 기본 활성화되며, API 키 발급과 호출을 카드 없이 시작할 수 있어요. 이 경로는 평가와 프로토타이핑 용도이고 사용량 제한이 적용돼요.

API 한도는 초당 요청 수, 분당 토큰², 월간 토큰으로 나뉘어요. 모델과 조직에 따라 값이 달라지므로 Mistral Admin의 Limits 화면에서 현재 한도를 확인해요.

소형 컴퓨터가 브라우저와 파일함, 달력, 대화 화면에 연결되어 있다 — 공개 공지문을 모델에 보내고, 완성된 요약문을 터미널에서 읽어요.

Small 4의 API 모델 ID를 확인해요

Mistral Small 4는 지시 수행, 추론, 코딩을 하나의 모델로 처리해요. Apache 2.0 라이선스로 가중치가 공개돼 있고, API 모델 ID는 mistral-small-2603이에요. Playground와 Admin에서 이 ID가 Free mode로 이용 가능한지 보고, Admin의 Limits에서 현재 한도를 확인해요. 이번에는 공개 공지문 요약을 요청해요.

키를 만들기 전에 입력 데이터 설정을 살펴봐요

Free mode에서는 API 입력과 응답이 Mistral 모델 학습에 사용될 수 있어요. 이를 끄려면 Mistral Admin의 Privacy 메뉴에서 Anonymous improvement data 토글을 비활성화해요. 민감한 정보 대신 공개 가능한 짧은 텍스트로 예제를 시험해요.

macOS/Linux 셸에서 python3 --version으로 Python 3.10 이상인지 확인해요. Studio의 API Keys 메뉴에서 API 키를 발급받아 안전한 위치에 보관하고, 가상환경³을 만든 뒤 공식 SDK mistralai를 설치해요.

가상환경과 Mistral SDK 설치

python3 --version
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip mistralai

같은 가상환경 안에서 다음 Python 파일을 실행해요.

작업자가 모니터의 진행 표시와 정리된 문서 묶음을 확인하고 있다 — 정상 응답을 확인하면 SDK 설치와 모델 선택이 함께 작동하는지 알 수 있어요.

Small 4에 짧은 문서 요약을 요청해요

다음 코드를 quickstart.py로 저장해요. getpass는 키를 화면에 표시하지 않고 받아요. 모델에 공개 공지문을 두 항목으로 요약해 달라고 요청하고, 완성된 요약문과 finish_reason을 터미널에 출력해요.

Small 4에 요약 요청 보내기

# quickstart.py
from getpass import getpass
from mistralai.client import Mistral

client = Mistral(api_key=getpass("Mistral API key: "))
response = client.chat.complete(
    model="mistral-small-2603",
    messages=[
        {
            "role": "user",
            "content": (
                "Summarize this notice in two bullet points: "
                "The library closes at 5 p.m. on Friday and reopens Monday at 9 a.m."
            ),
        }
    ],
    max_tokens=512,
)

choice = response.choices[0]
print(choice.message.content or "(No response text returned)")
print(f"finish_reason={choice.finish_reason}")

`python quickstart.py`를 실행하면 요약문과 응답 종료 상태가 터미널에 표시돼요.

요청 파일 실행

python quickstart.py

요약 결과와 `finish_reason`이 터미널에 표시돼요.

정상 응답과 첫 오류를 확인해요

정상 실행이면 두 항목의 요약이 choice.message.content에 출력되고, finish_reason은 응답 종료 상태를 보여줘요. 401이면 Studio API 키를 다시 확인해요. 402이면 먼저 계정이 Free mode인지, 선택한 모델이 현재 무료 개발 접근에 포함되는지 Playground와 Admin에서 살펴봐요. 무료 경로를 유지하려면 결제 정보를 등록하기 전에 모델 선택과 플랜 상태를 확인하면 돼요.

429는 요청 빈도나 토큰 한도에 도달했을 때 나타나요. Admin의 Limits 화면에서 초당 요청, 분당 토큰, 월 토큰 항목을 확인하고, 요청 간격을 늘리거나 입력을 짧게 줄여 다시 시험하세요. Free mode는 작은 평가를 위한 시작점이라 현재 표시된 제한 안에서 SDK 연결과 결과 형식을 확인하는 데 알맞아요.

Mistral API 오류 코드와 첫 요청 안내

투명한 상자 안의 로봇 옆에 공유기와 보관함, 문서가 놓여 있다 — API 키를 관리할 때는 접근 범위와 입력 데이터 설정도 같이 확인하세요.

용어 각주

API — 프로그램의 기능을 다른 코드에서 호출하기 위한 약속된 인터페이스입니다.
본문으로 돌아가기
토큰 — 모델이 입력이나 출력을 나누어 처리하는 단위입니다.
본문으로 돌아가기
Python 가상환경 — 프로젝트별로 Python 패키지를 분리해 설치하는 공간입니다. 패키지 버전 충돌을 줄이는 데 쓰입니다.
본문으로 돌아가기

자주 묻는 질문

이 글에서 가장 먼저 확인할 것은 무엇인가요?: Mistral Studio Free mode는 개발용 API 경로예요. 이 가이드에서는 Small 4에 공지문 요약을 요청하고 터미널에서 답변을 확인해요.
조건과 출처는 어디서 확인하나요?: Mistral Small 4는 지시 수행, 추론, 코딩을 하나의 모델로 처리해요. Apache 2.0 라이선스로 가중치가 공개돼 있고, API 모델 ID는 `mistral-small-2603`이에요. Playground와 Admin에서 이 ID가 Free mode로 이용 가능한지 보고, Admin의 `Limits`에서 현재 한도를 확인해요. 이번에는 공개 공지문 요약을 요청해요.