شروع سریع API Dolphin AI

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

ابتدا URL پایه و کلید API را در پیکربندی کلاینت خود تنظیم کنید. تمام درخواست‌ها از طریق Authorization هدر با استفاده از کلید منحصر‌به‌فرد شما. خدمات ما به عنوان یک ارائه‌دهنده مستقل برای openrouter dolphin AI مدل است، به این معنی که برای استفاده از این نقطه پایانی نیازی به حساب کاربری در OpenRouter ندارید. به سادگی کلید خود را از داشبورد دریافت کرده و آن را در متغیرهای محیطی خود قرار دهید.

• URL پایه: https://api.openrouterdolphinai.com/v1
• هدر: Authorization: Bearer YOUR_API_KEY

این پیکربندی با هر SDK استاندارد OpenAI کار می‌کند زیرا ما ساختار نقطه پایانی دقیق آن‌ها را تقلید می‌کنیم. شما فقط با نقطه پایانی تکمیل‌های چت تعامل خواهید داشت، یکپارچه‌سازی شما را ساده و متمرکز بر تولید متن نگه می‌دارد.

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

ارسان اولین پیام برای تولید متن با استفاده از POST روش. شناسه مدل همیشه uncensored, که تضمین می‌کند نسخه خاص بدون سانسور که برای گفتگوی نامحدود بهینه‌سازی شده است را دریافت کنید. نیازی به مشخص کردن پارامترهای پیچیده مسیریابی ندارید زیرا ما این مدل تک را مستقیماً میزبانی می‌کنیم.

از دستور curl زیر برای آزمایش اتصال خود فوراً استفاده کنید:

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

اگر پاسخ JSON با محتوا دریافت کردید، کلید شما فعال است و اعتبار به درستی کسر می‌شود. خطاهایی مانند 401 نشان‌دهنده کلید نامعتبر است، در حالی که 402 به این معنی است که باید از طریق ارز دیجیتال شارژ کنید. این روش مستقیم از نوسانات روترهای چندمدلی جلوگیری می‌کند.

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

به سرعت با استفاده از کتابخانه رسمی Python OpenAI با اشاره آن به URL پایه ما ادغام کنید. این به شما اجازه می‌دهد از روش‌های آشنا مانند chat.completions.create() بدون بازنویسی منطق کلی. کتابخانه سریال‌سازی را به‌طور خودکار مدیریت می‌کند، بنابراین می‌توانید بر طراحی پرامپت تمرکز کنید تا جزئیات HTTP.

مشتری را با URL پایه و کلید خود پیکربندی کنید:

Copyfrom openai import OpenAI

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

به یاد داشته باشید که پنجره زمینه ما ۱۰۰,۰۰۰ توکن است، بنابراین می‌توانید تاریخچه مکالمه قابل توجهی را ارسال کنید. SDK توکن‌سازی و ارسال را به‌طور کارآمد مدیریت می‌کند، تضمین می‌کند که پرامپت‌های شما بدون اضافه‌بار یا خطاهای قالب‌بندی نادرست به مدل می‌رسند.

استفاده Node SDK

توسعه‌دهندگان Node می‌توانند نتایج مشابه را با استفاده از openai پکیج npm. درست مانند نسخه Python، باید URL پایه پیش‌فرض را بازنویسی کنید تا به سرورهای اختصاصی ما اشاره کند. این اطمینان حاصل می‌کند که درخواست‌های شما مستقیماً به مدل بدون سانسور ارسال می‌شوند و با محدودیت‌های نرخ یا تأخیرهای مسیریابی شخص ثالث مواجه نمی‌شوند.

کلاینت را با نقطه پایانی صحیح مقداردهی دهید:

Copyimport OpenAI from "openai";

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

این الگو برای هر دو تماس‌های سینکرون و الگوهای async/await کار می‌کند. می‌توانید پاسخ‌ها را استریم کنید یا حالت JSON را مستقیماً در همان فراخوانی تابع درخواست دهید که به شما انعطاف‌پذیری برای معماری‌های برنامه مختلف بدون تغییر تنظیمات احراز هویت اصلی می‌دهد.

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

فعال‌سازی تولید متن بلادرنگ با تنظیم 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 ما یک پنجره متن 100,000 توکن را برای هر درخواست اعمال می‌کند، که ترکیبی از پرامپت و تکمیل است. اگر از محدودیت خروجی 16,000 توکن تجاوز کنید، تولید متوقف می‌شود، بنابراین تنظیم max_tokens متناسب با کنترل هزینه‌ها.

کدهای وضعیت HTTP رایج شامل 401 برای کلیدهای نامعتبر، 402 برای اعتبار ناکافی و 429 برای محدودیت نرخ هستند. شما به 300 درخواست در دقیقه به ازای هر کلید محدود هستید. این محدودیت‌ها استفاده عادلانه را برای همه کاربران تضمین می‌کنند. از 429 خطا برای پیاده‌سازی بازگشت نمایی (exponential backoff) در کد کلاینت خود، تا عملکرد روان در دوره‌های ترافیک بالا تضمین شود.