احراز هویت: استفاده از کلید API شما
کلید API شما هر درخواستی که به سرورهای ما ارسال میکنید را احراز هویت میکند. ما یک کلید واحد برای هر حساب صادر میکنیم که از طریق داشبورد ایجاد میشود. این کلید را در Authorization هدر با استفاده از طرح Bearer. اگر کلید نامعتبری ارسال کنید، خطای 401 را برمیگردانیم. اگر اعتبار پیشپرداخت شما تمام شود، خطای 402 را برمیگردانیم که نیاز به شارژ از طریق ارز دیجیتال دارد تا ادامه دهید.
ساختار URL پایه و نقطه پایانی
تمام درخواستها را به URL پایه واحد ما برای تکمیل چت ارسال کنید. ما اندامهای embedding، تولید تصویر یا فاینتیون ارائه نمیدهیم. از استاندارد POST /v1/chat/completions مسیر برای ارسال درخواستهای خود. همچنین میتوانید GET /v1/models برای بررسی شناسه مدل موجود. این ساختار سازگاری با کلاینتهای SDK موجود OpenAI را بدون نیاز به منطق مسیریابی سفارشی تضمین میکند.
شروع سریع: اولین درخواست شما با ablated AI
یک درخواست متنی ساده ارسال کنید تا بلافاصله مدل uncensored را آزمایش کنید. از کتابخانه رسمی OpenAI یا هر کلاینت HTTP دیگری برای POST کردن پیام خود استفاده کنید. مدل پاسخ متنی را بدون فیلتر کردن محتوای بزرگسالان قانونی برمیگرداند. مقدار جایگزین را با اعتبار واقعی خود از داشبورد جایگزین کنید.
curl https://api.aiablated.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "what is the current version of the api"}]
}'
این درخواست جریان تعامل پایه را نشان میدهد. شما یک پاسخ مستقیم از مدل Ablated دریافت میکنید. پرامپت سیستم را برای تعریف شخصیت یا زمینه برای مورد استفاده خاص خود تنظیم کنید.
یکپارچهسازی SDK Python
از کتابخانه رسمی پایتون OpenAI برای یکپارچهسازی API در برنامههای خود استفاده کنید. URL پایه و کلید API را در پیکربندی کلایتن تنظیم کنید. این روش سریالسازی و تجزیه خطاها را بهطور خودکار مدیریت میکند. میتوانید پاسخها را استریم کنید یا آنها را بهطور همزمان دریافت کنید. کتابخانه کلاینت چرخه حمله اتصال را برای شما مدیریت میکند.
from openai import OpenAI
client = OpenAI(base_url="https://api.aiablated.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)
این قطعه کد کلاینت را به درستی مقداردهی اولیه میکند. به آدرس پایه خاص ما اشاره میکند. اطمینان حاصل کنید که آخرین بسته openai را برای سازگاری کامل با ویژگیهای استریم و فراخوانی تابع نصب کرده باشید.
یکپارچهسازی SDK Node.js
API را در پروژههای JavaScript یا TypeScript خود با استفاده از SDK استاندارد ادغام کنید. URL پایه را به سمت سرویس ما تنظیم کنید. این به شما اجازه میدهد از روشهای آشنا مانند chat.completions.create. SDK هدرهای درخواست و تجزیه پاسخ را مدیریت میکند. میتوانید بهراحتی مدیریت خطاها برای محدودیت نرخ یا شکستهای احراز هویت را اضافه کنید.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aiablated.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);
این پیکربندی تضمین میکند که برنامه Node شما به درستی ارتباط برقرار میکند. تغییر آدرس پایه (base URL override) مرحلهی حیاتی است. بدون آن، SDK تلاش میکند به فضای ابری OpenAI متصل شود، نه سرورهای ما.
پاسخهای استریم و مصرف توکن
پاسخها را توکن به توکن با استفاده از رویدادهای ارسالی سرور (SSE) دریافت کنید. این کار تأخیر ادراکشده را برای خروجیهای طولانی کاهش میدهد. قطعه نهایی جریان شامل کل استفاده توکن برای درخواست است. میتوانید مصرف اعتبار پیشپرداخت خود را به صورت بلادرنگ ردیابی کنید. مقدار stream: true در پیکربندی درخواست برای فعالسازی این حالت. این برای رابطهای چت و تولید متن زنده ایدهآل است.
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)
این رویکرد استریمینگ تجربه کاربری روانی فراهم میکند. قطعه نهایی شامل آمار مصرف است. این اعداد را برای مدیریت مؤثر اعتبار پیشپرداخت خود پایش کنید. خطاهای حین استریم توسط SDK بهخوبی مدیریت میشوند.