احراز هویت و پیکربندی URL پایه
کلید API شما دسترسی فوری به نقطه پایانی تکمیل مکالمه را فراهم میکند. یک کلید را از طریق گوگل یا ایمیل در داشبورد ایجاد کنید و آن را در متغیرهای محیطی خود قرار دهید. URL پایه https://api.cheapaiapikeys.com/v1 که با هر مشتری SDK استاندارد OpenAI کار میکند.
- تنظیم
OPENAI_API_KEYبه رشته تولید شده خود. - بازنویسی
base_urlبه سرور میزبانی ما اشاره کنید. - اتصال را با فراخوانی
GET /v1/modelsبرای لیست کردن مدلهای موجود.
curl https://api.cheapaiapikeys.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List three common regex patterns for validating email addresses"}]
}'
اولین درخواست تکمیل چت خود را ارسال کنید
ورودی متنی ارسال کنید و متن تولید شده را با ساختار استاندارد تکمیل گفتگو دریافت کنید. مدل تک و بدون سانسور ما، درخواستها را بدون رد کردن موضوعات بزرگسالان قانونی یا بحثبرانگیز پردازش میکند. میتوانید پارامترهایی مانند temperature و top_p برای کنترل تصادفیسازی.
from openai import OpenAI
client = OpenAI(base_url="https://api.cheapaiapikeys.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
فعالسازی تحویل توکن بلادرنگ با تنظیم stream: true در درخواست شما. سرور رویدادهای ارسالی سرور (SSE) را برمیگرداند که باید آنها را بهتدریج تجزیه کنید. جزئیات مصرف توکن در قطعه نهایی استریم ظاهر میشوند. این روش تأخیر ادراکشده برای پاسخهای طولانی را کاهش میدهد.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.cheapaiapikeys.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);
از Function Calling و حالت JSON استفاده کنید
ابزارها را در بدنه درخواست خود برای فعالسازی خروجی ساختاریافته یا اجرای توابع خارجی تعریف کنید. از response_format: {type: "json_object"} برای اجبار به انطباق سختگیرانه JSON. مدل از tool_choice برای کنترل دقیق بر توابعی که فراخوانی میکند. این برای پردازش قابل اعتماد منطق برنامه شما تضمین میکند.
درک محدودیتهای توکن و قیمتگذاری
قیمتگذاری شفاف است: ۰.۱۵ دلار به ازای هر میلیون توکن ورودی و ۰.۵۰ دلار به ازای هر میلیون توکن خروجی. خطاها و رد شدنها اعتبار مصرف نمیکنند. پنجره زمینه (context window) از مجموعاً ۱۰۰,۰۰۰ توکن پشتیبانی میکند. درخواستهایی که از حد مجاز تجاوز میکنند، خطای محدود نرخ 429 را برمیگردانند. اطمینان حاصل کنید که پیکربندیهای شما کمتر از ۸ مگابایت باشند تا از خطاهای بدنه جلوگیری شود.
مدیریت خطاها و موارد مرزی
خطاهای رایج شامل 401 برای کلیدهای نامعتبر و 402 برای اعتبار ناکافی است. وضعیت 429 نشان میدهد که از 300 درخواست در دقیقه تجاوز کردهاید. از backoff نمایی هنگام تلاش مجدد پس از محدودیت نرخ استفاده کنید. بررسی کنید error object در پاسخ JSON برای جزئیات خاص. بازپرداخت انجام نمیشود، بنابراین استفاده خود را به دقت نظارت کنید.
جریانسازی
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)