مستندات API Iymau

کلیدهای احراز هویت

کلید API شما هر درخواست را احراز هویت می‌کند. با گوگل یا ایمیل ثبت‌نام کنید تا بلافاصله یک کلید فعال دریافت کنید. این کلید را امن نگه دارید، زیرا به عنوان رمز عبور شما برای سرویس عمل می‌کند. اگر آن را گم کردید، کلید جدیدی ایجاد کنید تا کلید فعال قبلی را جایگزین کند. سیستم بر اساس مصرف واقعی توکن هزینه دریافت می‌کند، بنابراین خطاها و رد شدن درخواست‌ها رایگان هستند. می‌توانید هر زمان با ارز دیجیتال شارژ کنید.

Copycurl https://api.iyamau.com/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?"}]
  }'

اولین درخواست با endpoint تکمیل‌های چت

یک درخواست POST به نقطه پایانی تکمیل چت ارسال کنید تا متن تولید شود. از URL پایه ارائه شده در داشبورد استفاده کنید تا با کلاینت‌های استاندارد سازگار باشد. شناسه مدل همیشه "uncensored" است. می‌توانید پارامترهایی مانند temperature و top_p را برای کنترل خلاقیت تنظیم کنید. سیستم پیکربندی‌های JSON استاندارد را برای promptها و پیام‌ها می‌پذیرد. خطاها اعتبار پیش‌پرداخت شما را مصرف نمی‌کنند. این روش با هر SDK سازگار با OpenAI که ترجیح می‌دهید کار می‌کند.

Copyfrom openai import OpenAI

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

از SDK رسمی Node.js یا هر کتابخانه سازگار دیگری برای تعامل با API استفاده کنید. کلاینت را با URL پایه و کلید API خود پیکربندی کنید. مدل بدون سانسور به فرمت‌های پیام استاندارد پاسخ می‌دهد. می‌توانید چندین نوبت را در یک درخواست برای زمینه مکالمه ارسال کنید. شیء پاسخ شامل متن تولید شده و آمار مصرف است. استریم برای تحویل توکن در زمان واقعی پشتیبانی می‌شود. این روش برای برنامه‌های شما تأخیر کم را تضمین می‌کند. سرویس بار سنگین را در سرورهای ما مدیریت می‌کند.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.iyamau.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، قابلیت جریان‌یابی را فعال کنید. برای هر توکن تولید شده، رویدادهای ارسالی سرور (SSE) دریافت می‌کنید. این امکان نمایش فوری متن را هنگام تولید فراهم می‌کند. آخرین قطعه شامل مصرف کل توکن برای درخواست است. این ویژگی برای رابط‌های چت و برنامه‌های زنده ایده‌آل است. تأخیر ادراک‌شده را برای کاربران نهایی کاهش می‌دهد. می‌توانید اشیاء JSON را در هر رویداد 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)

پارامترها: temperature، top_p و حالت JSON

رفتار تولید را با پارامترهای استاندارد کنترل کنید. temperature را برای تنظیم تصادفی بودن تنظیم کنید، مقادیر بالاتر خلاقیت را افزایش می‌دهند. از top_p برای فیلتر کردن توزیع واژگان استفاده کنید. حالت JSON را با تنظیم response_format روی json_object برای داده‌های ساختاریافته فعال کنید. مدل uncensored به این محدودیت‌ها به طور قابل اعتماد پایبند است. همچنین می‌توانید دنباله‌های stop را مشخص کنید تا تولید را زودتر متوقف کنید. مقادیر seed برای نتایج قابل تکرار در طول تست امکان‌پذیر است. این گزینه‌ها کنترل دقیقی بر کیفیت خروجی به شما می‌دهند.

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

API محدودیت ۳۰۰ درخواست در دقیقه به ازای هر کلید را اعمال می‌کند. می‌توانید تا ۸ درخواست همزمان به صورت فعال داشته باشید. هر بدنه درخواست نباید از ۸ مگابایت تجاوز کند. اگر خطای 401 دریافت کردید، اعتبار کلید API خود را بررسی کنید. خطای 402 نشان‌دهنده اعتبار پیش‌پرداخت ناکافی است؛ برای ادامه سرویس، از طریق ارز دیجیتال شارژ کنید. خطای 429 به این معنی است که به محدودیت نرخ رسیده‌اید. چند ثانیه صبر کنید و دوباره تلاش کنید. پنجره متن از ۱۰۰,000 توکن در مجموع پشتیبانی می‌کند. این امکان پردازش گسترده اسناد یا مکالمات طولانی را فراهم می‌کند.