دليل البدء السريع لواجهة Dolphin API

المصادقة: رموز الحامل

المصادقة تتطلب رمز حامل يُرسل في Authorization رأس.

احصل على المفتاح من لوحة التحكم أو استخدم رصيد التجربة. يجب أن يتضمن كل طلب هذا الرأس (header) لإثبات الهوية.

احتفظ بالمفتاح آمنًا. شاركه فقط مع الخدمات الموثوقة.

نقطة نهاية /v1/chat/completions

تعالج هذه نقطة النهاية مدخلات النص وتعيد مخرجات النص.

أرسل طلبات إلى https://api.whatisdolphin.com/v1 مع معرف النموذج الخاص بك والرسائل.

استخدم هذا الهيكل للتفاعلات الأساسية.

استجابات البث مع SSE

يتيح البث تسليم الرموز في الوقت الفعلي عبر أحداث الإرسال من الخادم.

تعيين stream إلى true في حمولة طلبك.

قم بتحليل الشرائح عند وصولها لبناء مخرج مستمر.

استدعاء الوظائف ووضع JSON

يسمح استدعاء الوظائف للنماذج بتنفيذ الأدوات بناءً على تعليماتك.

استخدم وضع JSON لفرض الامتثال الصارم للمخطط للبيانات المهيكلة.

عرّف الأدوات في الطلب لتوجيه سلوك النموذج.

نافذة السياق وحدود الرموز المميزة

تدعم نافذة السياق إجمالي 100,000 رمز.

تختلف حدود المخرجات: اضبط max_tokens للتحكم، وإلا فافتراضي إلى 2,048 رمزًا مميزًا.

إدارة طول الإدخال للبقاء ضمن الحدود لأداء أمثل.

حدود معدل الطلبات ومعالجة الأخطاء

تسمح حدود معدل الطلبات بـ 300 طلب في الدقيقة لكل مفتاح.

عالج أخطاء 401 للمفاتيح غير الصالحة و429 لحدود معدل الطلبات.

راقب الاستخدام لتجنب انقطاع الخدمة أثناء أحجام البيانات العالية.

cURL

Copycurl https://api.whatisdolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Define what a dolphin is in two lines."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

التدفق

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)