کلیدهای احراز هویت
ابتدا با ایجاد حساب کاربری شروع کنید تا بلافاصله کلید API خود را دریافت کنید. میتوانید با گوگل یا ایمیل و رمز عبور ثبتنام کنید و نیازی به شماره تلفن ندارید. سیستم برای هر حساب یک کلید فعال تولید میکند و ایجاد کلید جدید، کلید قبلی را بلافاصله جایگزین میکند. برای شروع فقط به یک آدرس ایمیل نیاز دارید و پرامپتهای شما برای آموزش استفاده نمیشوند. از این کلید در Authorization هدر به عنوان یک توکن bearer برای تمام درخواستها.
اولین درخواست
اولین فراخوانی خود را با استفاده از کلید API ارسال کنید. URL پایه https://api.aidphn.com/v1 و با کلاینتهای استاندارد سازگار با OpenAI کار میکند. باید شناسه مدل uncensored برای دسترسی به مدل زبانی بزرگ بدون فیلتر. خطاها و رد شدنها اعتبار پیشپرداخت شما را مصرف نمیکنند، بنابراین میتوانید به طور ایمن تست کنید.
curl https://api.aidphn.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 Rust crates for async HTTP clients"}]
}'
کارکرد کلید خود را با بررسی endpoint لیست مدلها آزمایش کنید. این موضوع اتصال را پیش از ارسال پرسوجوهای پیچیده تأیید میکند. API متن را دریافت کرده و متن برمیگرداند و از پارامترهای استاندارد مانند دما و top_p پشتیبانی میکند.
یکپارچهسازی SDK Python
از کتابخانه رسمی پایتون OpenAI برای ارتباط با انتهای کار ما استفاده کنید. آدرس پایه را به سرور API ما تنظیم کرده و کلید خود را ارائه دهید. این روش به شما اجازه میدهد کدهای موجود از پروژههای OpenAI را بدون تغییرات عمیق بازنویسی کنید. شناسه مدل همچنان uncensored برای تمام تکمیلها.
from openai import OpenAI
client = OpenAI(base_url="https://api.aidphn.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)
میتوانید پارامترهایی مانند max_tokens برای کنترل طول خروجی. حداکثر خروجی پیشفرض ۲,۰۴۸ توکن است، اما میتوانید آن را تا ۱۶,۰۰۰ در هر درخواست افزایش دهید. استریم برای پاسخهای طولانی برای کاهش تأخیر در دسترس است.
استفاده Node SDK
API را در برنامههای Node.js خود با استفاده از SDK استاندارد یکپارچه کنید. کلاینت را به URL پایه ما پوینت کنید و با کلید خود احراز هویت نمایید. این روش از درخواستهای همزمان و ناهمزمان برای یکپارچهسازی انعطافپذیر پشتیبانی میکند. میتوانید ابزارها را برای فراخوانی تابع ارسال کنید یا حالتهای خروجی JSON را اعمال نمایید.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aidphn.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);
پاسخها را با تجزیه فیلد content از شیء completion پردازش کنید. API از پارامترهای استاندارد مانند پشتیبانی میکند stop sequences و seed برای تکرارپذیری. مدیریت خطاها باید محدودیتهای نرخ و در دسترس بودن اعتبار را در نظر بگیرد.
پاسخهای استریم از طریق SSE
استریمینگ را با تنظیم stream: true در درخواست شما. API رویدادهای ارسالی سرور (SSE) را برای تحویل بلادرنگ توکن برمیگرداند. هر قطعه محتوای جزئی دارد که به شما امکان میدهد خروجی را هنگام تولید نمایش دهید. قطعه نهایی شامل کل مصرف توکن برای شفافیت صورتحساب است.
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)
استریمینگ تأخیر ادراکشده را برای کاربران منتظر پاسخهای طولانی کاهش میدهد. میتوانید توکنها را به صورت افزایشی پردازش کنید یا برای استفاده بعدی آنها را بافر کنید. پنجره زمینه تا 100,000 توکن برای پرامپت و تکمیل ترکیبی پشتیبانی میکند.
Limits and Errors
مصرف خود را در برابر محدودیتهای سختگیرانه نرخ و موجودی اعتبار پایش کنید. میتوانید ۳۰۰ درخواست در دقیقه ارسال کنید و ۸ درخواست همزمان به ازای هر کلید داشته باشید. حداکثر اندازه بدنه درخواست ۸ مگابایت است. خطاهایی مانند ۴۰۱ نشاندهنده کلید نامعتبر هستند، در حالی که ۴۰۲ به معنای نیاز به شارژ است. خطاهای ۴۲۹ نشان میدهند که شما از محدودیت نرخ فراتر رفتهاید. تنها با ارز دیجیتال شارژ کنید، شروع از ۲۰ دلار، تا بدون وقفه به استفاده از سرویس ادامه دهید.