مستندات API برای توسعه‌دهندگان

تنظیم احراز هویت URL پایه

از HTTPS://api.mistralkey.com/v1 به عنوان URL پایه خود استفاده کنید. کلید API خود را در Authorization هدر. کلید خود را از طریق گوگل یا ایمیل در داشبورد ایجاد کنید. نیاز به شماره تلفن نیست. اعتبار هرگز منقضی نمی‌شود.

Copycurl https://api.mistralkey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the main configuration options for the server"}]
  }'

اولین درخواست

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

Copyfrom openai import OpenAI

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

کلاینت را با URL پایه و کلید خود مقداردهی اولیه کنید. مدل را برای استفاده از نسخه بدون سانسور پیکربندی کنید. SDK سریال‌سازی را به صورت خودکار انجام می‌دهد. این رویکرد حدس‌وگمان را از لایه یکپارچه‌سازی شما حذف می‌کند.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralkey.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 پارامتر را true تنظیم کنید. توکن‌ها را از طریق رویدادهای ارسال‌شده توسط سرور دریافت کنید. جزئیات مصرف توکن در قطعه نهایی ظاهر می‌شود. این موضوع تأخیر ادراک‌شده را برای خروجی‌های طولانی کاهش می‌دهد.

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)

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

محدودیت ۳۰۰ درخواست در دقیقه به ازای هر کلید است. درخواست‌های همزمان به ۸ محدود می‌شوند. اندازه بدنه درخواست نمی‌تواند از ۸ مگابایت تجاوز کند. پنجره زمینه ۱۰۰,۰۰۰ توکن است. حداکثر خروجی به ازای هر درخواست ۱۶,۰۰۰ توکن است.

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

خطای ۴۰۱ را برای کلیدهای نامعتبر مدیریت کنید. خطای ۴۰۲ را زمانی برگردانید که اعتبار تمام شده است. خطای ۴۲۹ را برای تجاوز از محدودیت نرخ مدیریت کنید. خطاها رایگان هستند. مصرف اعتبار فقط شامل مصرف واقعی توکن‌ها می‌شود.