مستندات API

احراز هویت و URL پایه

از کلید API خود با آدرس پایه HTTPS://api.mistralllmapi.com/v1 استفاده کنید. آن را بلافاصله از طریق Google یا ایمیل در صفحه دریافت API key ایجاد کنید. کلید را به عنوان یک توکن Bearer در هدر Authorization ارسال کنید. این با هر کلاینت SDK استاندارد OpenAI کار می‌کند.

• ثبت‌نام بدون شماره تلفن.
• برای هر حساب، یک کلید فعال نگه دارید.
• کلیدهای قدیمی را هنگام چرخش آن‌ها جایگزین کنید.

Copycurl https://api.mistralllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check if port 8080 is open on 10.0.0.5"}]
  }'

نقطه پایانی تکمیل چت

درخواست‌های POST را به /v1/chat/completions ارسال کنید. شناسه مدل را به عنوان "uncensored" عبور دهید. پیام‌ها را در یک آرایه با فیلدهای role و content ارائه دهید. مدل متن را بدون فیلترهای محتوایی استاندارد برای استفاده بزرگسالان قانونی برمی‌گرداند. پنجره زمینه مجموعاً ۱۰۰,۰۰۰ توکن شامل ورودی و خروجی است.

Copyfrom openai import OpenAI

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

نقطه پایانی مدل‌ها

با ارسال درخواست GET به /v1/models، لیست مدل‌ها را دریافت کنید. بررسی کنید که شناسه مدل با "uncensored" مطابقت دارد. این endpoint تأیید می‌کند که اتصال شما کار می‌کند. از آن برای اشکال‌زدایی احراز هویت پیش از ارسال پیکربندی‌های سنگین استفاده کنید. API تنها این مدل تک uncensored را ارائه می‌دهد.

پاسخ‌های استریم

با تنظیم stream به true، پخش زنده (streaming) را فعال کنید. رویدادهای ارسالی سرور (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)

فراخوانی تابع و حالت JSON

ابزارها را در بدنه درخواست برای فراخوانی تابع تعریف کنید. tool_choice را تنظیم کنید تا توابع خاصی را اعمال کنید. از response_format با json_object برای خروجی JSON دقیق استفاده کنید. پارامترهایی مانند temperature و top_p میزان تصادفی بودن را تنظیم می‌کنند. این ویژگی‌ها از استخراج داده‌های ساختاریافته پشتیبانی می‌کنند.

Copyimport OpenAI from "openai";

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

محدودیت‌های نرخ و خطاها

انتظار ۳۰۰ درخواست در دقیقه به ازای هر کلید را داشته باشید. تعداد درخواست‌های همزمان را به ۸ محدود کنید. درخواست‌هایی که بیش از ۸ مگابایت حجم بدنه دارند. کلیدهای نامعتبر را با 401 برگردانید. اگر اعتبار کافی نباشد، 402 برگردانید. در صورت محدودیت نرخ، 429 برگردانید. خطاها توکن مصرف نمی‌کنند. اعتبار منقضی نمی‌شود.