مستندات API Dolphin nsfw

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

با استفاده از URL پایه سازگار با استاندارد OpenAI متصل شوید. کلید API موجود خود را با کلیدی که از داشبورد خود ایجاد کرده‌اید جایگزین کنید. ما از هر کتابخانه مشتری که اجازه تغییر URL پایه را می‌دهد پشتیبانی می‌کنیم.

• URL پایه: https://api.dolphinnsfw.com/v1
• احراز هویت: توکن Bearer در Authorization هدر.

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

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

یک درخواست تکمیل به انتهای‌پوینت چت ارسال کنید. شناسه مدل uncensored. موضوعات بزرگسالان را بدون رد شدن مدیریت می‌کند. از ساختارهای JSON استاندارد استفاده کنید. بدنه درخواست شامل پیام‌ها و پارامترها است.

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

Copycurl https://api.dolphinnsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 500 word scene of two dolphins mating at sunset"}]
  }'

این برای هر وظیفه ساده تولید متن کار می‌کند. می‌توانید دما و top_p را تنظیم کنید. مدل سریع پاسخ می‌دهد. نیاز به تنظیمات پیچیده نیست.

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

از کتابخانه رسمی پایتون OpenAI استفاده کنید. URL پایه را به نقطه پایانی ما تنظیم کنید. کلید API خود را پاس دهید. کد دقیقاً مشابه استفاده استاندارد از GPT باقی می‌ماند. این زمان یکپارچه‌سازی را به طور قابل توجهی کاهش می‌دهد.

کتابخانه را نصب کنید. کلاینت را پیکربندی کنید. پیام‌ها را ارسال کنید. شیء پاسخ شامل متن تولیدشده است. می‌توانید از پاسخ استفاده مصرف توکن را دریافت کنید. این به ردیابی هزینه‌ها کمک می‌کند.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.dolphinnsfw.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 خود استفاده کنید. سینتکس مستندات رسمی را بازتاب می‌دهد. این امر ثبات را در سراسر زبان‌ها تضمین می‌کند.

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

Copyimport OpenAI from "openai";

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

SDK استریم را به صورت داخلی مدیریت می‌کند. همچنین می‌توانید به صورت دستی دریافت کنید. این به شما انعطاف‌پذیری می‌دهد. روشی را انتخاب کنید که با معماری شما سازگار باشد.

پخش زنده و استفاده از ابزار

جریان‌سازی را برای خروجی بلادرنگ فعال کنید. پارامتر stream را روی true تنظیم کنید. API داده‌ها را از طریق رویدادهای ارسال‌شده از سرور (SSE) ارسال می‌کند. این کار تأخیر ادراک‌شده را کاهش می‌دهد. کاربران متن را همان‌طور که تولید می‌شود مشاهده می‌کنند.

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

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)

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

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

پنجره زمینه ۱۰۰,۰۰۰ توکن است. این مقدار شامل متن ورودی و پاسخ می‌شود. حداکثر خروجی ۱۶,۰۰۰ توکن است. اندازه بدنه درخواست ۸ MB است. محدودیت نرخ ۳۰۰ درخواست در دقیقه است. همزمانی ۸ درخواست برای هر کلید است.

خطاها را به شیوه‌ای مناسب مدیریت کنید. خطای ۴۰۱ یعنی کلید نامعتبر است. خطای ۴۰۲ یعنی اعتباری وجود ندارد. خطای ۴۲۹ یعنی محدودیت نرخ اعمال شده است. این‌ها کدهای HTTP استاندارد هستند. کلاینت شما باید مجددا تلاش کند یا کاربر را مطلع کند.

قیمت‌گذاری شفاف است. توکن‌های ورودی به ازای هر میلیون $0.15 هزینه دارند. توکن‌های خروجی به ازای هر میلیون $0.50 هزینه دارند. خطاها اعتبار مصرف نمی‌کنند. این از بودجه شما محافظت می‌کند. اعتبار پیش‌پرداخت هرگز منقضی نمی‌شود. از اعتبار آزمایشی برای تست اولیه استفاده کنید.