애플리케이션에서 Mistral 호출

첫 요청 전 준비

Mistral Studio에서 제공자 API 키를 생성하세요. 서버에 보관하고 공개 저장소나 브라우저 번들에 절대 넣지 마세요. 계정의 모델 접근 권한과 현재 요금을 확인하세요. 이 웹사이트의 계정 자격 증명은 제공자와 별개입니다.

cURL 빠른 시작

코드

curl https://api.mistral.ai/v1/chat/completions \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-large-4",
    "messages": [{"role": "user", "content": "Explain idempotent retries."}],
    "max_tokens": 1024
  }'

Python 예제

공식 mistralai SDK를 패키지 레지스트리에서 설치하고 키에 환경 변수를 사용하세요.

코드

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
reply = client.chat.complete(
    model="mistral-large-4",
    messages=[{"role": "user", "content": "Explain idempotent retries."}],
    max_tokens=1024,
)
print(reply.choices[0].message.content)

TypeScript 예제

서버에서 공식 @mistralai/mistralai SDK를 사용하세요. 결과를 렌더링하기 전에 누락된 선택지와 제공자 오류를 처리하세요.

코드

import { Mistral } from "@mistralai/mistralai";

const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });
const reply = await client.chat.complete({
  model: "mistral-large-4",
  messages: [{ role: "user", content: "Explain idempotent retries." }],
  maxTokens: 1024,
});
console.log(reply.choices?.[0]?.message.content);

스트리밍 응답

HTTP API의 경우 스트리밍을 요청하고 서버 전송 이벤트를 점진적으로 파싱하세요. 각 네트워크 청크에 완전한 이벤트가 하나씩 포함된다고 가정하지 마세요. 부분 텍스트를 보존하고, 취소를 지원하며, 완료된 응답과 끊긴 연결을 구분하세요. 부작용을 중복하지 않고 안전하게 재시도할 수 있는 경우에만 재시도하세요.

이미지 및 문서

멀티모달 콘텐츠 블록에 대한 최신 API 참조를 따르세요. 승인된 이미지를 사용하고 공개 URL을 검증하세요. 문서 질문의 경우 출처 구절을 포함하고 명시적인 인용을 요청하세요. 제공자의 요청 한도가 모델의 문서화된 컨텍스트보다 낮은 경우 큰 입력을 분할하세요.

구조화된 출력 및 도구

검증되지 않은 JSON을 요청하는 대신 지원되는 구조화된 출력 스키마를 사용하세요. 도구 호출을 실행하기 전에 인수를 검증하고, 서버에서 권한 부여를 적용하며, 도구 루프를 제한하세요. 모델이 생성한 함수 호출은 제안된 입력이지 작업 수행 권한이 아닙니다.

프로덕션 체크리스트

출력 한도, 타임아웃 및 동시성 한도를 설정하세요. 비밀 정보나 불필요한 사용자 콘텐츠를 로깅하지 않고 모델 식별자, 사용량 및 오류를 추적하세요. 속도 제한, 부분 스트림, 취소 및 잘못된 도구 인수를 테스트하세요. 제공자 폴백과 소규모 회귀 평가 세트를 유지하세요.

이 워크스페이스에서의 사용 가능 여부

위 통합은 공식 제공자를 직접 대상으로 합니다. 브라우저 채팅 및 크레딧 관리에는 워크스페이스 계정을 사용하세요. 직접 API 예제는 자체 제공자 계정이 필요하며 이 문서에서 실행되지 않습니다.