Quickstart API Dolphin

URL de bază și autentificare

Cheia ta API autentifică fiecare request către endpoint-ul nostru. Utilizează URL-ul de bază HTTPS://api.apidolphin.com/v1 cu orice SDK compatibil cu OpenAI. Identificatorul modelului este "uncensored" pentru toate completările. Această configurare asigură că codul tău funcționează cu infrastructura noastră fără modificări.

Suportăm parametri standard precum temperature și top_p. Poți activa modul JSON sau function calling după nevoie. Erorile și refuzurile nu consumă creditul tău preplătit. Doar utilizarea reală de tokeni este taxată la tarifele noastre transparente.

Trimiteți Prima Solicitare

Trimiteți o completare chat de bază pentru a vă verifica conexiunea. Utilizați comanda curl de mai jos pentru a testa endpoint-ul. Înlocuiți YOUR_API_KEY cu cheia dvs. reală din panoul de control. Răspunsul returnează outputul text al modelului.

Această cerere utilizează formatul standard OpenAI. Puteți ajusta prompturile de sistem sau mesajele utilizatorului după necesități. API-ul returnează un obiect de răspuns care conține textul generat. Verificați dacă outputul se potrivește cu așteptările înainte de a scala.

Utilizare exemplu:

Copycurl https://api.apidolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert the attached JSON payload to YAML format"}]
  }'

Integrare SDK Python

Folosește biblioteca oficială Python OpenAI pentru a interacționa cu API-ul nostru. Setează URL-ul de bază și cheia API în configurația clientului. Fragmentul de cod de mai jos ilustrează un apel simplu de generare de text.

Instalează biblioteca prin pip. Apoi inițializează clientul cu acreditările tale. Apel chat.completări.create cu numele modelului "uncensored". Această abordare îți menține codul portabil între diferiți furnizori de LLM.

Exemplu de cod:

Copyfrom openai import OpenAI

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

Integrare SDK Node

SDK Node urmează același model de configurare. Inițializează clientul OpenAI cu URL-ul de bază și cheia. Trimite o cerere de completare folosind modelul "uncensored". Această metodă este ideală pentru aplicațiile server-side.

Asigură-te că gestionezi corect datele de răspuns. API-ul returnează un obiect de completare standard. Poți accesa textul generat din obiectul de răspuns. Această configurare funcționează cu Express, Fastify sau orice framework Node.js.

Exemplu de implementare:

Copyimport OpenAI from "openai";

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

Gestionați răspunsurile de streaming

Activați streaming-ul pentru livrarea tokenilor în timp real. Setează parametrul stream la true în cererea ta. API-ul returnează fragmente de date pe măsură ce sunt generate. Aceasta reduce latența percepută pentru utilizatorii finali.

Procesează fiecare fragment în logica aplicației tale. Ultimul fragment conține detaliile finale de utilizare a tokenilor. Streaming-ul funcționează cu toți parametrii acceptați. Este ideal pentru interfețele de chat și generarea live de text.

Exemplu de 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)

Limitări, Erori și Fereastră de Context

Contul tău are o fereastră de context de 100,000 de tokeni. Aceasta include atât tokenii de prompt, cât și pe cei de completare. Numărul maxim de tokeni de ieșire per solicitare este de 16,000. Dacă nu setezi max_tokens, limita este de 2,048 de tokeni.

Limitele de rată permit 300 de cereri pe minut per cheie. Poți avea 8 cereri concurente. Limita de dimensiune a corpului cererii este de 8 MB. Gestionează HTTP 401 pentru chei invalide, 402 pentru credit insuficient și 429 pentru limite de rată. Erorile sunt gratuite, așa că poți reîncerca fără costuri.