Dokumentace API

Základní URL a ověření

API žije na https://api.ollamauncensoredmodels.com/v1Autorizace hlavička s vaším tokenem Bearer. Toto nastavení funguje s jakoukoli knihovnou kompatibilní s OpenAI, protože se řídíme stejnými vzory autentizace. Klíč můžete vygenerovat okamžitě přes Google nebo e-mail bez poskytnutí telefonního čísla. Systém vydává jeden aktivní klíč na účet; vygenerování nového klíče okamžitě nahradí předchozí. To zajišťuje konzistentní přístup bez nutnosti spravovat více přihlašovacích údajů současně.

Vytvoření prvního požadavku

Odeslat požadavek POST na /v1/chat/completions pomocí ID modelu nastaveného na „uncensored“. Koncový bod přijímá standardní parametry jako messages, temperature, a max_tokens. Vrací odpovědi ve formátu JSON obsahující vygenerovaný text a statistiky využití tokenů. Připojení můžete rychle otestovat ověřením seznamu modelů nebo odesláním jednoduchého promptu. Tento přímý přístup odstraňuje složitost proxy nebo směrovací logiky, která je často přítomna u jiných služeb.

Copycurl https://api.ollamauncensoredmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the output for 2 plus 2"}]
  }'

Integrace Python SDK

Použijte oficiální knihovnu OpenAI pro Python pro připojení přepsáním základní URL. Nastavte atributy API klíče a základní URL před provedením jakýchkoli volání. To vám umožní využít stávající kódové báze bez přepisování logiky klienta. Knihovna automaticky řeší serializaci a parsování chyb. Můžete streamovat odpovědi nebo požadovat synchronní dokončení podle požadavků na latenci vaší aplikace. Tato metoda zajišťuje kompatibilitu se standardními vývojářskými praktikami používanými v celém odvětví.

Copyfrom openai import OpenAI

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

Využití SDK Node.js

Inicializujte klienta OpenAI se svou základní URL a API klíčem v prostředích Node.js. Předejte identifikátor modelu "uncensored" metodě chat completion. SDK efektivně řeší HTTP požadavky a parzuje odpovědi JSON. Lze jej přímo integrovat do tras Express nebo serverless funkcí. Struktura kódu odpovídá standardním implementacím OpenAI, což usnadňuje migraci z jiných poskytovatelů. Tento přístup zachovává typovou bezpečnost a zpracování chyb konzistentní s moderním vývojem JavaScript.

Copyimport OpenAI from "openai";

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

Streamování a využití tokenů

Povolte streamování nastavením stream: true ve vaší žádosti. Server vrací Server-Sent Events (SSE) pro doručování tokenů v reálném čase. Detaily o využití tokenů se objevují pouze v posledním chunku streamu, aby se minimalizovala režie. To vám umožňuje zobrazovat odpovědi postupně uživatelům bez čekání na celé vygenerování. Můžete sledovat kumulativní počty tokenů pro transparentnost fakturace. Streamování je ideální pro chatová rozhraní, kde okamžitá zpětná vazba výrazně zlepšuje uživatelský zážitek.

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 kontext

Každý klíč API podporuje 300 požadavků za minutu a osm souběžných připojení. Limit velikosti těla požadavku je 8 MB a kontextové okno zahrnuje celkem 100 000 tokenů. Chyby jako 401 označují neplatný klíč, zatímco 402 signalizuje nedostatečný zůstatek. Stav 429 znamená, že jste dosáhli limitu rychlosti. Model odmítá pouze sexuální obsah zahrnující nezletilé, což zajišťuje širokou použitelnost pro případy pro dospělé. Kredit nevyprší, takže můžete mezi projekty pozastavit používání bez ztráty prostředků. Tato předvídatelná struktura vám pomáhá efektivně plánovat kapacitu pro aplikace s vysokým provozem.