Documentație API pentru Dezvoltatori

URL de bază și autentificare

Începeți prin a modifica URL-ul de bază către endpoint-ul nostru dedicat și prin a treche cheia API în antetul Authorization. Nu utilizăm URL-ul standard OpenAI de bază; trebuie să direcționați SDK-ul către https://api.deepseektokenplan.com/v1. Acest lucru asigură că solicitările tale sunt direcționate prin infrastructura noastră de modele non-cenzurate, în loc de un proxy terț. ID-ul modelului specificat în corpul solicitării este "uncensored", ceea ce declanșează ponderile specifice ajustate pe serverele noastre. Autentificarea se bazează pe un simplu scheme Bearer token care funcționează cu orice bibliotecă client compatibilă OpenAI. Cheia ta este generată instantaneu la înregistrare prin Google sau email, fără a fi necesar un număr de telefon. Păstrează această cheie în siguranță, deoarece se leagă direct de soldul tău de credit preplătit.

Prima cerere

Trimiteți o cerere standard de completări chat folosind cURL pentru a-ți verifica configurația și disponibilitatea modelului. Această simplă cerere POST demonstrează cum API-ul acceptă promptul sistemului și mesajul utilizatorului. Poți ajusta parametrii temperature și top_p pentru a controla creativitatea. Răspunsul returnează textul generat împreună cu statisticile de utilizare a tokenilor pentru transparența facturării. Asigură-te că corpul cererii include identificatorul corect al modelului și cheia ta API în antet. Această metodă funcționează atât pentru generarea de text, cât și pentru apelarea de funcții. Utilizează această comandă pentru a confirma conectivitatea înainte de a integra în aplicația ta. Endpoint-ul suportă la fel de bine modurile de streaming și non-streaming.

Integrare SDK Python

Folosește biblioteca oficială Python OpenAI pentru a interacționa cu API-ul nostru configurând URL-ul de bază și cheia API. Inițializează clientul cu acreditările tale și apelează metoda de completări chat cu ID-ul modelului dorit. Această abordare îți permite să exploatezi codebase-urile existente create pentru OpenAI fără refactorări majore. Poți stream-ui răspunsurile sau să primești textul complet odată. Biblioteca gestionează automat serializarea JSON și cererile HTTP. Configurează setările de timeout și reîncercare după cum este necesar pentru cazul tău specific de utilizare. Această metodă este ideală pentru serviciile backend și pipeline-urile de procesare a datelor. Asigură-te că actualizezi URL-ul de bază pentru a indica către endpoint-ul nostru specific.

Integrare SDK Node

Integrează API în aplicațiile tale JavaScript sau TypeScript folosind pachetul Node OpenAI. Setează URL-ul de bază și cheia API în configurația clientului înainte de a face orice cereri. Această configurare îți permite să folosești metode familiare precum chat.completions.create() cu modelul nostru uncensored. Poți transmite parametri precum temperatura și secvențele de oprire pentru a ajusta output-ul. SDK-ul gestionează eficient răspunsurile în streaming pentru aplicații în timp real. Folosește această abordare pentru servere web sau instrumente de linie de comandă. Asigură-te că importi modulele necesare și configurezi corect variabilele de mediu. Această metodă suportă atât modele de solicitări sincrone, cât și asincrone.

Streaming și tokeni

Activați streaming-ul pentru a primi răspunsuri parțiale pe măsură ce sunt generate, îmbunătățind experiența utilizatorului pentru interfețele de chat. API-ul utilizează Server-Sent Events (SSE) pentru a livra tokenii în timp real. Poți urmări utilizarea tokenilor în fragmentul final al fluxului pentru o facturare precisă. Această funcție este suportată de toate SDK-urile majore și poate fi implementată manual dacă este necesar. Streaming-ul reduce latența percepută pentru răspunsurile lungi. Setează stream parametru la true în corpul solicitării. API-ul returnează statistici de utilizare în ultimul eveniment, permițându-ți să deduci suma corectă din creditul tău preplătit. Această metodă este esențială pentru aplicațiile care necesită feedback imediat.

Limite și Gestionarea Erorilor

Monitorizați limitele de rată și gestionați erorile cu grijă pentru a asigura o conexiune stabilă. API-ul permite 300 de solicitări pe minut per cheie și 8 solicitări concurente. Fiecare corp de solicitare nu trebuie să depășească 8 MB. Dacă trimiteți o cheie invalidă, veți primi o eroare 401 Unauthorized. O eroare 402 indică credit preplătit insuficient, necesitând reîncărcarea prin criptomonede. O eroare 429 înseamnă că ați depășit limita de rată; așteptați și reîncercați. Fereastra de context are 100,000 de tokeni pentru prompt și completare combinate. Ieșirea maximă este de 16,000 de tokeni, decât dacă specificați o valoare mai mică max_tokens valoare. Verifică întotdeauna codul de status și corpul răspunsului pentru mesaje de eroare detaliate.

cURL

Copycurl https://api.deepseektokenplan.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate total monthly cost for 50 million tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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