Dokumentace k API Unzensierte

Rychlý start: pošlete svou první žádost

API Venice AI je služba kompatibilní s OpenAI. Platíte za tokeny pro generování textu bez filtrů obsahu. Pošlete požadavek POST na endpoint chat completions s vaším API klíčem. Model zpracuje váš prompt a vrátí textový výstup přímo.

Začněte autentizací pomocí vašeho klíče. Poté definujte ID modelu jako "uncensored". Specifikujte pole zpráv s rolí a obsahem. Server odpoví vygenerovaným textem. To funguje s jakýmkoli standardním HTTP klientem nebo SDK. Získáte syrový text bez dalšího formátovacího overheadu. Chyby vracejí JSON s kódem chyby. Použijte tuto rychlou cestu k ověření vašeho nastavení před tvorbou složitějších aplikací.

Ověření a základní URL

Ověření používá jediný API klíč předaný v hlavičce. Základní URL je HTTPS://api.unzensierte.cc/v1. Tato URL funguje s oficiálními SDK OpenAI nastavením parametru base_url. Váš klíč identifikuje váš účet a sleduje spotřebu tokenů. Vygenerujte klíč na stránce Získat API klíč. Objeví se ihned po registraci přes Google nebo e-mail. Použijte tento klíč v každém požadavku. Neplatné klíče vrátí chybu 401. Expirovaný nebo nedostatečný kredit vrátí 402.

Chraňte svůj klíč bezpečně. Jeden aktivní klíč na účet. Nový klíč nahrazuje ten starý. Pro registraci není vyžadováno telefonní číslo. Pro přístup stačí pouze API klíč.

Endpoint Chat Completions

Hlavním endpointem je POST /v1/chat/completions. Přijímá JSON payloady s modelem, zprávami a parametry. ID modelu je "uncensored". Zprávy vyžadují roli a řetězec content. Systém odpoví vygenerovaným textem v poli choices. Můžete nastavit teplotu, top_p a sekvence stop. Tyto parametry ovládají kreativitu a délku výstupu. API vrací využití tokenů v odpovědi. Chyby obsahují zprávu a typ. Použijte tento endpoint pro všechny úkoly generování textu. Je to jediný dostupný textový endpoint. Žádné vložení (embeddings) ani generování obrázků zde nenajdete.

Streamování odpovědí a využití

Povolte streamování nastavením stream na true. API odesílá události Server-Sent Events (SSE). Každý chunk obsahuje částečný text. Poslední chunk obsahuje data o využití tokenů. To umožňuje zobrazování generovaného textu v reálném čase. Bufferujte chunky ve své aplikaci. Spojte je pro vytvoření kompletní odpovědi. Streamování snižuje vnímanou latenci u dlouhých výstupů. Použijte to pro chatová rozhraní nebo zpracování dat v reálném čase. Objekt usage se objeví pouze v posledním chunku. Sledujte počty vstupních a výstupních tokenů pro fakturaci. Chyby během streamování stále vracejí objekt chyby v chunku.

Volání funkcí a režim JSON

Používejte volání funkcí k integraci externích nástrojů. Definujte nástroje v těle požadavku. Model vrací volání nástrojů s argumenty. Parsovejte tyto argumenty pro provedení vašich funkcí. Nastavte tool_choice na auto nebo konkrétní názvy funkcí. Režim JSON vynutí výstup do platného JSON. Nastavte response_format na json_object. To zajišťuje strukturovaná data pro parsování. Použijte tyto funkce pro automatizovaná workflow. Kombinujte je pro složité chování agentů. Model podporuje standardní formáty nástrojů OpenAI. Ověřte, že definice vašich nástrojů odpovídají očekávanému schématu.

Limity a zpracování chyb

Limitu rychlosti jsou 300 požadavků za minutu na klíč. Souběžnost je omezena na 8 současných požadavků. Těla požadavků musí být pod 8 MB. Chyby zahrnují specifické kódy, jako je 401 pro neplatné klíče. 402 označuje nedostatek předplaceného kreditu. 429 signalizuje překročení limitu rychlosti. Kontextové okno má celkem 100,000 tokenů. Max výstup je 16,000 tokenů na požadavek. Chyby vracejí JSON s detaily chyby. Zpracujte opakování pro chyby 429. Zkontrolujte zůstatek kreditu před těžkým využitím. Refundace za spotřebovaný kredit nejsou k dispozici.

cURL

Copycurl https://api.unzensierte.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List 5 common Linux commands for file management"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streamování

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)