مستندات API

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

ابتدا کلید خود را از داشبورد تولید کنید. URL پایه ما HTTPS://api.aivenice.cc/v1 است. کلید خود را در هدر Authorization ارسال کنید. یک کلید فعال برای هر حساب، کلید قبلی را به طور خودکار جایگزین می‌کند.

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

یک تکمیل چت ساده ارسال کنید تا اتصال را آزمایش کنید. شناسه مدل "uncensored" است. این مدل متن ورودی و خروجی را به‌طور کارآمد پردازش می‌کند. می‌توانید پارامترهایی مانند دما را برای خلاقیت تنظیم کنید.

Copyfrom openai import OpenAI

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

از SDK رسمی Node برای یکپارچه‌سازی آسان استفاده کنید. URL پایه را به نقطه پایانی ما تنظیم کنید. کلید API خود را در شیء پیکربندی وارد کنید. این روش با اکثر کتابخانه‌های سازگار با OpenAI کار می‌کند.

Copyimport OpenAI from "openai";

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

پاسخ‌ها را مستقیماً در محیط جاوااسکریپت خود پردازش کنید. ساختار با فرمت‌های استاندارد OpenAI برای آشنایی مطابقت دارد.

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

با تنظیم stream به true، پخش زنده را فعال کنید. شما توکن‌ها را همان‌طور که تولید می‌شوند دریافت می‌کنید. این کار تأخیر ادراک‌شده را برای کاربران کاهش می‌دهد. قطعه نهایی شامل جزئیات کل مصرف توکن است.

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)

رویدادهای SSE را تجزیه کنید تا رابط کاربری خود را به‌طور بلادرنگ به‌روزرسانی کنید. این برای رابط‌های چت که بازخورد فوری نیاز دارند، ایده‌آل است.

پارامترها و محدودیت‌ها

برای کنترل بیشتر، دما (temperature)، top_p و seed را تنظیم کنید. حداکثر خروجی ۱۶,۰۰۰ توکن است. پنجره زمینه (context window) ۱۰۰,۰۰۰ توکن است. محدودیت نرخ ۳۰۰ درخواست در دقیقه است. حداکثر اندازه بدنه ۸ مگابایت است.

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

خطاها و پنجره زمینه

خطای ۴۰۱ را برای کلیدهای نامعتبر مدیریت کنید. خطای ۴۰۲ را زمانی استفاده کنید که اعتبار کم است. خطای ۴۲۹ نشان‌دهنده تجاوز از محدودیت نرخ است. خطاها و رد شدن‌ها رایگان هستند. اعتبار پیش‌پرداخت شما هرگز منقضی نمی‌شود. پنجره زمینه توکن‌های ورودی و تکمیل را به صورت ترکیبی محاسبه می‌کند.

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

cURL

Copycurl https://api.aivenice.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the latest error logs from server logs"}]
  }'