شروع سریع API مدل‌های دلفین

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

API مدل‌های Dolphin یک سرویس سازگار با OpenAI است. URL پایه خود را به https://api.dolphinmodelos.com/v1 و کلید API خود را در Authorization header. از شناسه مدل uncensored برای استنتاج تنظیم کنید. این سازگاری با SDKهای استاندارد را بدون منطق مسیریابی سفارشی تضمین می‌کند.

Copycurl https://api.dolphinmodelos.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List endpoints for wallet connection via crypto gateway"}]
  }'

ارسال یک درخواست تکمیل (Completion Request)

یک درخواست متنی ساده ارسال کنید تا پاسخ تولید شود. API پارامترهای استاندارد مانند temperature و top_p. خروجی متنی خالص بدون پوشش‌های اضافی دریافت می‌کنید. این رویکرد مستقیم نیاز به منطق تجزیه خاص مدل را از بین می‌برد.

Copyfrom openai import OpenAI

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

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

تولید توکن‌ها را با استفاده از رویدادهای Server-Sent به صورت بلادرنگ فعال کنید. قطعه نهایی شامل آمار کامل مصرف توکن برای دقت صورتحساب است. استریمینگ تأخیر ادراک‌شده را برای خروجی‌های طولانی کاهش می‌دهد. این روش برای برنامه‌های تعاملی که نیاز به بازخورد فوری دارند ایده‌آل است.

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)

فراخوانی تابع و ابزارها

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

حالت JSON برای خروجی ساختاریافته

مدل را مجبور به بازگشت JSON معتبر با استفاده از response_format: {"type": "json_object"}. این اطمینان حاصل می‌کند که ساختارهای داده‌ای یکسان برای پردازش‌های بعدی وجود دارد. ایده‌آل برای پاسخ‌های API یا درج‌های پایگاه داده. مدل به طرحواره پایبند است و متن مکالمه‌ای اضافی اضافه نمی‌کند.

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

پنجره زمینه ۱۰۰,۰۰۰ توکن به‌طور کلی است. خطاهایی مانند 401 برای کلیدهای نامعتبر یا 429 برای محدودیت نرخ را مدیریت کنید. API محدودیت ۳۰۰ درخواست در دقیقه را اعمال می‌کند. از این کدها برای مدیریت بازپخش‌ها به‌طور کارآمد استفاده کنید. خطاها و رد شدن‌ها اعتبار مصرف نمی‌کنند و از موجودی شما در طول فازهای آزمایش محافظت می‌کنند.

Node.js

Copyimport OpenAI from "openai";

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