API 키 만들고 첫 API 요청 보내기

API 키 만들고 첫 API 요청 보내기

API 키를 만들고 SDK를 설치한 다음, Mistral 모델에 처음으로 채팅 완료(chat completion) 요청을 보내는 과정을 차근차근 따라가 볼게요. 이 단계가 끝나면 이후의 에이전트(agent)나 RAG 퀵스타트로 넘어갈 기초가 잡혀요.

출처: 문서

본문

Mistral AI 계정만 있으면 누구나 몇 분 안에 첫 요청을 보낼 수 있어요. 여기서 하는 일은 크게 세 가지예요: Python 또는 TypeScript SDK 설치, Mistral 모델에 요청 보내기, 모델의 응답 출력하기입니다.

소요 시간: 약 5분

사전 준비

• 머신에 Python 3.9+ 또는 Node.js 18+ 가 설치되어 있어야 해요.
• Mistral AI 계정이 필요해요. 계정 만들기에서 만들 수 있어요.
• Mistral API 키가 필요해요. Studio는 Free 모드가 기본 활성화되어 있고 카드 등록 없이 쓸 수 있어요. 아직 키가 없다면 "Studio 활성화하고 API 키 생성하기" 퀵스타트를 먼저 따라 해보세요.

Step 1: API 키 받기

1. Studio의 API keys 페이지로 이동해요.
2. Create new key를 클릭해요.
3. 키에 이름을 붙이고(예: quickstart) Create를 클릭해요.
4. 키를 클립보드에 복사해두어요. 키는 한 번만 보여주고, 잃어버리면 새로 만들어야 해요.
5. 터미널에서 키를 환경 변수로 설정해요:

export MISTRAL_API_KEY="your_api_key_here"

Step 2: SDK 설치

pip install mistralai

Step 3: 첫 요청 보내기

파일을 만들고 아래 코드를 넣어볼게요:

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

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {"role": "user", "content": "What is Mistral AI?"}
    ],
)

print(response.choices[0].message.content)

코드가 모델에게 "What is Mistral AI?"라고 묻고, 응답을 터미널에 출력하는 흐름이에요.

Step 4: 실행하기

python quickstart.py

확인 (Verify)

터미널에 Mistral AI에 대한 짧은 설명이 출력되면 성공이에요. 안 되면 아래 오류 표를 확인해보세요.

더 알아보기 (Learn more)

• 도구(tool)를 가진 에이전트 만들기
• 문서 검색 기반 RAG 시작하기
• Studio에서 모델 테스트하기
• Mistral API 키 관리