Mistral 사용자를 위한 빠른 시작

기본 URL 및 인증

우리의 API는 OpenAI SDK와 완전히 호환됩니다. 기본 URL을 업데이트하고 API 키를 제공하기만 하면 됩니다. 이 서비스의 기본 URL은 https://api.mistralapi.com/v1입니다. 인증은 Bearer 토큰을 사용하여 Authorization 헤더를 통해 처리됩니다. 일부 제공업체와 달리 복잡한 라우팅이나 벤더별 헤더가 필요하지 않습니다. 일반적으로 사용하는 방식으로 키를 전달하면 됩니다.

• 기본 URL: https://api.mistralapi.com/v1
• 헤더: Authorization: Bearer YOUR_API_KEY

API 키는 가입 즉시 생성됩니다. 선불 크레딧에 대한 접근 권한을 부여하므로 안전하게 보관하세요. 월 구독료는 없으며 토큰 사용량을 기반으로 한 종량제 가격만 있습니다.

채팅 완성 엔드포인트

API의 핵심은 POST /v1/chat/completions 엔드포인트입니다. 메시지 목록을 받아 생성된 응답을 반환합니다. 이 엔드포인트는 대부분의 LLM 클라이언트에서 사용하는 표준 메시지 형식을 지원합니다. 모델 ID를 "uncensored"로 지정해야 합니다. 이 모델은 합법적인 성인 사용에 대한 콘텐츠 거부 없이 답변하도록 조정된 오픈 웨이트 대형 언어 모델로 우리 서버에서 호스팅됩니다.

• 엔드포인트: POST /v1/chat/completions
• 모델 ID: uncensored

API는 텍스트 응답만 반환합니다. 이미지, 오디오, 비디오, 임베딩을 지원하지 않습니다. 대부분의 개발자에게 이 엔드포인트는 기본 URL과 모델 ID 외에 코드 변경 없이 표준 OpenAI 채팅 엔드포인트를 대체합니다.

Python SDK 통합

공식 OpenAI Python 라이브러리를 사용하는 것이 통합하는 가장 빠른 방법입니다. base URL을 엔드포인트로 설정하고 API 키를 입력하세요. 아래 코드는 간단한 텍스트 완성 요청을 보여줍니다.

• 라이브러리 설치: pip install openai
• base_url을 https://api.mistralapi.com/v1로 설정
• model="uncensored" 사용

이 접근 방식이 작동하는 이유는 우리 API가 OpenAI 응답 구조를 복사하기 때문입니다. 수정 없이 스트리밍, 함수 호출, JSON 모드에 기존 라이브러리를 사용할 수 있습니다.

Node SDK 통합

JavaScript/TypeScript 개발자의 경우 openai npm 패키지가 원활하게 작동합니다. 클라이언트를 기본 URL과 API 키로 구성하세요. 이렇게 하면 OpenAI와 무검열 모델 모두에 동일한 코드베이스를 사용할 수 있습니다.

• 라이브러리 설치: npm install openai
• baseUrl을 https://api.mistralapi.com/v1로 구성
• model: "uncensored" 지정

이 호환성은 temperature, top_p, stop 시퀀스와 같은 모든 표준 매개변수에 확장됩니다. 클라이언트 구성을 변경하여 제공업체 간에 쉽게 전환할 수 있습니다.

스트리밍 응답

우리는 서버 전송 이벤트(SSE)를 통해 스트리밍 응답을 지원합니다. 이를 통해 생성되는 대로 토큰을 수신하여 사용자의 지각된 지연 시간을 줄일 수 있습니다. 스트림의 마지막 청크에는 청구를 위한 토큰 사용 통계가 포함됩니다.

• 요청에 stream: true 설정
• 응답에서 청크 읽기
• 사용량 데이터를 위해 마지막 청크 구문 분석

스트리밍은 채팅 인터페이스와 실시간 애플리케이션에 이상적입니다. 응답 형식은 OpenAI 스트리밍 표준과 일치하므로 기존 스트리밍 로직은 변경 없이 작동합니다.

제한, 오류 및 컨텍스트 창

안정성을 위해 API에는 특정 제한이 있습니다. 각 API 키는 분당 300개의 요청과 8개의 동시 요청을 지원합니다. 최대 요청 본문 크기는 8 MB입니다. 컨텍스트 창은 총 100,000 토큰(프롬프트 + 완성)입니다. max_tokens을 설정하지 않으면 기본 출력은 2,048 토큰이며, 그렇지 않으면 최대 출력은 32,000 토큰입니다.

• 401: 유효하지 않은 API 키
• 402: 부족 크레딧
• 429: 속도 제한 초과

프리미엄 크레딧은 만료되지 않습니다. 오류와 거부는 무료입니다. 문제가 발생하면 환불이나 계정 도움을 위해 지원 페이지를 사용하세요.

cURL

복사curl https://api.mistralapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

복사from openai import OpenAI

client = OpenAI(base_url="https://api.mistralapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

복사import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

스트리밍

복사stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)