API Dokumentace

Autentizace a základní URL

Ověřte každý požadavek předáním svého API klíče do Authorization hlavička. Naše služba používá jednu základní URL pro všechny operace, což vám umožňuje přepnout se od jiných poskytovatelů bez změny základní logiky. Jednoduše nahraďte výchozí základní URL v konfiguraci klienta pomocí https://api.abliteratedgemma.com/v1 a vložit klíč. To funguje s jakýmkoli standardním OpenAI-compatible SDK, což vám umožňuje použít stejný klientský kód pro náš uncensored model, jak byste ho použili pro komerční giganty.

Vytvoření prvního požadavku

Odeslat požadavek POST na /v1/chat/completions pomocí ID modelu uncensored. API přijímá standardní zprávy pro chat a vrací text přímo. Použijte následující příkaz cURL pro ověření připojení a okamžité získání odpovědi.

Copycurl https://api.abliteratedgemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fix syntax error in python loop"}]
  }'

Tento endpoint podporuje až 100 000 tokenů v kombinaci promptu a dokončení. Pokud nezadáte limit tokenů, model ve výchozím nastavení používá 2 048 výstupních tokenů. Ujistěte se, že vaše požadavky nepřekračují limit těla 8 MB, aby nedošlo k chybám při ořezávání.

Použití Python SDK

Nainstalujte oficiální balíček OpenAI pro Python a nakonfigurujte ho tak, aby ukazoval na naši základní URL. To vám umožní využít známé metody jako chat.completions.create pro synchronní požadavky. Následující příklad ukazuje, jak inicializovat klienta a odeslat jednoduchý prompt do uncensored modelu.

Copyfrom openai import OpenAI

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

Pamatujte, že chyby jako 401 znamenají neplatný klíč, zatímco 402 znamená, že vám došel předplacený úvěr. Protože neposkytujeme předplatná, musíte pro pokračování ve využívání služby dobít kredit pomocí kryptoměn.

Použití Node.js SDK

Inicializujte klienta Node.js OpenAI se stejnou strukturou základní URL a API klíče. To vám umožní integrovat generování bez omezení přímo do aplikací Node. Níže uvedený kódový úryvek ukazuje minimální nastavení potřebné pro zahájení odesílání požadavků.

Copyimport OpenAI from "openai";

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

SDK Node automaticky zpracovává serializaci požadavků, ale musíte stále spravovat svůj vlastní zůstatek kreditů. Aktuální sazby tokenů a možnosti doplňování kryptoměnami naleznete na stránce cen.

Streamované odpovědi

Povolte streamování nastavením stream: true ve vaší žádosti. API vrací bloky textu, jak jsou generovány, což umožňuje nižší latenci v aplikacích orientovaných na uživatele. Použijte tento kód k zpracování streamu token po tokenu.

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)

Streamování funguje s klienty Python i Node. Každý chunk obsahuje částečný text a poslední chunk zahrnuje celkové využití tokenů. To je ideální pro chatová rozhraní, kde okamžitá zpětná vazba zlepšuje uživatelský zážitek.

Limity a zpracování chyb

Sledujte své limity požadavků, abyste předešli přerušení služby. Můžete odeslat 300 požadavků za minutu a 8 souběžných požadavků na klíč. Pokud překročíte limit rychlosti, API vrátí chybu 429. Vždy řešte chyby 401 ověřením svého klíče a chyby 402 doplněním svého kryptoměnového kreditu. Váš předplacený kredit nevyprší, takže můžete použití pozastavit bez ztráty prostředků.

Okno kontextu a detaily modelu

Model podporuje kontextové okno o velikosti 100 000 tokenů, které zahrnuje jak vstupní, tak výstupní tokeny. To umožňuje uchovat rozsáhlou historii konverzace nebo zpracovat velké dokumenty v jednom požadavku. ID modelu je uncensored, a běží na našich serverech bez odmítání obsahu pro legální obsah pro dospělé. Tuto kapacitu využijte k udržení dlouhodobé paměti nebo efektivnímu zpracování velkých datových sad.