3줄로 클라이언트 전환
이 빠른 시작 가이드는 표준 Mistral 엔드포인트 형식을 사용하여 무검열 OpenAI 호환 API와 통합하는 방법을 보여줍니다. 인증, 요청 보내기, 스트리밍 응답 처리 방법을 학습합니다.
베이스 URL 및 인증
API를 사용하려면 클라이언트를 https://api.mistralapi.top/v1로 설정하세요. 인증은 Authorization 헤더에 포함된 Bearer 토큰에 의존합니다. 이 키는 Google 계정 또는 일반 이메일/비밀번호 설정을 사용하여 API 키 받기 페이지에서 생성합니다. 키는 생성 즉시 표시됩니다. 이 토큰은 선불 크레디에 대한 전체 접근 권한을 부여하므로 안전하게 보관하세요. 일반 제공업체와 달리 초기 체험 크레딧 활성화에 전화번호나 신용카드가 필요하지 않습니다.
당사의 서비스는 기존 Mistral 또는 OpenAI 클라이언트 구성에 바로 삽입되도록 설계되었습니다. SDK 인스턴스의 base_url 속성만 업데이트하면 됩니다. 엔드포인트 구조는 표준 /v1/chat/completions 형식과 일치하여 기존 코드의 수정 없이 작동합니다. 모든 텍스트 생성 작업을 처리하는 단일 모델 ID uncensored를 지원합니다.
채팅 완료 엔드포인트
핵심 상호작용은 POST /v1/chat/completions 엔드포인트를 통해 이루어집니다. model ID, messages 배열 및 선택적 매개변수를 포함하는 JSON 본문을 전송합니다. API는 JSON 모드를 지정할 경우 텍스트 응답 또는 구조화된 데이터를 반환합니다. 이 엔드포인트는 LLM과 상호작용하는 주요 방법입니다. 표준 동기식 요청과 스트리밍 응답을 모두 지원합니다. 모든 요청은 입력 및 출력량에 따라 선불 잔액에서 토큰을 소모합니다.
오류는 표준 HTTP 상태 코드를 통해 처리됩니다. 키가 유효하지 않으면 401이 반환되고, 크레딧이 부족하면 402가 반환됩니다. 속도 제한은 분당 300개 요청 및 키당 8개 동시 연결로 적용됩니다. 연결 및 키 유효성을 확인하려면 다음 예시를 사용하세요.
curl https://api.mistralapi.top/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."}]
}'
스트리밍 응답(SSE)
낮은 지연 시간과 향상된 사용자 경험을 위해 요청 본문에 stream: true를 설정하여 스트리밍을 활성화하세요. API는 SSE(Server-Sent Events) 스트림을 반환합니다. 각 청크에는 부분 응답이 포함됩니다. 마지막 청크에는 요청에 대한 전체 토큰 사용량 통계가 포함됩니다. 이를 통해 응용 프로그램은 전체 생성이 완료되기를 기다리지 않고 토큰이 생성되는 대로 표시할 수 있습니다. 스트리밍은 즉각적인 피드백이 중요한 채팅 인터페이스에 이상적입니다.
스트리밍을 사용할 때 클라이언트가 SSE 형식을 올바르게 구문 분석하는지 확인하세요. 각 청크의 choices 배열에는 델타 콘텐츠가 포함됩니다. 전체 응답을 구성하려면 이러한 델타를 누적해야 합니다. 토큰 사용량은 스트림의 마지막 이벤트에서만 사용할 수 있습니다. 이 방법을 사용하여 모델이 복잡한 프롬프트를 처리하는 동안 사용자를 참여시켜 유지하세요.
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)Python
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralapi.top/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.top/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);질문과 답변
공식 Mistral API인가요?
아니요. Mistral API 엔드포인트 구조를 모방한 독립 서비스입니다. Mistral의 독점 모델이 아닌 자체 무검열 모델을 제공합니다. 동일한 클라이언트 호환성과 다른 콘텐츠 정책, 가격 정책을 원하시면 이 API를 사용하세요.
크레딧을 충전하는 방법은?
충전은 암호화폐로만 진행됩니다(TRC20 기반 USDT 또는 Base 기반 USDC). 최소 충전 금액은 $10, 최대는 $500입니다. $50 이상 충전 시 5%, $100 이상 충전 시 10% 보너스를 제공합니다. 신용카드나 PayPal는 사용이 불가능합니다.
컨텍스트 창 제한은 무엇인가요?
이 모델은 프롬프트와 생성을 합산하여 100,000개의 토큰 컨텍스트 창을 지원합니다. 요청당 최대 출력은 32,000개의 토큰이며, <code>max_tokens</code> 매개변수를 지정하지 않을 경우 2,048개의 토큰입니다.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 베이스 URL을 변경하세요. 설정은 이것뿐입니다.
기술 사양
크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.
| 항목 | 내용 |
|---|---|
| 형식 | OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작 |
| 모델 ID | uncensored |
| Base URL | https://api.mistralapi.top/v1 |
| 엔드포인트 | POST /v1/chat/completions · GET /v1/models |
| 인증 | Authorization: Bearer YOUR_KEY |
| 함수 호출 | 지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송 |
| 파라미터 | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| 스트리밍 | 지원 — SSE, 마지막 청크에 토큰 사용량 포함 |
| 컨텍스트 창 | 100,000 토큰 (입력 + 출력) |
| JSON 모드 | response_format: {"type": "json_object"} |
| 최대 출력 | 100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음) |
| 요청 크기 | 최대 8 MB |
| 동시 요청 | 키당 동시 8개 |
| 응답 헤더 | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 속도 제한 | 키당 분당 300회 |
| 가격 | 입력 100만 토큰당 $0.25 · 출력 100만 토큰당 $1.00 |
| 유효기간 | 유료 크레딧은 만료되지 않으며 구독 없음 |
| 보너스 | $50 이상 +5%, $100 이상 +10% |
| 과금 | 선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료 |
| 무료 체험 | $0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용 |
| 충전 | USDT (TRC20) 또는 USDC (Base), $10~$500 사이 원하는 정수 금액 |
| 로그인 | Google 또는 이메일과 비밀번호 |
| 콘텐츠 | 성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부 |
| 키 | 계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효 |
오류 코드
오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.
| 코드 | 유형 | 의미 |
|---|---|---|
400 | bad_request | 잘못된 JSON, 빈 메시지, 잘못된 파라미터 또는 컨텍스트 초과 |
401 | missing_key · invalid_key · key_revoked | 키 없음·잘못됨·새 키로 교체됨 |
402 | no_credit | 잔액 없음 — 충전하면 즉시 재개 |
403 | content_blocked | 미성년자 관련 성적 콘텐츠 — 거부, 과금 없음 |
404 | not_found | 알 수 없는 엔드포인트 |
413 | request_too_large | 본문 8 MB 초과 |
429 | rate_limited · concurrency | 분당 300회 또는 동시 8개 초과 — 잠시 후 재시도 |
503 | upstream_busy | 모델 혼잡 — 몇 초 후 재시도 |