Dokumentace vývojáře

Základní URL a ověření

Váš klíč API autentizuje každý požadavek na náš chat-completions endpoint. Tento klíč obdržíte ihned po registraci přes Google nebo e-mail na Získat API klíč stránku. Není vyžadováno telefonní číslo. Klíč uložte bezpečně a předávejte ho v Authorization hlavička.

Základní URL: https://api.cheapllm.cc/v1. Všechny požadavky musí obsahovat tuto hlavičku: Authorization: Bearer YOUR_API_KEY. Chyby jako 401 signalizují neplatný nebo chybějící klíč. Starý klíč můžete kdykoli nahradit novým; na jednom účtu existuje pouze jeden aktivní klíč.

První požadavek

Pošlete svůj první prompt pomocí standardního chat/completions endpoint. ID modelu je uncensored. Tento open-weight model odpovídá bez vyhazování obsahu pro legální použití pro dospělé, včetně fiktivních nebo kontroverzních témat. Získáte vstup textu, výstup textu. Žádné vložení ani generování obrázků zde nejsou k dispozici.

Níže je základní příklad cURL. Nahraďte YOUR_API_KEY vaším klíčem. Tělo požadku definuje zprávu uživatele. Zpracováváme kontextové okno o velikosti 100,000 tokenů (podnět + dokončení). Chyby a odmítnutí jsou zdarma, takže testujte bez obav.

• Nastavit model na uncensored.
• Zahrnout messages pole.
• Přidejte hlavičku API klíče.

Copycurl https://api.cheapllm.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set timezone to UTC for all logs"}]
  }'

Integrace Python SDK

Použijte oficiální Python SDK OpenAI pro interakci s naším API. Nastavte základní URL na náš endpoint a uveďte svůj klíč. Tento přístup funguje s jakoukoli knihovnou klienta kompatibilní s OpenAI. Nakonfigurujte parametry jako temperature a top_p jak je potřeba. Streamování je podporováno prostřednictvím Server-Sent Events (SSE). Tato metoda je ideální pro aplikace v reálném čase, kde chcete zobrazovat tokeny, jak jsou generovány.

Nainstalujte knihovnu s pip install openai.Inicializujte klienta s naší základní URL. Níže uvedený kód ukazuje jednoduchý požadavek na dokončení textu. Upravte obsah zprávy tak, aby odpovídal vašemu případu použití. Naše API interně zajišťuje směrování k správnému modelu.

Copyfrom openai import OpenAI

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

Integrace SDK pro Node

Pro vývojáře Node.js balíček OpenAI npm funguje bezproblémově. Nastavte základní URL na náš API endpoint. To vám umožní používat osvědčené vzorce od jiných poskytovatelů. Nakonfigurujte ID modelu na uncensored. Můžete také povolit režim JSON nebo volání funkcí, pokud vaše aplikace vyžaduje strukturovaný výstup. SDK automaticky zpracovává ověřování, když je správně nakonfigurováno.

Nainstalujte balíček pomocí npm install openaimax_tokens ovlivnit délku výstupu. Chyby jsou vráceny jako standardní stavové kódy HTTP. Použijte to pro rychlé prototypování nebo produkční integrace.

Copyimport OpenAI from "openai";

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

Streamované odpovědi přes SSE

Povolte streamování nastavením stream: true ve vaší žádosti. API vrací Server-Sent Events (SSE). Každý blok obsahuje částečný text. Poslední blok zahrnuje statistiky využití tokenů. Tato funkce je klíčová pro uživatelskou zkušenost v chatových rozhraních. Výrazně snižuje vnímanou latenci. Proud můžete parsovat pro zobrazení textu v reálném čase.

Zpracujte události proudu v kódu klienta. Uzavřete připojení, když proud skončí. Naše API podporuje až 8 souběžných požadavků na klíč. Tento limit zajišťuje férové využívání. Sledujte své využití přes data z poslední části. Chyby během streamování stále vracejí příslušné kódy stavu. Použijte to pro roleplay nebo scénáře nepřetržité konverzace.

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)

Limity, chyby a kontextové okno

Naše API má přísná omezení pro zajištění stability. Můžete poslat 300 požadavků za minutu na klíč. Souběžné požadavky jsou omezeny na 8. Těla požadavků nesmí překročit 8 MB. Kontextové okno má celkem 100 000 tokenů. Maximální výstup je 16 000 tokenů na požadavek (2 048 pokud max_tokens není nastaveno). Chyby vracejí specifické kódy: 401 pro neplatné klíče, 402 pro nedostatečný kredit a 429 pro omezení rychlosti. Kredit nevyprší. Chyby jako dvojí účtování jsou řešeny přes Support. Soukromí je zachováno; prompty nejsou používány pro trénování. Není povolán sexuální obsah zahrnující nezletilé.