مستندات API انکاتلی AI

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

ارسال اولین پیام به /v1/chat/completions اندپوینت با استفاده از کلاینت HTTP مورد علاقه شما.

شناسه مدل به سادگی uncensored. این مدل وزن‌باز روی سرورهای ما اجرا می‌شود و بدون رددهی‌های معمول محتوای بزرگسالان قانونی، پاسخ می‌دهد.

می‌توانید ساختارهای پرامپت استاندارد ارسال کنید. API ورودی متنی می‌پذیرد و خروجی متنی برمی‌گرداند. با هر SDK یا کلاینت OpenAI که از فرمت chat-completions پشتیبانی می‌کند، سازگار است.

در اینجا یک مثال پایه با استفاده از cURL برای دریافت پاسخ آورده شده است.

Copycurl https://api.uncutlyai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
  }'

SDK Python

از بسته رسمی پایتون OpenAI برای تعامل با API ما با حداقل کد استفاده کنید.

تنظیم base_url و api_key پارامترها در راه‌اندازی کلاینت خود. این تضمین می‌کند که درخواست‌ها به انتهای‌نقطه بدون سانسور ما هدایت می‌شوند، نه سرورهای OpenAI.

نام مدل uncensored. می‌توانید پیام‌ها را به صورت لیستی از دیکشنری‌ها ارسال کنید. شیء پاسخ شامل متن تولید شده در response.choices[0].message.content.

این رویکرد برای اسکریپت‌های ساده یا منطق برنامه پیچیده کار می‌کند. سریال‌سازی را به‌طور خودکار مدیریت می‌کند.

Copyfrom openai import OpenAI

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

Node SDK

API را در برنامه‌های Node.js خود با استفاده از openai بسته.

مشتری را با URL پایه و کلید API خود پیکربندی کنید. SDK درخواست‌های HTTP را مدیریت کرده و پاسخ JSON را تجزیه می‌کند.

فراخوانی chat.completions.create روش با مدل uncensored. می‌توانید promptهای سیستمی یا پیام‌های کاربر را همان‌طور که نیاز است تعریف کنید.

این روش برای تولید سمت سرور قابل اعتماد است. این روش به خوبی در مسیرهای Express یا وظایف پس‌زمینه (background jobs) جای می‌گیرد.

Copyimport OpenAI from "openai";

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

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

دریافت توکن‌های متنی توکن‌به‌توکن با استفاده از رویدادهای ارسالی سرور (SSE) برای کاهش تأخیر ادراکی.

تنظیم stream پارامتر روی true در درخواست شما. API یک جریان از قطعات را به جای یک پاسخ کامل واحد برمی‌گرداند.

هر تکه شامل متن جزئی است. می‌توانید این تکه‌ها را به هم بچسبانید تا پیام نهایی را بسازید. این برای رابط‌های چت که به‌صورت بلادرنگ به‌روز می‌شوند مفید است.

آخرین قطعه شامل آمار استفاده است. می‌توانید مصرف توکن را مستقیماً از جریان ردیابی کنید.

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)

محدودیت‌ها، خطاها و & زمینه

محدودیت‌ها و کدهای خطا را درک کنید تا یکپارچه‌سازی خود را سریعاً رفع خطا کنید.

پنجره زمینه شما ۱۰۰,۰۰۰ توکن در مجموع است. این شامل هم پرامپت ورودی و هم خروجی تولید شده می‌شود. می‌توانید حداکثر خروجی را ۱۶,۰۰۰ توکن در هر درخواست تنظیم کنید.

محدودیت نرخ درخواست‌ها روی ۳۰۰ درخواست در دقیقه به ازای هر کلید تنظیم شده است. می‌توانید ۸ درخواست همزمان را همزمان اجرا کنید. محدودیت بدنه درخواست 8 MB است.

خطاهای رایج شامل 401 برای کلید نامعتبر و 402 زمانی است که اعتبار پیش‌پرداخت شما تمام می‌شود. خطای 429 به این معنی است که به محدودیت نرخ رسیده‌اید. خطاها اعتبار شما را مصرف نمی‌کنند.

قیمت‌گذاری شفاف است: $0.15 به ازای هر 1M توکن ورودی و $0.50 به ازای هر 1M توکن خروجی. اعتبار پیش‌پرداخت است و هرگز منقضی نمی‌شود.