Dokumentace API kompatibilní s OpenAI

Nastavení ověření a základní URL

Váš klíč API autentizuje každý požadavek na naše servery. Stačí se zaregistrovat přes Google nebo e-mailovou adresu a zkopírovat klíč z vašeho panelu. Vložte jej do proměnné prostředí jako DEEPSEEK_API_KEY a nasměrovat klienta na https://api.keyapideepseek.com/v1. Tato základní URL funguje s jakoukoli standardní knihovnou kompatibilní s 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"}]
  }'

Nastavení ověříte vyjmenováním dostupných modelů. Odpověď potvrdí, že váš klíč je platný a aktivní. Tento krok zajišťuje, že vaše integrace ukazuje na správný endpoint bez cenzury, než začnete odesílat prompty.

Endpoint Chat Completions

The POST /v1/chat/completions endpoint přijme váš prompt a vrátí odpověď modelu. Pošlete JSON tělo obsahující zprávy, pokyny pro systém a parametry jako teplotu. ID modelu je vždy uncensored. Tento jediný model zpracovává veškeré vaše potřeby generování textu bez složitosti směrování.

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 pro Python automaticky zpracovává HTTP požadavky. Předáte svůj klíč a základní URL konstruktoru klienta. Zbytek kódu odpovídá standardním vzorům OpenAI. To zajišťuje, že můžete později přepnout poskytovatele bez přepisování celé logiky aplikace.

Streamované odpovědi a spotřeba tokenů

Povolte streamování nastavením stream: true ve vaší žádosti. API vrací stream Server-Sent Events (SSE) bloků. Každý blok obsahuje částečný text a statistiky využití. Poslední blok zahrnuje celkové počty tokenů pro žádost.

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)

Streamování snižuje vnímanou latenci pro uživatele. Můžete zobrazovat tokeny, jak přicházejí. To je zásadní pro generování dlouhého textu nebo interaktivní chatová rozhraní. Sledujte spotřebu tokenů v poslední části streamu pro přesné sledování čerpání předplaceného kreditu.

Režim JSON a volání funkcí

Vynucujte strukturovaný výstup nastavením response_format na {"type": "json_object"}. Model vrací platný JSON místo volného textu. To je ideální pro integrace API nebo úlohy extrakce dat. Do svého zadání můžete také definice funkcí pro použití nástrojů.

Model podporuje tool_choice parametrů. Můžete vynutit specifické funkce nebo nechat model, aby se rozhodl sám. Tato flexibilita vám umožňuje vytvářet složité agenty. Ujistěte se, že schémata vašich funkcí jsou striktně typována, aby se předešlo chybám při parsování v kódu vašeho klienta.

Limity rychlosti a souběžnost

Každý API klíč je omezen na 300 požadavků za minutu. Můžete mít aktivních až 8 souběžných požadavků. Maximální velikost těla požadavku je 8 MB. Tato omezení zabraňují zneužití a zajišťují stabilní výkon pro všechny uživatele. Při překročení těchto limitů vrátí server chybu 429.

Implementujte exponenciální zpomalování ve svém klientském kódu. Opakujte selhané požadavky po krátké prodlevě. Tím plynule řešíte přechodné síťové problémy. Váš předplacený kredit je účtován pouze za úspěšná dokončení, nikoliv za opakování omezená frekvencí.

Zpracování chyb a odmítnutí

Chyba 401 znamená, že váš klíč je neplatný nebo expiroval. Chyba 402 znamená nedostatek předplaceného kreditu. Chyba 429 signalizuje, že jste dosáhli limitu rychlosti. Model odmítá požadavky obsahující sexuální obsah zahrnující nezletilé. Veškerý jiný zákonný obsah pro dospělé je povolen.

Zkontrolujte tělo chybové odpovědi pro podrobné zprávy. Logujte tyto chyby pro ladění problémů s integrací. Za neúspěšné požadavky vám nejsou strženy kredity. Tento transparentní model fakturace vám pomáhá přesně předpovídat náklady bez skrytých poplatků.

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