راهنمای شروع سریع چت Dolphin ai

نصب و پیکربندی SDK &

ابتدا کتابخانه کلاینت رسمی را برای زبان خود نصب کنید. API ما از استاندارد OpenAI ساختار بسته، بنابراین احتمالاً قبلاً آن را دارید. URL پایه را به نقطه پایانی ما اشاره دهید و کلید API خود را ارائه دهید.

از روش متغیر محیطی برای حفظ امنیت اعتبارنامه‌ها استفاده کنید. URL پایه HTTPS://api.dolphinaichat.com/v1 است. این با هر کلاینت سازگار با OpenAI کار می‌کند با تغییر base_url و کلید API.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

یک درخواست تکمیل چت ساده برای آزمایش اتصال ارسال کنید. از شناسه مدل "uncensored" برای مدل وزن‌باز تنظیم‌شده برای پاسخ‌های بدون محدودیت استفاده کنید.

Copycurl https://api.dolphinaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit the daily server load statistics for the last week"}]
  }'

مدیریت پاسخ‌های جریان‌سازی (SSE)

پخش زنده را فعال کنید تا توکن‌ها به صورت بلادرنگ دریافت شوند. 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)

درک پنجره‌های متن و توکن‌ها

مدل از پنجره زمینه ۱۰۰,۰۰۰ توکنی برای ترکیب prompt و completion پشتیبانی می‌کند. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است. max_tokens پیش‌فرض ۲,۰۴۸ است اگر تنظیم نشود. قیمت‌گذاری ۰.۱۵$ برای هر ۱M توکن ورودی و ۰.۵۰$ برای هر ۱M توکن خروجی است.

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

خطاهای HTTP استاندارد را به‌خوبی مدیریت کنید. 401 نشان‌دهنده کلید نامعتبر است. 402 به معنای نداشتن اعتبار است. 429 نشان‌دهنده محدودیت نرخ است. محدودیت‌ها 300 درخواست در دقیقه به ازای هر کلید و 8 درخواست همزمان است. حداکثر اندازه بدنه درخواست 8 مگابایت است.

پیکربندی حالت JSON و فراخوانی تابع

استفاده response_format: {"type": "json_object"} برای خروجی‌های ساختاریافته. فراخوانی تابع را با tools و tool_choice. پارامترهایی مانند temperature و top_p به طور کامل پشتیبانی می‌شوند.