مستندات API: راهنمای شروع سریع

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

از URL پایه و کلید API خود را در Authorization هدر برای شروع ارسال درخواست‌ها. ما یک نقطه پایدار واحد ارائه می‌دهیم که پیکربندی‌های استاندارد OpenAI را می‌پذیرد، بنابراین نیازی به بازنویسی منطق ادغام خود ندارید. برای دریافت کلید خود به صورت فوری و بدون نیاز به شماره تلفن، از طریق گوگل یا ایمیل ثبت‌نام کنید. این کلید حساب کاربری شما را برای هر تماسی که انجام می‌دهید، در برابر سرورهای ما احراز هویت می‌کند.

• URL پایه: https://api.geminisincensura.com/v1
• شناسه مدل: uncensored

می‌توانید کلید خود را در هر زمان با تولید یک کلید جدید بچرخانید که بلافاصله توکن قبلی را نامعتبر می‌کند.

Copycurl https://api.geminisincensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "explain how to configure the proxy endpoint"}]
  }'

نقطه پایانی تکمیل گفتگو

یک درخواست POST به /v1/chat/completions برای دریافت پاسخ‌های متنی از مدل بدون سانسور ما. این نقطه پایان تمام نیازهای مکالمه‌ای استاندارد شما را با پنجره زمینه‌ای ۱۰۰,۰۰۰ توکن (ترکیب ورودی و خروجی) مدیریت می‌کند. می‌توانید حداکثر خروجی را ۱۶,۰۰۰ توکن تنظیم کنید یا اجازه دهید مدل به‌طور پیش‌فرض روی ۲,۰۴۸ توکن تنظیم شود. مدل بدون رد کردن موضوعات قانونی بزرگسالان، داستانی یا بحث‌برانگیز پاسخ می‌دهد و آزادی واقعی را برای مورد استفاده شما فراهم می‌کند. خطاها و رد شدن‌ها اعتبار از پیش پرداخت شده شما را مصرف نمی‌کنند.

Copyfrom openai import OpenAI

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

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

پاسخ‌ها را در زمان واقعی با استفاده از رویدادهای ارسالی سرور (SSE) جریان دهید تا تأخیر ادراک‌شده برای کاربران شما کاهش یابد. هر قطعه شامل تغییرات متن است و قطعه نهایی شامل آمار کامل مصرف توکن برای شفافیت صورتحساب می‌شود. این روش به‌طور بی‌درنگ با SDKهای استاندارد OpenAI کار می‌کند با فعال‌سازی جریان در پیکربندی کلاینت شما. شما بازخورد فوری دریافت می‌کنید در حالی که مدل خروجی‌های بلندتر تا محدودیت 16,000 توکن تولید می‌کند.

Copyimport OpenAI from "openai";

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

فراخوانی تابع و ابزارها

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

حالت JSON و فرمت پاسخ

مدل را مجبور به خروجی JSON معتبر کنید با تنظیم response_format به {"type": "json_object". این اطمینان حاصل می‌کند که تجزیه‌ی قابل پیش‌بینی برای برنامه‌های شما وجود دارد بدون اینکه نیاز به پردازش پس‌از آن باشد. مدل به طرحواره‌ای که ارائه می‌دهید پایبند است و برای یکپارچه‌سازی‌های بک‌اند قابل اعتماد است. می‌توانید این مورد را با پارامترهای دما و top_p ترکیب کنید تا خلاقیت را در حالی که یکپارچگی ساختاری حفظ می‌شود، کنترل کنید.

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

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

جریان‌سازی

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)