شروع سریع: کلاینت خود را متصل کنید

پیش‌نیازها و نصب SDK

کتابخانه رسمی SDK را برای زبان خود نصب کنید تا احراز هویت و سریال‌سازی درخواست‌ها به‌طور خودکار انجام شود. نیاز به یک کلید API معتبر و پیکربندی URL پایه در محیط کلاینت خود دارید. سرویس ما پارامترهای استاندارد مانند temperature و top_p را می‌پذیرد و نیازی به هدرهای سفارشی ندارد.

اطمینان حاصل کنید که متغیر محیطی شما توکن را به صورت امن نگه می‌دارد قبل از اجرای هر اسکریپتی. نسخه‌های SDK باید به‌روز باشند تا از ویژگی‌های پخش زنده و حالت JSON به درستی پشتیبانی کنند. برای تولید متن‌محور به درایور اضافی نیاز نیست.

پیکربندی URL پایه و کلید

مشتری خود را به URL پایه اختصاصی ما هدایت کنید تا درخواست‌ها را از طریق زیرساخت بدون سانسور ما مسیریابی کنید. از هدر Authorization: Bearer YOUR_KEY برای احراز هویت هر تماس استفاده کنید. این پیکربندی برای تست محلی یا استقرار اسکریپت‌های تولیدی به یک شکل کار می‌کند.

نقطه پایانی پیش‌فرض OpenAI را با میزبان ما جایگزین کنید تا از سردرگمی با سایر ارائه‌دهندگان جلوگیری کنید. کلید خود را مخفی نگه دارید و آن را در مخازن عمومی قرار ندهید. پیکربندی تا زمان چرخش کلید ثابت می‌ماند.

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

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

Copycurl https://api.keyapiminimax.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a JSON object with keys id and name"}]
  }'

پاسخ را برای جزئیات محتوا و استفاده توکن بررسی کنید. اگر خطای 401 دریافت کردید، فرمت کلید خود را بررسی کنید. خطای 402 نشان می‌دهد که نیاز به شارژ اعتبار خود دارید.

مدیریت پاسخ‌های جریان‌سازی

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

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)

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

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

از کتابخانه پایتون برای مدیریت درخواست‌ها با حداقل کد boilerplate استفاده کنید. کلاینت را با URL پایه و کلید خود برای استفاده فوری مقداردهی اولیه کنید. این رویکرد مدیریت خطا و تجزیه پاسخ را ساده می‌کند.

Copyfrom openai import OpenAI

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

محتوای تولید شده را مستقیماً از شیء پاسخ دسترسی پیدا کنید. خطاها را بررسی کنید و محدودیت‌های نرخ را به درستی مدیریت کنید. SDK از هر دو گردش کار همزمان و ناهمزمان پشتیبانی می‌کند.

Node SDK و محدودیت‌ها

با برنامه‌های Node.js با استفاده از SDK رسمی JavaScript ادغام کنید. URL پایه را تنظیم کنید تا درخواست‌ها به endpoint بدون سانسور ما برسند. مصرف خود را برای ماندن در حد نرخ‌های مجاز پایش کنید.

Copyimport OpenAI from "openai";

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

شما می‌توانید ۳۰۰ درخواست در دقیقه با همزمانی ۸ ارسال کنید. حجم هر بدنه درخواست باید کمتر از ۸ مگابایت باشد. پنجره متن (context window) از ۱۰۰,۰۰۰ توکن در مجموع پشتیبانی می‌کند. خطاها و رد شدن درخواست‌ها اعتبار مصرف نمی‌کنند، اما خروجی‌های موفق اعتبار مصرف می‌کنند. کلید خود را امن نگه دارید و در صورت نیاز آن را تغییر دهید.

درک مصرف توکن

صورتحساب بر اساس توکن‌های واقعی استفاده شده در پرامپت و تکمیل است. توکن‌های ورودی $0.15 به ازای هر میلیون، در حالی که توکن‌های خروجی $0.50 به ازای هر میلیون هزینه دارند. اعتبار پیش‌پردافت تمام مصرف‌ها را بدون هزینه‌های ماهانه پوشش می‌دهد.

خطاها و رد شدن درخواست‌ها رایگان هستند، بنابراین شما فقط برای پاسخ‌های موفق پرداخت می‌کنید. آخرین قطعه در یک جریان (stream)، تعداد توکن‌ها را شامل می‌شود. برای پیگیری هزینه‌ها و جلوگیری از تمام شدن اعتبار، داشبورد خود را بررسی کنید. با USDT یا USDC شارژ کنید تا دسترسی فوری داشته باشید.