API میسترال AI - راهنمای شروع سریع

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

اولین مرحله پیکربندی مشتری شما برای اشاره به زیرساخت ماست. URL پایه استاندارد OpenAI را با HTTPS://api.apimistralai.com/v1 جایگزین کنید و کلید API منحصر به فرد خود را در سربرگ اعتبار وارد کنید. این جابجایی ساده تمام درخواست‌ها را به مدل uncensored ما هدایت میکند در حالی که منطق یکپارچه‌سازی موجود شما را دست‌نخورده نگه میدارد.

• URL پایه: HTTPS://api.apimistralai.com/v1
• احراز هویت: توکن Bearer از طریق 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"}]
  }'

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

یکپارچه‌سازی SDK Python

از کتابخانه رسمی پایتون OpenAI برای تعامل با API ما بدون تغییر ساختار درخواست هسته استفاده کنید. کلاینت را با URL پایه جدید و کلید API خود مقداردهی اولیه کنید، سپس فراخوانی کنید chat.completions.create.

این رویکرد به شما امکان می‌دهد تمام منطق موجود پایتون را حفظ کنید در حالی که به قابلیت‌های مدل بدون سانسور دسترسی پیدا می‌کنید.

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

برای محیط‌های JavaScript یا TypeScript، بسته OpenAI را با base URL سفارشی مقداردهی اولیه کنید. متغیر apiKey و baseURL properties پیش از فراخوانی chat.completions.create.

این امر تضمین می‌کند که برنامه‌های Node.js شما درخواست‌ها را به اندپوینت uncensored ما هدایت کنند و همزمان با الگوهای استاندارد 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 را به‌خوبی مدیریت کنید. شما مجاز به ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان به ازای هر کلید هستید.

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

پنجره زمینه شما ۱۰۰,۰۰۰ توکن در مجموع پشتیبانی می‌کند، با حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست. خطاها و رد شدن‌ها اعتبار مصرف نمی‌کنند، تضمین می‌کنند که شما فقط برای محتوای تولید شده واقعی هزینه می‌پردازید.