راهنمای شروع سریع

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

API در https://api.mistralapipricing.com/v1. کلید خود را در Authorization header. منطق قیمت‌گذاری API Mistral بر اساس توکن اعمال می‌شود، بنابراین هدرها را تمیز نگه دارید. اتصال را با GET /v1/models.

• هدر: Authorization: Bearer YOUR_KEY
• URL پایه: https://api.mistralapipricing.com/v1

Copycurl https://api.mistralapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the cost per token for each model."}]
  }'

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

فراخوانی chat/completions اندپوینت با شناسه مدل شما. مدل بدون سانسور به پرامپت‌های استاندارد بدون رد پاسخ می‌دهد. توکن‌های ورودی ۰.۱۵ دلار در هر میلیون، توکن‌های خروجی ۰.۵۰ دلار در هر میلیون. خطاها اعتبار مصرف نمی‌کنند.

Copyfrom openai import OpenAI

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

از SDK رسمی یا axios برای ارسال درخواست‌ها. URL پایه را به درستی تنظیم کنید. شناسه مدل همیشه uncensored. هدرها باید شامل توکن بیئر شما باشند. پاسخ‌ها اشیاء JSON را برمی‌گردانند. خطاها را به صورت ایمن مدیریت کنید.

Copyimport OpenAI from "openai";

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

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

ابزارها را در بدنه درخواست تعریف کنید. مدل JSON ساختاریافته برمی‌گرداند. استفاده response_format: {"type": "json_object"} برای خروجی دقیق. نتیجه را در منطق برنامه خود تجزیه کنید. این برای وظایف خودکارسازی کار می‌کند. طرحواره را در سمت خود اعتبارسنجی کنید.

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

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