Documentație API Dolphin nsfw

URL de bază și autentificare

Conectează-te folosind URL-ul de bază compatibil cu OpenAI. Înlocuiește-ți cheia API existentă cu cea generată din panoul de control. Acceptăm orice bibliotecă client care acceptă o suprascriere a URL-ului de bază.

• URL de bază: https://api.dolphinnsfw.com/v1
• Autentificare: token Bearer în Authorization header.

Autentificarea este instantanee. Cheia funcționează imediat după generare. Nu este nevoie de număr de telefon. Înscrieți-vă cu Google sau email. Panoul de control afișează cheia o dată. Erorile sunt gratuite. Refuzurile nu costă nimic. Acest lucru asigură că plătiți doar pentru tokenurile reale.

Prima cerere

Trimiteți o cerere de completare către endpoint-ul chat. ID-ul modelului este uncensored. It handles adult themes without refusal. Use standard JSON structures. The request body includes messages and parameters.

Iată o comandă curl simplă pentru a testa conexiunea. Trimite un prompt scurt. Răspunsul returnează text generat. Verificați codul de stare pentru succes.

Copycurl https://api.dolphinnsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 500 word scene of two dolphins mating at sunset"}]
  }'

Acest lucru funcționează pentru orice sarcină simplă de generare de text. Poți ajusta temperatura și top_p. Modelul răspunde rapid. Nu este nevoie de configurări complexe.

Integrare SDK Python

Folosește biblioteca oficială Python OpenAI. Setează URL-ul de bază către endpoint-ul nostru. Transmite cheia ta API. Codul rămâne identic cu utilizarea standard GPT. Acest lucru reduce semnificativ timpul de integrare.

Instalează biblioteca. Configurează clientul. Trimite mesaje. Obiectul de răspuns conține textul generat. Poți accesa utilizarea tokenilor din răspuns. Acest lucru te ajută să urmărești costurile.

Copyfrom openai import OpenAI

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

Biblioteca gestionează reîncercările. Gestionează automat anteturile. Primești date structurate. Această abordare funcționează atât pentru scripturi locale, cât și pentru aplicații web.

Integrare SDK Node

Inițializați clientul Node.js. Indică-l către URL-ul nostru de bază. Folosește cheia ta API. Sintaxa imită documentația oficială. Acest lucru asigură consistența între limbaje.

Creați o instanță de client. Defineți modelul. Trimiteți un prompt. Răspunsul conține conținutul. Puteți analiza JSON ușor. Acest lucru funcționează bine pentru randarea pe server. Se potrivește și cu funcțiile serverless.

Copyimport OpenAI from "openai";

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

SDK-ul gestionează streaming-ul intern. Poți, de asemenea, să preiei manual. Acest lucru îți oferă flexibilitate. Alege metoda care se potrivește arhitecturii tale.

Streaming și utilizarea instrumentelor

Activați streaming-ul pentru output în timp real. Setează parametrul stream la true. API-ul trimite fragmente prin Server-Sent Events. Aceasta reduce latența percepută. Utilizatorii văd textul pe măsură ce este generat.

Funcționarea prin apeluri de funcții este suportată. Definiți instrumente în cerere. Modelul returnează apeluri de instrumente. Le executați. Apoi trimiteți rezultatele înapoi. Acest lucru permite fluxuri de lucru complexe. Modul JSON este, de asemenea, disponibil. Set response_format pentru {"type": "json_object"}. Acest lucru asigură formate de ieșire stricte.

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)

Streaming-ul funcționează cu toți parametrii. Temperature și top_p se aplică pe fragment. Acest lucru permite un control fin. Poți opri generarea devreme. Ultimul fragment conține utilizarea totală a tokenilor.

Limitări, Erori și Context

Fereastra de context are 100.000 de tokeni. Aceasta include promptul și completarea. Output-ul maxim este de 16.000 de tokeni. Dimensiunea corpului solicitării este de 8 MB. Limitele de rată sunt de 300 de solicitări pe minut. Concurența este de 8 solicitări per cheie.

Gestionați erorile cu grijă. O eroare 401 înseamnă o cheie nevalidă. O eroare 402 indică lipsa de credit. O eroare 429 semnalează limitarea ratei. Acestea sunt coduri HTTP standard. Clientul tău ar trebui să repornească sau să informeze utilizatorul.

Tarifarea este transparentă. Tokenii de intrare costă $0.15 per milion. Tokenii de ieșire costă $0.50 per milion. Erorile nu consumă credit. Acest lucru îți protejează bugetul. Creditul preplătit nu expiră. Folosește creditul de probă pentru a testa mai întâi.