مستندات API Dolphin ai

تنظیم احراز هویت و URL پایه

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

• URL پایه: HTTPS://api.aidolphin.cc/v1
• هدر: Authorization: Bearer YOUR_API_KEY

Copycurl https://api.aidolphin.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five open source inference engines"}]
  }'

ارسال یک درخواست تکمیل چت ساده (basic chat completion request)

پیکربندی‌های JSON استاندارد را به انتهای تکمیل‌های چت ارسال کنید. شناسه مدل همیشه "uncensored" است تا خروجی متنی یکسان باشد. توکن‌های ورودی $0.15 به ازای هر میلیون، در حالی که توکن‌های خروجی $0.50 به ازای هر میلیون هزینه دارند.

• مدل: uncensored
• حداکثر خروجی: ۱۶,۰۰۰ توکن

Copyfrom openai import OpenAI

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

پاسخ‌های جریان‌دار با رویدادهای ارسال‌شده سرور

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

Copyimport OpenAI from "openai";

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

فعال‌سازی حالت JSON برای داده‌های ساختاریافته

استفاده response_format تنظیم شده روی {"type": "json_object"} برای اجبار به خروجی ساختاریافته. این تضمین می‌کند که مدل JSON معتبر را بدون قالب‌بندی اضافی markdown برمی‌گرداند. فراخوانی تابع و تعریف‌های ابزار نیز به این ساختار JSON متکی هستند.

پیکربندی دما، top_p و دنباله‌های توقف

پارامترهای نمونه‌گیری را برای کنترل تصادفی‌سازی و طول خروجی تنظیم کنید. تنظیم temperature برای خلاقیت، top_p برای نمونه‌گیری هسته، و stop توالی‌ها برای کوتاه کردن زودهنگام خروجی. جریمه‌های حضور و تکرار به کاهش عبارت‌های تکراری کمک می‌کنند.

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)

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

هر کلید API اجازه ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان را می‌دهد. حداکثر اندازه بدنه درخواست ۸ مگابایت است. خطاها و ردها اعتبار پیش‌پرداخت شما را مصرف نمی‌کنند. اگر محدودیت‌ها را تجاوز کنید، کد وضعیت ۴۲۹ دریافت می‌کنید.