Průvodce integrací pro vývojáře

Základní URL a ověření

Začněte tím, že nasměrujete svého klienta na naši základní URL a dodáte svůj API klíč v hlavičce authorization. To funguje s jakýmkoli SDK kompatibilním s OpenAI, protože přesně dodržujeme standardní protokol. Vygenerujte si klíč okamžitě přes Google nebo e-mail na stránce Získat API klíč; telefonní číslo není vyžadováno. Klíč udržujte v bezpečí a používejte jeden aktivní klíč na účet, protože vygenerování nového klíče nahradí ten předchozí.

Ověření je jednoduché. Pošlete svůj klíč do Authorization hlavička pro každý požadavek. Náš systém validuje klíč před zpracováním tokenů, což zajišťuje, že kredit utratí pouze autorizované účty. Chyby, jako chybějící klíč, okamžitě vrátí stavový kód 401.

První požadavek

Standardní požadavek na dokončení chatu pro otestování připojení a kvality odpovědi. Tento jednoduchý hovor ověří váš klíč a správně přičte kredity na vašem účtu. ID modelu je uncensored, což zpracovává textový vstup a výstup bez odmítnutí obsahu pro legální použití pro dospělé. Nahraďte zástupný symbol svým skutečným klíčem a system promptem.

Copycurl https://api.deepseekapicost.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 1 million tokens"}]
  }'

Tento příkaz curl demonstruje minimální strukturu, která je vyžadována. Můžete upravit messages pole pro zahrnutí kontextu nebo pokynů. Odpověď vrací vygenerovaný text v content pole. Zkontrolujte statistiky využití v hlavičkách odpovědi pro sledování spotřeby tokenů.

Python SDK

Použijte oficiální knihovnu OpenAI pro Python pro integraci našeho API do vašich skriptů nebo aplikací. Nastavte base_url a api_key atributy před provedením volání. Tento přístup zajišťuje kompatibilitu s existujícími kódy, které již používají modely OpenAI. Mezi poskytovateli můžete přepínat změnou pouze dvou řádků konfigurace.

Copyfrom openai import OpenAI

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

Výše uvedený Python snippet ukazuje, jak inicializovat klienta a odeslat požadavek. Knihovna automaticky zpracovává serializaci JSON a parsování odpovědí. Můžete přistupovat k odpovědnímu objektu pro extrakci obsahu, statistik využití a důvodů ukončení. Tato metoda je ideální pro backendové služby nebo datové zpracovací potrubí.

SDK pro Node

Integrujte naše API do aplikací Node.js pomocí openai npm package. Configure the client with our base URL and your API key just like you would for OpenAI. This allows you to use the same code structure for both testing and production. The SDK supports asynchronous operations for non-blocking requests.

Copyimport OpenAI from "openai";

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

Tento příklad v Node.js demonstruje odeslání požadavku na dokončení chatu. The await klíčové slovo zajišťuje, že odpověď je plně přijata, než se pokračuje. Chyby můžete zpracovat pomocí bloků try-catch pro plynulé řešení síťových problémů nebo limitů API. Objekt odpovědi obsahuje vygenerovaný text a podrobnosti o využití tokenů.

Streamování

Povolte streamování pro příjem odpovědí token po tokenu pro lepší uživatelský zážitek v chatových rozhraních. Nastavte stream parameter na true ve vašem požadavku. API vrací části textu, jak jsou generovány, což vám umožňuje zobrazovat výstup v reálném čase. To výrazně snižuje vnímanou latenci pro koncové uživatele.

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)

Kód výše zpracovává každý příchozí chunk. Obsah můžete ihned přidat do prvku uživatelského rozhraní. Poslední chunk obsahuje statistiky celkové spotřeby tokenů. Tato funkce je podporována všemi klienty kompatibilními s OpenAI, které správně zpracovávají odpovědi SSE.

Limity, chyby a kontextové okno

Naše API zavádí přísná omezení pro zajištění férového využívání a stability systému. Je vám povoleno 300 požadků za minutu a 8 souběžných požadků na klíč. Každé tělo požadku nesmí překročit 8 MB. Pokud tyto limity překročíte, API vrátí stavový kód 429. Počkejte několik sekund a zkuste požadek opakovat. Chyby jako neplatné klíče vracejí 401 a nedostatek kreditu vrací 402.

Okno kontextu podporuje až 100 000 tokenů pro vstup i výstup dohromady. Maximální výstup na požadavek je 16 000 tokenů, nebo 2 048, pokud nespecifikujete max_tokens. Toto velké okno vám umožňuje zpracovávat dlouhé dokumenty nebo udržovat rozsáhlou historii konverzace bez ořezu. Chyby a odmítnutí nespotřebovávají kredit, takže platíte pouze za skutečné použití.