API mistral ai: 시작하기 가이드

Base URL 및 인증

첫 단계는 클라이언트를 저희 인프라를 가리키도록 구성하는 것입니다. 표준 OpenAI 베이스 URL을 HTTPS://api.apimistralai.com/v1로 바꾸고 고유한 API 키를 authorization 헤더에 삽입하세요. 이 간단한 교체는 기존 통합 로직을 유지한 채 모든 요청을 저희 uncensored 모델로 리디렉션합니다.

• Base URL: HTTPS://api.apimistralai.com/v1
• 인증: Authorization 헤더

연결 테스트 전에 계정 대시보드에서 키가 활성화되어 있는지 확인하세요.

첫 번째 요청

연결성 및 모델 응답을 확인하기 위해 표준 채팅 완료 요청을 보내세요. 다음 curl 명령은 uncensored 모델을 기본 프롬프트와 함께 사용합니다.

이 테스트는 엔드포인트가 접근 가능하며 표준 콘텐츠 필터 없이 텍스트를 반환하는지 확인합니다.

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

응답에 텍스트가 포함되어 있으면 통합이 성공적으로 비제약 추론 레이어를 통해 라우팅됩니다.

Python SDK 통합

핵심 요청 구조를 수정하지 않고 우리 API와 상호작용하려면 공식 OpenAI Python 라이브러리를 사용하세요. 새 기본 URL과 API 키로 클라이언트를 초기화한 다음 호출 chat.completions.create.

이 접근 방식을 사용하면 기존 Python 로직을 모두 유지하면서 uncensored 모델 기능에 접근할 수 있습니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apimistralai.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)

응답 객체는 표준 OpenAI 응답과 동일하게 동작하여 Python 개발자에게 원활한 마이그레이션을 제공합니다.

Node SDK 통합

For JavaScript or TypeScript environments, initialize the OpenAI package with the custom base URL. Set the apiKey 및 baseURL 호출 전 속성 chat.completions.create.

Node.js 애플리케이션이 표준 SDK 패턴의 호환성을 유지하면서 요청을 비검열 엔드포인트로 라우팅하도록 보장합니다.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apimistralai.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);

응답 구조는 OpenAI 표준과 일관되게 유지되어 기존 Node.js 워크플로우에 쉽게 통합할 수 있습니다.

SSE를 통한 스트리밍 응답

실시간 토큰 생성을 활성화하려면 stream: true 요청에 포함됩니다. API는 생성되는 대로 토큰을 처리할 수 있는 서버 전송 이벤트(SSE) 스트림을 반환합니다.

긴 완성 작업 중 사용자에게 즉각적인 피드백을 제공하여 사용자의 지각된 지연 시간을 줄입니다.

Copystream = 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)

SSE 데이터 스트림을 파싱하여 토큰을 순차적으로 표시하세요. 최종 청크에는 요청의 총 토큰 사용량이 포함됩니다.

제한 사항, 오류 및 컨텍스트

엄격한 속도 제한에 맞춰 사용량을 모니터링하고 일반적인 HTTP 오류를 우아하게 처리하세요. 분당 300회 요청 및 키당 8개의 동시 요청이 허용됩니다.

401 오류는 유효하지 않거나 누락된 API 키를 나타내며, 402 오류는 선불 크레딧이 고갈되었음을 의미합니다. 429 상태 코드는 분당 300회 요청 한도를 초과했음을 나타냅니다.

컨텍스트 윈도우는 총 100,000 토큰을 지원하며 요청당 최대 출력은 16,000 토큰입니다. 오류와 거절은 크레딧을 소모하지 않으므로 실제 생성된 콘텐츠에 대해서만 요금이 부과됩니다.