شروع سریع API Dolphin AI

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

کلید API شما هر درخواست را احراز هویت می‌کند. از URL پایه https://api.dolphinaimodels.com/v1 برای تمام نقاط پایانی. سیستم کلید معتبری را در Authorization header. بدون آن، درخواست‌ها بلافاصله شکست می‌خورند.

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

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

یک درخواست POST به /v1/chat/completionsشناسه مدل uncensored. این انتهای‌بند، ورودی متنی را می‌پذیرد و خروجی متنی برمی‌گرداند. می‌توانید پارامترهایی مانند دما و top_p را تنظیم کنید.

در اینجا یک مثال cURL پایه برای شروع آورده شده است:

Copycurl https://api.dolphinaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit elevation is 29032 feet."}]
  }'

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

از کتابخانه رسمی پایتون OpenAI استفاده کنید. آن را به URL پایه ما متصل کنید. کلید API خود را پاس دهید. ساختار کد با استفاده استاندارد OpenAI مطابقت دارد. این امر مهاجرت آسان برای پروژه‌های موجود را تضمین می‌کند.

مشتری را با این مقادیر پیکربندی کنید:

Copyfrom openai import OpenAI

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

کلاینت Node.js را به همین شکل مقداردهی اولیه کنید. URL پایه و کلید API را تنظیم کنید. SDK به‌طور خودکار سریال‌سازی را مدیریت می‌کند. این روش برای هر دو برنامه سمت سرور و سمت کلاینت کار می‌کند.

پیکربندی نمونه:

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.dolphinaimodels.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 رویدادهای ارسال سرور (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)

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

پنجره زمینه ۱۰۰,۰۰۰ توکن است. این مقدار شامل متن ورودی و پاسخ می‌شود. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است. خطاها کدهای HTTP استاندارد برمی‌گردانند. 401 نشان‌دهنده کلید نامعتبر است. 402 به معنای اعتبار ناکافی است. 429 سیگنال محدودیت نرخ است.

شما محدود به ۳۰۰ درخواست در دقیقه هستید. همزمانی به ۸ درخواست همزمان محدود شده است. حجم بدنه درخواست‌ها را زیر ۸ مگابایت نگه دارید. این محدودیت‌ها عملکرد پایدار را برای بار کاری شما تضمین می‌کنند.