راهنمای یکپارچه‌سازی Dolphin AI

پیش‌نیازها: راه‌اندازی SDK و کلید API

کتابخانه رسمی SDK را برای زبان خود نصب کنید. یک حساب کاربری از طریق ایمیل یا ورود با گویش در داشبورد ما ایجاد کنید. کلید API خود را بلافاصله تولید کنید. نیازی به شماره تلفن نیست. کلید یک‌بار روی صفحه نمایش داده می‌شود. آن را به‌طور ایمن ذخیره کنید. ما روش پرداخت شما را ذخیره نمی‌کنیم. شارژ با ارزهای دیجیتال با USDT یا USDC انجام می‌شود. اعتبار هرگز منقضی نمی‌شود. خطاها هزینه‌ای ندارند. شما فقط بابت توکن‌های مصرفی پرداخت می‌کنید.

پیکربندی URL پایه و هدرها

مشتری خود را به URL پایه ما هدایت کنید. هدر احراز هویت را با کلید خود تنظیم کنید. از شناسه مدل "uncensored" استفاده کنید. این تضمین می‌کند که به مدل بدون سانسور ما دسترسی پیدا می‌کنید. این GPT یا Claude نیست. نقطه پایانی تکمیل‌های چت استاندارد را می‌پذیرد. هدرها باید شامل کلید API باشند. سایر فیلدها اختیاری هستند. دما و top_p همانطور که انتظار می‌رود کار می‌کنند. ما از پارامترهای استاندارد OpenAI پشتیبانی می‌کنیم. برای محدودیت‌ها به مستندات مراجعه کنید.

Copycurl https://api.dolphinllmmodel.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the max token limit for this endpoint?"}]
  }'

ارسال اولین درخواست تکمیل چت شما

یک درخواست POST با پیام‌های خود ارسال کنید. prompt سیستمی را برای زمینه شامل کنید. محتوای پیام کاربر را تعریف کنید. مدل یک پاسخ متنی برمی‌گرداند. می‌توانید حداکثر توکن را مشخص کنید. خروجی پیش‌فرض 2,048 توکن است. اگر نیاز بود محدودیت‌های بالاتری تنظیم کنید. پنجره زمینه 100,000 توکن است. ورودی و خروجی این محدودیت را به اشتراک می‌گذارند. مطمئن شوید prompt شما جا می‌شود. خطاها کدهای JSON استاندارد را برمی‌گردانند. بدنه پاسخ را برای خطاها بررسی کنید.

Copyfrom openai import OpenAI

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

فعال‌سازی پخش زنده برای پاسخ‌های بلادرنگ

streaming را روی true در درخواست خود تنظیم کنید. API قطعات را از طریق SSE بازمی‌گرداند. هر قطعه شامل متن جزئی است. توکن‌ها را هنگام دریافت پردازش کنید. این کار تأخیر ادراک‌شده را کاهش می‌دهد. شما بازخورد فوری دریافت می‌کنید. آخرین قطعه شامل استفاده‌ی توکن است. استفاده را برای ردیابی هزینه‌ها پایش کنید. استریم با تمام پارامترها کار می‌کند. ابزارها و حالت JSON نیز استریم می‌شوند. افت اتصال را به‌خوبی مدیریت کنید. اگر استریم شکست خورد، دوباره متصل شوید.

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 ارسال کنید. مدل فراخوانی‌های ابزار را برمی‌گرداند. استدلال‌ها را برای اجرا تجزیه کنید. نتایج را مجدداً به مدل ارسال کنید. این اجازه می‌دهد جریان‌های کاری پیچیده ایجاد شود. پشتیبانی از فرمت استاندارد OpenAI است. انتخاب ابزار می‌تواند خودکار باشد. می‌توانید ابزارهای خاصی را مجبور کنید. حالت JSON نیز با ابزارها کار می‌کند. مطمئن شوید طرحواره شما معتبر است. طرحواره‌های نامعتبر باعث خطا می‌شوند. ابتدا با توابع ساده تست کنید.

Copyimport OpenAI from "openai";

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

مدیریت محدودیت نرخ و خطاها

ما 300 درخواست در دقیقه اعمال می‌کنیم. درخواست‌های همزمان به هشت محدود شده‌اند. بدنه‌های درخواست باید زیر 8 مگابایت باشند. خطای 401 به معنای کلید نامعتبر است. هدر احراز هویت خود را بررسی کنید. خطای 402 نشان‌دهنده عدم موجودی اعتبار است. برای ادامه با ارز دیجیتال شارژ کنید. 424 به معنای رسیدن به حد نرخ است. صبر کنید و با تأخیر بازگشتی مجدداً تلاش کنید. خطاها رایگان هستند. فقط توکن‌های تکمیل‌شده اعتبار مصرف می‌کنند. زمینه 100,000 توکن در مجموع است.