مستندات API سازگار با OpenAI

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

URL پایه برای تمام درخواست‌ها HTTPS://api.keyapikimi.com/v1 است. با ارسال کلید منحصر‌به‌فرد API خود در هدر Authorization احراز هویت کنید. این کلید را بلافاصله پس از ثبت‌نام با گوگل یا ایمیل دریافت می‌کنید. کلید دسترسی به مدل uncensored را بدون نیاز به اشتراک ماهانه فراهم می‌کند.

Copycurl https://api.keyapikimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch weather in tokyo"}]
  }'

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

اولین درخواست: تکمیل‌های چت

پرس‌و‌جوهای متنی را به مدل بدون سانسور تک از طریق endpoint تکمیل گفتگو ارسال کنید. شناسه مدل "uncensored" است. این endpoint پارامترهای استاندارد مانند temperature و top_p را می‌پذیرد. متن تولید شده را بدون رد محتوایی برای استفاده بزرگسالان قانونی برمی‌گرداند.

Copyfrom openai import OpenAI

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

هر درخواست از پنجره زمینه ۱۰۰,۰۰۰ توکنی برای ترکیب ورودی و خروجی پشتیبانی می‌کند. می‌توانید پاسخ‌ها را استریم کنید یا آن‌ها را به عنوان یک بلوک واحد دریافت کنید. مدل فراخوانی تابع و حالت JSON را به طور کارآمد مدیریت می‌کند.

یکپارچه‌سازی SDK Node.js

از SDK رسمی OpenAI برای Node.js برای اتصال آسان استفاده کنید. URL پایه و کلید API را در شیء پیکربندی خود تنظیم کنید. این روش با هر کتابخانه کلاینت سازگار با OpenAI کار می‌کند. با استفاده از یک ارائه‌دهنده مدل واحد، از منطق مسیریابی پیچیده اجتناب می‌کنید.

Copyimport OpenAI from "openai";

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

شناسه مدل "uncensored" را ارسال کنید تا مطمئن شوید درخواست‌ها به سرور صحیح ارسال می‌شوند. API شمارش توکن‌ها و صورتحساب را به صورت خودکار انجام می‌دهد. خطاها به صورت کدهای وضعیت HTTP استاندارد برای عیب‌یابی آسان بازگردانده می‌شوند.

پاسخ‌های استریم از طریق SSE

با تنظیم پارامتر stream روی true، قابلیت streaming را فعال کنید. 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 را تجزیه کنید تا متن را همان‌طور که تولید می‌شود نمایش دهید. حداکثر خروجی در هر درخواست ۱۶,۰۰۰ توکن است. اگر max_tokens را تنظیم نکنید، پیش‌فرض ۲,۰۴۸ توکن است. جریان‌دار بودن با تمام پارامترهای استاندارد مانند دنباله‌های توقف کار می‌کند.

پارامترها: دما و Top P

با پارامتر temperature خلاقیت را کنترل کنید. مقادیر بالاتر متن‌های متنوع‌تری تولید می‌کنند. با استفاده از top_p، نمونه‌برداری را به توکن‌های محتمل‌تر محدود کنید. پارامتر stop تولید را هنگام ظاهر شدن رشته‌های خاص متوقف می‌کند. این تنظیمات برای کنترل دقیق در کنار هم کار می‌کنند.

seed را برای نتایج قابل تکرار در طول آزمایش تنظیم کنید. جریمه‌های حضور و فرکانس به کاهش تکرار کمک می‌کنند. حالت JSON خروجی را به JSON معتور مجبور می‌کند. از response_format برای اعمال ساختارهای داده دقیق برای برنامه‌های خود استفاده کنید.

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

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

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