نصب SDK رسمی
ابتدا SDK رسمی OpenAI برای زبان مورد نظر خود را نصب کنید. زیبایی API ما این است که از همان کتابخانههای کلاینتی استفاده میکند که قبلاً میشناسید. نیازی به کتابخانه سفارشی یا اسکریپت راهاندازی پیچیده ندارید. pip install openai یا npm install openai شما را آماده میکند. این رویکرد به این معنی است که پایگاه کد موجود شما با حداقل اصطکاک سازگار میشود. میتوانید بین ارائهدهندگان بدون بازنویسی منطق هسته خود جابجا شوید.
پیکربندی base_url و کلید
مشتری خود را به URL پایه اختصاصی ما هدایت کنید و کلید API خود را تزریق کنید. نقطه پایانی ما در https://api.groknsfwprompts.com/v1. این URL تضمین میکند که مستقیماً به مدل بدون سانسور ما متصل شوید. باید base_url پارامتر را در پیکربندی SDK خود تنظیم کنید. کلید خود را از طریق api_key header. این پیکربندی از مسیریابی پیشفرض OpenAI عبور میکند. تضمین میکند که شما با سرورهای ما صحبت میکنید، نه سرورهای آنها.
اینجا نحوه پیکربندی اتصال در یک درخواست استاندارد توضیح داده شده است:
curl https://api.groknsfwprompts.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Describe a cybernetic woman in a neon city"}]
}'
اولین درخواست خود را ارسال کنید
یک تکمیل چت ساده ارسال کنید تا اتصال خود را بررسی کنید. از شناسه مدل uncensored برای تمام درخواستها. این ID به مدل وزنباز ما که برای محتوای بزرگسالان تنظیم شده اشاره دارد. یک پرامپت که معمولاً باعث فیلتر شدن میشود ارسال کنید. مدل متن خام را بدون رد کردن بازگردانی میکند. شما خروجی متنی فوری برای نیازهای مهندسی پرامپت خود دریافت میکنید. این مرحله فعال بودن موجودی اعتبار شما را تأیید میکند.
این اسکریپت پایتون مینیمال را برای آزمایش اتصال امتحان کنید:
from openai import OpenAI
client = OpenAI(base_url="https://api.groknsfwprompts.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)
فعالسازی جریانسازی برای خروجی بلادرنگ
پخش زنده را فعال کنید تا توکنها به محض تولید دریافت شوند. این کار تأخیر ادراکشده را برای پاسخهای طولانی کاهش میدهد. مقدار stream=True در پارامترهای درخواست. SDK قطعات را هنگام در دسترس بودن ارائه میدهد. این برای تولید پرامپت ویدیو که میخواهید بازخورد فوری داشته باشید، حیاتی است. میتوانید جریان را در صورت انحراف پاسخ لغو کنید. این تجربه توسعهدهنده را برای آزمایشهای تکراری هموارتر میکند.
اینجا الگوی پیادهسازی استریم توضیح داده شده است:
stream = 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
از خروجی ساختاریافته برای تجزیهی consistent دادهها بهره ببرید. استفاده response_format={"type": "json_object"} برای JSON دقیق. این تضمین میکند که تجزیهکنندههای downstream شما دادههای معتبر دریافت کنند. همچنین میتوانید ابزارها را برای فراخوانی تابع تعریف کنید. مدل از تعاریف و انتخابهای استاندارد ابزار پشتیبانی میکند. این ویژگی برای پایپلاینهای تولید خودکار پرامپت NSFW حیاتی است. ساختار داده شما را قابل پیشبینی و تمیز نگه میدارد.
ببینید که حالت JSON را در Node.js چگونه اعمال کنید:
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.groknsfwprompts.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);
درک محدودیتهای توکن و قیمتگذاری
مصرف خود را در برابر محدودیتهای شفاف ما پایش کنید. ما توکنهای ورودی را ۰.۱۵ دلار به ازای هر میلیون و توکنهای خروجی را ۰.۵۰ دلار به ازای هر میلیون محاسبه میکنیم. پنجره زمینه شما ۱۰۰,۰۰۰ توکن در مجموع است. میتوانید تا ۱۶,۰۰۰ توکن در هر درخواست خروجی بگیرید. محدودیتهای نرخ شما را به ۳۰۰ درخواست در دقیقه محدود میکند. خطاها مانند ۴۰۲ (عدم موجودی) یا ۴۲۹ (محدودیت نرخ) را بهخوبی مدیریت کنید. خطاها و رد شدن درخواستها اعتبار شما را مصرف نمیکنند. این مدل از کارکردهای مهندسی پرامپت سنگین پشتیبانی میکند.