Documentație API Compatibil cu OpenAI

Autentificare și Configurare URL de Bază

Cheia ta API autentifică fiecare request către serverele noastre. Pur și simplu înregistrează-te cu Google sau o adresă de email și copiază cheia din panoul tău. Lipește-o în variabila de mediu ca DEEPSEEK_API_KEY și direcționați clientul către https://api.keyapideepseek.com/v1. Acest URL de bază funcționează cu orice bibliotecă standard compatibilă OpenAI.

Copycurl https://api.keyapideepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
  }'

Poți verifica configurarea listând modelele disponibile. Răspunsul confirmă că cheia ta este validă și activă. Acest pas asigură că integrarea ta pointează către endpoint-ul corect nefiltrat înainte de a trimite prompturi.

Endpoint Completări Chat

The POST /v1/chat/completions endpoint acceptă promptul tău și returnează răspunsul modelului. Trimite un corp JSON care conține mesaje, instrucțiunile de sistem și parametri precum temperatura. ID-ul modelului este întotdeauna uncensored. Acest model unic gestionează toate nevoile tale de generare text fără complexitatea rutării.

Copyfrom openai import OpenAI

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

SDK-ul Python gestionează automat cererile HTTP. Îi transmiți cheia și URL-ul de bază constructorului clientului. Restul codului imită modelele standard OpenAI. Acest lucru asigură că poți schimba furnizorii ulterior fără a rescrie logica întregii aplicații.

Răspunsuri în streaming și consumul de tokeni

Activați streaming-ul setând stream: true în cererea ta. API-ul returnează un flux de fragmente de Evenimente Trimise de Server (SSE). Fiecare fragment conține text parțial și statistici de utilizare. Ultimul fragment include numărul total de tokeni pentru cerere.

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 reduce latența percepută pentru utilizatori. Poți afișa tokenii pe măsură ce ajung. Acest lucru este crucial pentru generarea de text lung sau pentru interfețele de chat interactive. Monitorizează utilizarea tokenilor din fragmentul final pentru a urmări consumul creditului preplătit cu precizie.

Mod JSON și Apelarea Funcțiilor

Imposibilitarea ieșirii structurate prin setarea response_format pentru {"type": "json_object"}. Modelul va returna JSON în loc de text liber. Acest lucru este ideal pentru integrări API sau sarcini de extragere a datelor. Poți defini, de asemenea, definiții de funcții în promptul tău pentru utilizarea instrumentelor.

Modelul suportă tool_choice parametri. Poți forța funcții specifice sau lăsa modelul să decidă. Această flexibilitate îți permite să construiești agenți complecși. Asigură-te că schemele funcțiilor sunt strict tipizate pentru a evita erorile de parsare în codul client.

Limite de rată și concurență

Fiecare cheie API este limitată la 300 de cereri pe minut. Puteți avea până la 8 cereri concurente active simultan. Dimensiunea maximă a corpului cererii este de 8 MB. Aceste limite previn abuzul și asigură o performanță stabilă pentru toți utilizatorii. Depășirea acestor limite returnează un eroare 429.

Implementați backoff exponențial în codul clientului. Reîncercați cererile eșuate după o scurtă întârziere. Acest lucru gestionează cu grijă problemele tranzitorii de rețea. Creditul preplătit este facturat doar pentru finalizările reușite, nu și pentru reîncercările limitate de rată.

Gestionarea erorilor și refuzurile

Eroarea 401 înseamnă că cheia ta este invalidă sau expirată. O eroare 402 indică credit preplătit insuficient. O eroare 429 semnalează că ai atins limita de rată. Modelul refuză cererile care conțin conținut sexual implicând minori. Tot celălalt conținut adult legal este permis.

Verificați corpul răspunsului de eroare pentru mesaje detaliate. Logați aceste erori pentru a depana problemele de integrare. Creditul dvs. nu este consumat pentru solicitările eșuate. Acest model de facturare transparent vă ajută să preziceți costurile cu precizie, fără taxe ascunse.

Node.js

Copyimport OpenAI from "openai";

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