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

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

با استفاده از حساب Google یا ایمیل خود ثبت‌نام کنید تا کلید API را فوراً دریافت کنید. برای ارتباط با نقطه پایانی، به SDK رسمی زبان مورد نظر خود نیاز دارید. کلید هر درخواستی که ارسال می‌کنید را احراز هویت می‌کند.

۲. پیکربندی Base URL خود

آدرس پایه را به HTTPS://api.dolphinmodelsai.com/v1 در پیکربندی کلاینت خود تنظیم کنید. این URL درخواست‌های شما را به سرورهای استنتاج uncensored ما هدایت می‌کند. مطمئن شوید که کلید API خود را در هدر authorization ارسال می‌کنید. نقطه پایانی از الگوهای استاندارد OpenAI برای سازگاری پیروی می‌کند.

Copyimport OpenAI from "openai";

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

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

درخواست POST را به /v1/chat/completions ارسال کنید و شناسه مدل را روی "uncensored" تنظیم کنید. تاریخچه پیام‌های خود را در آرایه messages قرار دهید. API یک پاسخ متنی بدون رد محتوا برای استفاده بزرگسالان قانونی برمی‌گرداند. می‌توانید پارامترهایی مانند دما را برای کنترل تصادفی‌بودن تنظیم کنید.

Copycurl https://api.dolphinmodelsai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate the time complexity of this sorting algorithm"}]
  }'

۴. فعال‌سازی استریم و مدیریت مصرف توکن

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

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)

۵. استفاده از حالت JSON برای خروجی ساختاریافته

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

۶. پیاده‌سازی فراخوانی تابع (ابزارها)

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

۸. درک محدودیت‌های نرخ و پارامترها

هر کلید API محدود به ۳۰۰ درخواست در دقیقه است. می‌توانید در هر زمان ۸ درخواست همزمان داشته باشید. پنجره زمینه تا 100,000 توکن برای ورودی و خروجی ترکیبی پشتیبانی می‌کند. درخواست‌هایی که از این محدودیت‌ها تجاوز کنند، کد خطای 429 دریافت می‌کنند. خطاهای اعتبار کد وضعیت 402 را برمی‌گردانند.

پایتون

Copyfrom openai import OpenAI

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