شروع سریع API Dolphin

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

کلید API شما هر درخواستی را به endpoint ما احراز هویت می‌کند. از URL پایه HTTPS://api.apidolphin.com/v1 با هر SDK سازگار با OpenAI استفاده کنید. شناسه مدل "uncensored" برای تمام تکمیل‌ها است. این پیکربندی تضمین می‌کند که کد شما بدون تغییر با زیرساخت ما کار می‌کند.

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

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

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

این درخواست از قالب استاندارد OpenAI استفاده می‌کند. می‌توانید prompt سیستم یا پیام‌های کاربر را مطابق نیاز تنظیم کنید. API یک شیء پاسخ شامل متن تولید شده برمی‌گرداند. پیش از مقیاس‌دهی، خروجی را با انتظارات خود تطبیق دهید.

استفاده نمونه:

Copycurl https://api.apidolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert the attached JSON payload to YAML format"}]
  }'

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

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

کتابخانه را از طریق pip نصب کنید. سپس کلاینت را با اعتبارنامه‌های خود مقداردهی اولیه کنید. chat.completions.create را با نام مدل "uncensored" فراخوانی کنید. این رویکرد کد شما را در ارائه‌دهندگان مختلف LLM قابل حمل نگه می‌دارد.

نمونه کد:

Copyfrom openai import OpenAI

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

SDK Node الگوی پیکربندی یکسانی را دنبال می‌کند. کلاینت OpenAI را با URL پایه و کلید خود مقداردهی اولیه کنید. یک درخواست تکمیل را با استفاده از مدل "uncensored" ارسال کنید. این روش برای برنامه‌های سمت سرور ایده‌آل است.

اطمینان حاصل کنید که داده‌های پاسخ را به درستی مدیریت می‌کنید. API یک شیء تکمیل استاندارد برمی‌گرداند. می‌توانید متن تولید شده را از شیء پاسخ دسترسی پیدا کنید. این پیکربندی با Express، Fastify یا هر چارچوب Node.js دیگری کار می‌کند.

مثال پیاده‌سازی:

Copyimport OpenAI from "openai";

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

مدیریت پاسخ‌های پخش زنده

جریان‌سازی را برای تحویل بلادرنگ توکن فعال کنید. پارامتر 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)

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

حساب شما دارای پنجره زمینه 100,000 توکنی است. این شامل توکن‌های پرامپت و تکمیل می‌شود. حداکثر خروجی در هر درخواست 16,000 توکن است. اگر max_tokens را تنظیم نکنید، محدودیت 2,048 توکن است.

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