Dolphin API Quickstart Guide

Autentificare: Tokeni Bearer

Autentificarea necesită un token Bearer trimis în Authorization header.

Obțineți cheia din panoul de control sau utilizați creditul de probă. Fiecare solicitare trebuie să includă acest antet pentru a dovedi identitatea.

Păstrează cheia securizată. Partajeaz-o doar cu servicii de încredere.

Punctul final /v1/chat/completions

Acest endpoint procesează input text și returnează output text.

Trimiteți cereri către https://api.whatisdolphin.com/v1 cu ID-ul modelului și mesajele.

Folosiți această structură pentru interacțiuni de bază.

Răspunsuri în streaming cu SSE

Streaming permite livrarea tokenilor în timp real prin Server-Sent Events.

Setează stream că true în payload-ul solicitării tale.

Analizați fragmentele pe măsură ce ajung pentru a construi un output continuu.

Apelarea funcțiilor și modul JSON

Apelarea de funcții permite modelelor să execute instrumente pe baza instrucțiunilor tale.

Folosește modul JSON pentru a impune conformitatea strictă cu schema pentru date structurate.

Definește instrumente în cerere pentru a ghida comportamentul modelului.

Fereastră de Context și Limite de Token-uri

Fereastra de context suportă un total de 100.000 de tokeni.

Limitele ieșirii variază: setați max_tokens pentru control, altfel se utilizează implicit 2,048 tokeni.

Gestionează lungimea intrării pentru a rămâne în limite pentru performanță optimă.

Limite de rată și gestionarea erorilor

Limitele de rată permit 300 de cereri pe minut per cheie.

Gestionează erorile 401 pentru chei invalide și 429 pentru limitele de rată.

Monitorizați utilizarea pentru a evita întreruperile serviciului în timpul volumului mare.

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);

Streaming

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)