Rychlý start: Integrace API DeepSeek Coder

Základní URL a ověření

Váš klíč API autentizuje každý požadavek na náš hostovaný endpoint. Použijte základní URL https://api.coderdeepseek.cc/v1 s jakýmkoli OpenAI SDK nebo HTTP klientem. Identifikátor modelu je striktně uncensored. Běží na našich vlastních serverech a nejedná se o přeprodej modelu od jiného dodavatele. Po registraci přes Google nebo e-mail okamžitě obdržíte klíč API. Tento klíč udržujte v bezpečí, protože řídí vaši předplacenou kreditní částku.

Ověření spoléhá na Authorization hlavička. Předáte svůj klíč jako token Bearer. Každý požadavek musí obsahovat tuto hlavičku, abyste předešli 401 chybu. Nepoužíváme query parametry pro autentizaci. To zajišťuje čisté hlavičky a kompatibilitu se standardním middleware.

Odesílání požadavků: Chat Completions

Endpoint dokončení chatu zpracovává vaše podněty a vrací textové výstupy. Pošlete požadavek POST na /v1/chat/completions. Zahrňte název modelu, pole messages a požadované parametry. Systém zpracovává text a vrací text jako výstup. Můžete ovládat formát odpovědi i kritéria pro ukončení. Funguje to jak pro jednoduché dotazy, tak pro složité úkoly v programování.

Použijte následující příkaz curl k otestování připojení. Nahraďte YOUR_API_KEY vaším skutečným klíčem. Požadavek používá uncensored identifikátor modelu. Tím potvrdíte, že vaše ověření a zůstatek kreditu jsou aktivní.

Copycurl https://api.coderdeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the library"}]
  }'

Ověřte, že odpověď obsahuje choices pole. Každá možnost zahrnuje zprávu s vygenerovaným obsahem. Zkontrolujte usage object pro počty tokenů. To vám pomůže přesně monitorovat vaše výdaje.

Integrace Python SDK

Integrujte API do svých projektů Python pomocí oficiálního balíčku OpenAI. Nastavte základní URL na náš endpoint. Inicializujte klienta svým API klíčem. To vám umožní použít osvědčené metody jako chat.completions.create. SDK automaticky zajišťuje serializaci JSON a HTTP požadavky.

Nastavte model na uncensored. Předáte své zprávy ve standardním formátu. SDK podporuje všechny naše funkce včetně volání funkcí a JSON režimu. Parametry jako teplota a top_p můžete nastavit přímo. To usnadňuje migraci od jiných poskytovatelů.

Copyfrom openai import OpenAI

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

Ošetřete výjimky pro síťové chyby nebo neplatné požadavky. Zkontrolujte stavový kód, pokud parsovatelnou surovou odpověď. To zajišťuje robustní zpracování chyb ve vaší aplikaci. SDK abstrahuje většinu složitosti.

Integrace SDK pro Node

Použijte SDK OpenAI pro Node.js k integraci s projekty JavaScript nebo TypeScript. Nainstalujte balíček a nakonfigurujte základní URL. To zachovává kompatibilitu se stávající strukturou kódu. Můžete použít stejné metody jako v Pythonu. SDK podporuje jak CommonJS, tak ES moduly.

Nastavte model na uncensored. Předáte své zprávy a parametry. SDK zpracovává streamovací i nestreamovací požadavky. Můžete zachytit chyby a logovat je odpovídajícím způsobem. To zajišťuje stabilitu vaší aplikace i při vysoké zátěži.

Copyimport OpenAI from "openai";

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

Otestujte svou integraci jednoduchým podnětem. Ověřte, že odpověď odpovídá vašim očekáváním. Zkontrolujte využití tokenů v objektu odpovědi. To vám pomůže sledovat náklady a výkon. SDK usnadňuje rychlé iterace.

Streamované odpovědi a spotřeba tokenů

Povolte streamování nastavením stream: true ve vaší žádosti. API vrací stream událostí zaslaných serverem (SSE). Dostáváte bloky textu, jak jsou generovány. To snižuje vnímanou latenci u dlouhých odpovědí. Poslední blok obsahuje celkové využití tokenů.

Parsovejte události SSE pro extrakci obsahu. Spojte části a vytvořte kompletní odpověď. Sledujte usage object v posledním chunku. To vám poskytuje přesné počty tokenů pro fakturaci. Streamování je ideální pro aplikace v reálném čase.

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)

Zvládněte síťové přerušení elegantně. Připojte se znovu, pokud se stream připojení přeruší. API neposílá předchozí části znovu. Musíte rekonstruovat celý text na straně klienta. To poskytuje hladký uživatelský zážitek.

Limity, chyby a kontextové okno

Naše API zavádí přísná omezení pro zajištění stability. Můžete provést 300 požadků za minutu na klíč. Současně může běžet až 8 požadků. Tělo požadku nesmí překročit 8 MB. Překročení těchto limitů má za následek 429 chyba limitu rychlosti. Řešte tyto chyby pomocí exponenciálního zpětného odstupování.

Okno kontextu má 100 000 tokenů. To zahrnuje jak prompt, tak completion. Max výstup je 16 000 tokenů na požadavek. Pokud nenastavíte max_tokens, výchozí hodnota je 2 048. A 401 chyba znamená, že váš klíč je neplatný. A 402 chyba znamená, že nemáte kredit. Dobijte pomocí kryptoměn a pokračujte ve využívání služby.