مستندات API: تکمیل گفتگو

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

اولین درخواست تکمیل چت خود را در کمتر از یک دقیقه ارسال کنید. نقطه پایانی پیکربندی‌های استاندارد OpenAI را می‌پذیرد و پاسخ‌های متنی نامحدود برمی‌گرداند. کلاینت را با کلید API و URL پایه خود مقداردهی اولیه کنید. سپس نقطه پایانی تکمیل‌های چت را با شناسه مدل تنظیم شده به "uncensored" فراخوانی کنید. مدل متن را بدون رد محتو برای استفاده بزرگسالان قانونی تولید می‌کند.

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

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

کلید API خود را برای هر درخواست به URL پایه استفاده کنید https://api.geminisemcensura.com/v1. کلید به محض ثبت‌نام از طریق گوگل یا ایمیل به صورت آنی تولید می‌شود. آن را در Authorization هدر به عنوان یک توکن Bearer. اگر کلید جدیدی تولید کنید، کلید قدیمی فوراً نامعتبر می‌شود. این مدیریت اعتبارنامه‌ها برای برنامه‌های شما را ساده می‌کند. می‌توانید کلیدها را مستقیماً از داشبورد بازیابی کنید بدون از دست دادن اعتبار پیش‌پرداخت خود.

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

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

این پارامترها دقیقاً همان‌طور که در SDK OpenAI کار می‌کنند. می‌توانید سبک پاسخ را بدون تغییر مدل تنظیم کنید. مدل بدون سانسور این محدودیت‌ها را رعایت می‌کند در حالی که عدم امتناع از محتوا را حفظ می‌نماید. آن‌ها را برای تناسب با مورد استفاده خاص خود تنظیم کنید.

پاسخ‌های استریم (SSE)

استریمینگ را با تنظیم stream به true. سرور دنباله‌ای از رویدادهای سرور-ارسالی (SSE) را بازگردانده و ارسال می‌کند. هر رویداد حاوی یک قطعه جزئی از متن تولیدشده است. این امکان را می‌دهد تا خروجی به صورت بلادرنگ نمایش داده شود. این کار تأخیر ادراک‌شده را برای کاربران نهایی کاهش می‌دهد.

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

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

از فراخوانی تابع برای یکپارچه‌سازی ابزارهای خارجی استفاده کنید. توابع را در tools پارامتر. مدل استدلال‌های ساختاریافته برای تابع مشخص شده بازگردانی می‌کند. تابع را اجرا کنید و نتیجه را به مدل بازگردانید. این اجازه می‌دهد تا جریان‌های کاری چندمرحله‌ای پیچیده انجام شود. حالت JSON خروجی JSON دقیق را اعمال می‌کند. از response_format با json_object برای پردازش قابل اعتماد.

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

Limits and Quotas

API محدودیت‌های نرخ سخت‌گیرانه‌ای را برای تضمین پایداری اعمال می‌کند. شما مجاز به ۳۰۰ درخواست در دقیقه در هر کلید هستید. همزمانی به ۸ درخواست همزمان محدود شده است. حداکثر اندازه بدنه درخواست ۸ مگابایت است. پنجره زمینه از ۱۰۰,۰۰۰ توکن برای ورودی و خروجی ترکیبی پشتیبانی می‌کند. حداکثر خروجی پیش‌فرض ۲,۰۴۸ توکن است مگر اینکه خلاف آن را مشخص کنید.

اگر از محدودیت نرخ تجاوز کنید، خطای ۴۲۹ دریافت خواهید کرد. پاسخ شامل هدر retry-after است. مصرف خود را برای جلوگیری از وقفه‌ها پایش کنید. این محدودیت‌ها برای تمام نقاط پایا (endpoints)، از جمله درخواست‌های استریم، اعمال می‌شوند. کارهای دسته‌ای خود را بر این اساس برنامه‌ریزی کنید.

cURL

Copycurl https://api.geminisemcensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the release date of the last update"}]
  }'

پایتون

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

جریان‌سازی

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)