API ia راهنمای شروع سریع

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

کلید API منحصر‌به‌فرد خود را با هر درخواست به https://api.apiia.cc/v1 URL پایه است. این نقطه پایانی سازگار با OpenAI با هر SDK استاندارد کار می‌کند؛ کافی است URL پایه را تنظیم کرده و کلید خود را در Authorization header. کلید بلافاصله پس از ثبت‌نام از طریق گوگل یا ایمیل تولید می‌شود و نیازی به شماره تلفن نیست. کلید خود را امن نگه دارید، زیرا دسترسی مستقیم به اعتبار پیش‌پرداخت شما را فراهم می‌کند. می‌توانید هر زمان کلید جدیدی تولید کنید که بلافاصله کلید قبلی را جایگزین می‌کند.

ارسال اولین تکمیل خود

یک درخواست POST به /v1/chat/completions با مدل تنظیم شده به "uncensored". این رابط ساده ورودی-خروجی متنی، پرامپت‌های شما را بدون رد محتوایی برای استفاده بزرگسالان قانونی مدیریت می‌کند. می‌توانید طول پاسخ را با استفاده از max_tokens پارامتر، که در صورت حذف به ۲,۰۴۸ توکن پیش‌فرض می‌شود. مدل از پنجره زمینه ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند که اجازه تاریخچه‌های درخواست قابل توجه را می‌دهد. از این نقطه پایدار برای تولید متن بدون فیلتر استفاده کنید.

Copycurl https://api.apiia.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

یکپارچه‌سازی SDK Python

پکیج رسمی OpenAI Python را نصب کنید و URL پایه را طوری پیکربندی کنید که به سرویس ما اشاره کند. این به شما اجازه می‌دهد از روش‌های آشنا مانند chat.completions.create() با مدل uncensored ما. SDK توکن‌سازی و قالب‌بندی درخواست را به صورت خودکار انجام می‌دهد. می‌توانید پارامترهایی مانند temperature و top_p برای کنترل خلاقیت و تصادفی‌سازی. این رویکرد یکپارچه‌سازی را در برنامه‌های Python موجود یا جریان‌های کار علم داده ساده می‌کند.

Copyfrom openai import OpenAI

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

یکپارچه‌سازی Node SDK

از SDK نود.js OpenAI با تنظیم BASE_URL متغیر محیطی یا پیکربندی نمونه مشتری. این یکپارچه‌سازی روان با پروژه‌های JavaScript و TypeScript را امکان‌پذیر می‌سازد. SDK از تمام ویژگی‌های استاندارد تکمیل چت، از جمله فراخوانی تابع و حالت JSON پشتیبانی می‌کند. می‌توانید به راحتی بین حالت‌های تدریجی و غیرتدریجی جابجا شوید. این انعطاف‌پذیری آن را برای ساخت برنامه‌های وب یا توابع بدون سروری که به تولید متن بدون سانسور نیاز دارند، ایده‌آل می‌سازد.

Copyimport OpenAI from "openai";

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

پاسخ‌های استریم با SSE

استریمینگ را با تنظیم stream: true در درخواست شما. API رویدادهای ارسالی سرور (SSE) را با هر توکن همان‌طور که تولید می‌شود برمی‌گرداند. این بازخورد در زمان واقعی فراهم می‌کند و تأخیر ادراک‌شده را برای کاربران نهایی کاهش می‌دهد. قطعه نهایی شامل آمار مصرف توکن است که به شما امکان می‌دهد هزینه‌ها را به دقت ردیابی کنید. پخش جریان برای رابط‌های چت تعاملی و تولید محتوای پویا ضروری است. این تجربه کاربری روانی را حتی با پاسخ‌های طولانی‌تر تضمین می‌کند.

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)

محدودیت‌ها، خطاها و پنجره زمینه

کلید API شما محدود به 300 درخواست در دقیقه و 8 درخواست همزمان است. حداکثر اندازه بدنه درخواست 8 مگابایت است. اگر خطای 401 دریافت کردید، اعتبار کلید API خود را بررسی کنید. خطای 402 نشان‌دهنده عدم موجودی اعتبار پیش‌پرداخت است. خطای 429 به این معنی است که از محدودیت نرخ تجاوز کرده‌اید. پنجره زمینه از 100,000 توکن برای ترکیب پرامپت و تکمیل پشتیبانی می‌کند. درک این محدودیت‌ها به شما کمک می‌کند تا برنامه‌های مقاومی طراحی کنید که خطاها را به صورت شایسته مدیریت می‌کنند.