Průvodce integrací: klíč API deepseek coder

Základní URL a ověření

Váš API klíč autentizuje každý požadavek. Nastavte základní URL na https://api.deepseekcoderapikey.com/v1 ve vaší konfiguraci klienta. Tato URL zpracovává oba koncové body chat completions a models bez nutnosti dalších cest. Na každý účet získáte jeden klíč a vygenerování nového okamžitě nahradí předchozí klíč.

Uložte klíč do proměnné prostředí s názvem DEEPSEEK_API_KEY nebo jej předat přímo klientovi SDK. Endpoint přijímá standardní hlavičky, takže můžete vyměnit poskytovatele změnou pouze základní URL a hodnoty klíče. Tento přístup funguje s Cursor, rozšířeními VS Code a místními vývojářskými nástroji, které očekávají rozhraní kompatibilní s OpenAI.

Ověření selže se stavem 401, pokud chybí klíč nebo je neplatný. Použijte

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

příklad, abyste ověřili připojení před integrací do logiky vaší aplikace.

Endpoint Chat Completions (POST)

Pošlete zprávy na POST /v1/chat/completions endpoint pomocí ID modelu uncensored. Tento endpoint zpracovává textový vstup a vrací textový výstup, podporuje synchronní i streamované odpovědi. Chování modelu můžete nakonfigurovat pomocí parametrů, jako je teplota, top_p a sekvence pro zastavení.

Okno kontextu umožňuje až 100 000 tokenů pro kombinovaný prompt a dokončení. Pokud nezadáte limit max_tokens, model ve výchozím nastavení používá 2 048 tokenů na požadavek. Použijte

Copyfrom openai import OpenAI

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

fragment ukazuje, jak strukturovat standardní požadavek na chat s oficiálním Python SDK OpenAI.

Chyby způsobené nedostatkem kreditu vracejí stavový kód 402, zatímco chybné požadavky vracejí 400. Podrobné chybové zprávy v těle odpovědi vám pomohou rychle ladit strukturu payloadu.

Koncový bod Modely (GET)

Vyhledejte dostupné modely odesláním GET /v1/models požadavek. Tento endpoint vrací seznam objektů modelů, včetně uncensored ID modelu. Tento endpoint můžete použít k ověření, že váš API klíč je platný a že je služba online, než začnete provádět náročné požadavky.

Odpověď zahrnuje metadata, jako je ID modelu, typ objektu a informace o vlastnictví. Tato data použijte k dynamické konfiguraci vaší aplikace nebo k logování dostupných modelů pro účely ladění. Tento koncový bod nevyžaduje tělo, pouze standardní autentizační hlavičku.

Integrace této kontroly do vašeho startovacího procesu zajišťuje, že vaše aplikace selže rychle, pokud je API nedostupné. Pomáhá také ověřit, že je správně nakonfigurovaná základní URL, než přejdete k samotným požadavkům na chat.

Streamované odpovědi (SSE)

Povolte streamování nastavením stream parameter na true ve vašem požadavku. API vrací stream událostí Server-Sent Events (SSE), který dodává tokeny v okamžiku jejich generování. Tento přístup snižuje vnímanou latenci pro asistenty při psaní kódu a umožňuje aktualizace uživatelského rozhraní v reálném čase ve vaší aplikaci.

Každý chunk obsahuje částečný obsah a poslední chunk obsahuje statistiky celkového využití tokenů. SSE stream pečlivě parsovejte, abyste zvládli síťové přerušení a bufferizovali částečné tokeny. The

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)

příklad demonstruje, jak zpracovat stream v JavaScriptu.

Streamování je ideální pro generování dlouhého kódu nebo podrobných vysvětlení. Poskytuje plynulejší uživatelský zážitek ve srovnání s čekáním na celou odpověď. Ujistěte se, že váš klient správně zpracuje událost konce streamu pro finalizaci odpovědi.

Volání funkcí a režim JSON

Použijte volání funkcí, aby model mohl volat externí nástroje. Definujte své funkce v tools parameter a specifikujte tool_choice pro ovládání toho, kdy model nástroje používá. API podporuje standardní definice nástrojů, což vám umožňuje integrovat je s vašimi vlastními backendovými službami.

Pro strukturované výstupy povolte režim JSON nastavením response_format na json_object. Toto donutí model vrátit platný JSON, což je užitečné pro parsování konfiguračních dat nebo odpovědí API. The

Copyimport OpenAI from "openai";

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

fragment ukazuje, jak nakonfigurovat režim JSON v Node.js.

Kombinujte volání funkcí se streamováním pro interaktivní používání nástrojů. Model může v jednom kroku zavolat více nástrojů, což umožňuje složité vícekrokové pracovní postupy. Ujistěte se, že váš klient správně zpracovává výstupy nástrojů, aby udržel kontext konverzace.

Limity rychlosti a omezení

Váš klíč API je omezen na 300 požadavků za minutu a 8 souběžných požadavků. Maximální velikost těla požadavku je 8 MB. Pokud tato omezení překročíte, API vrátí chybu 429 Too Many Requests. Implementujte exponenciální backoff ve vašem klientovi, abyste limity rychlosti zvládali hladce.

Chyby jako 401 označují neplatný klíč, zatímco 402 signalizuje nedostatek kreditu. Pro kredit se nevydávají refundace, ale dvojnásobné účty lze vyřešit na stránce Podpora. Kredit nikdy nevyprší, takže jej můžete doplnit, když vám to vyhovuje.

Kontextové okno o velikosti 100 000 tokenů platí pro celkový prompt a odpověď. Sledujte využití tokenů, abyste se vešli do rozpočtu. Použijte systém předplaceného kreditu a platte pouze za to, co skutečně využijete, bez měsíčních poplatků ani předplatných.