Dokumentace API pro vývojáře

Základní URL a ověření

Začněte změnou základní URL na náš vyhrazený endpoint a předáním vašeho API klíče v hlavičce Authorization. Nepoužíváme standardní základní URL OpenAI; musíte nastavit své SDK na https://api.deepseektokenplan.com/v1. To zajistí, že vaše požadavky budou směrovány přes naši infrastrukturu pro model bez omezení, nikoli přes proxy třetí strany. ID modelu, které v těle požadavku uvedete, je "uncensored", což spustí specificky vyladěné váhy na našich serverech. Autentizace spočívá v jednoduchém schématu Bearer tokenu, který funguje s libovolnou knihovnou kompatibilní s OpenAI. Klíč je vygenerován okamžitě po registraci přes Google nebo e-mail, bez nutnosti telefonního čísla. Tento klíč si udržte v bezpečí, protože je přímo propojen s vaším předplaceným zůstatkem.

První požadavek

Odešlete standardní požadavek na dokončení chatu pomocí cURL pro ověření vašeho nastavení a dostupnosti modelu. Tento jednoduchý požadavek POST ukazuje, jak API přijímá váš systémový prompt a zprávu uživatele. Parametry temperature a top_p můžete upravit pro ovládání kreativity. Odpověď vrátí vygenerovaný text spolu se statistikami využití tokenů pro transparentní fakturaci. Ujistěte se, že tělo požadavku obsahuje správný identifikátor modelu a váš API klíč v hlavičce. Tato metoda funguje pro scénáře generování textu i volání funkcí. Použijte tento příkaz k potvrzení připojení před integrací do vaší aplikace. Endpoint podporuje režim streamování i nestrimovaný režim stejně dobře.

Integrace Python SDK

Použijte oficiální knihovnu OpenAI pro Python pro interakci s naším API konfigurací základní URL a API klíče. Inicializujte klienta svými přihlašovacími údaji a zavolejte metodu dokončení chatu s požadovaným ID modelu. Tento přístup vám umožňuje využít stávající kódové báze, které byly vytvořeny pro OpenAI, bez většího refaktorování. Můžete streamovat odpovědi nebo přijmout celý text najednou. Knihovna automaticky řeší serializaci JSON a HTTP požadavky. Nakonfigurujte nastavení časového limitu a opakování podle potřeby pro váš konkrétní případ použití. Tato metoda je ideální pro backendové služby a potrubí pro zpracování dat. Ujistěte se, že aktualizujete základní URL tak, aby ukazovala na náš konkrétní endpoint.

Integrace SDK pro Node

Integrujte API do svých JavaScriptových nebo TypeScriptových aplikací pomocí balíčku OpenAI Node. Nastavte base URL a API klíč v konfiguraci klienta před provedením jakýchkoli požadavků. Toto nastavení vám umožní používat známé metody jako chat.completions.create() s naším uncensored modelem. Můžete předat parametry jako teplota a sekvence stop pro doladění výstupu. SDK efektivně zpracovává streaming odpovědí pro aplikace v reálném čase. Tento přístup použijte pro webové servery nebo nástroje příkazového řádku. Ujistěte se, že importujete potřebné moduly a správně nakonfigurujete environmentální proměnné. Tento způsob podporuje jak synchronní, tak asynchronní vzory požadavků.

Streamování a tokeny

Povolte streamování pro přijímání částečných odpovědí, jak jsou generovány, což zlepšuje uživatelský zážitek pro chatová rozhraní. API používá Server-Sent Events (SSE) pro doručování tokenů v reálném čase. Využití tokenů můžete sledovat v poslední části toku pro přesné fakturování. Tato funkce je podporována všemi hlavními SDK a může být implementována ručně, pokud je třeba. Streamování snižuje vnímanou latenci pro dlouhé odpovědi. Nastavte stream parameter na true v těle vašeho požadavku. API vrací statistiky využití v poslední události, což vám umožňuje odečíst správné množství z vašeho předplaceného kreditu. Tato metoda je zásadní pro aplikace vyžadující okamžitou zpětnou vazbu.

Limity a zpracování chyb

Sledujte své limity rychlosti a ošetřujte chyby elegantně pro zajištění stabilního připojení. API umožňuje 300 požadavků za minutu na klíč a 8 souběžných požadavků. Každé tělo požadavku nesmí přesáhnout 8 MB. Pokud odešlete neplatný klíč, dostanete chybu 401 Unauthorized. Chyba 402 označuje nedostatek předplaceného kreditu, což vyžaduje dobíjení přes kryptoměny. Chyba 429 znamená, že jste překročili limit rychlosti; počkejte a zkuste to znovu. Kontextové okno má 100,000 tokenů pro prompt a dokončení dohromady. Maximální výstup je 16,000 tokenů, pokud neurčíte nižší max_tokens hodnotou. Vždy zkontrolujte stavový kód a tělo odpovědi pro podrobné chybové zprávy.

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

Streamování

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)