Rychlý start API

Základní URL a ověření

Začněte tím, že nasměrujete svého klienta na naši základní URL a předáte svůj klíč v hlavičce. Používáme standardní schéma Authorization, takže jakýkoli SDK OpenAI nebo kompatibilní klient bude fungovat okamžitě. Nemusíte spravovat složité OAuth toky ani čekat na schválení. Stačí se zaregistrovat přes Google nebo e-mail, zkopírovat klíč a jste připraveni. Endpoint je https://api.aiohnezensur.com/v1 a přijímá Authorization: Bearer YOUR_API_KEY hlavička na každém požadavku.

Odeslání první žádosti

Odešlete jednoduché volání dokončení chatu k otestování modelu bez zábran. Tento požadavek odesílá podnět a přijímá textovou odpověď bez běžných korporátních zábran. Můžete použít jakýkoli nástroj, který podporuje protokol OpenAI, ale přímý příkaz curl ukazuje přesně, co se děje pod pokličkou. Nahraďte YOUR_API_KEY vaším skutečným klíčem z panelu.

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

Odpověď zahrnuje vygenerovaný text a statistiky využití tokenů. Pokud získáte odpověď, vaše integrace funguje správně. Nyní můžete přistoupit k tvorbě složitějších interakcí nebo přepnout na programové klienty.

Integrace Python SDK

Použijte oficiální balíček OpenAI pro Python pro bezproblémovou interakci s naším API. Nastavte základní URL na náš endpoint a poskytněte svůj klíč jako API token. To vám umožní využít existující kódové báze bez přepisování logiky HTTP. ID modelu je uncensored, což spouští náš specifický velký jazykový model laděný pro neomezený výstup.

Copyfrom openai import OpenAI

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

Tento snippet demonstruje základnou výměnu zpráv. Pole messages můžete upravit tak, aby zahrnovalo systémové prompty nebo historii konverzace. SDK za vás řeší serializaci a parsování chyb.

Integrace SDK pro Node

Integrujte API do svých JavaScriptových nebo TypeScriptových aplikací pomocí Node SDK. Nakonfigurujte base URL a API klíč stejně jako v Python příkladu. Tento přístup dobře funguje pro server-side rendering nebo backend mikroservis. SDK abstrahuje síťovou vrstvu, takže se můžete soustředit na logiku promptu.

Copyimport OpenAI from "openai";

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

Spusťte tento kód a uvidíte, jak model reaguje na váš vstup. Rychle můžete iterovat změnou obsahu promptu. Struktura odpovědi odpovídá standardnímu formátu OpenAI, což zajišťuje kompatibilitu s dalšími nástroji ve vašem stacku.

Streamované odpovědi

Povolte streamování pro příjem tokenů v okamžiku jejich generování, což snižuje vnímanou latenci. Toto je zásadní pro uživatelská rozhraní, která zobrazují text v reálném čase. Nastavte stream parameter na true ve vaší žádosti. API odesílá řadu událostí zaslaných serverem (SSE) místo jednoho objektu JSON. Každý blok obsahuje částečnou delta odpovědi.

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)

Spojte tyto delta změny na straně klienta pro rekonstrukci celé zprávy. Tato metoda působí u uživatele okamžitě, i pro dlouhé výstupy. Poslední chunk obsahuje celkové použití tokenů, což vám umožňuje přesně fakturovat.

Limity rychlosti a omezení

Chápejte technické limity, abyste předešli selhání požadavků ve výrobě. Na klíč máte povoleno 300 požadavků za minutu a můžete mít 8 souběžných požadavků. Tělo požadku nesmí překročit 8 MB. Pokud tyto limity překročíte, API vrátí stavový kód 429. Ve vašem klientovi byste měli implementovat exponenciální backoff pro plynulé zvládnutí těchto špiček. Kontextové okno má celkem 100,000 tokenů s maximálním výstupem 16,000 tokenů na požadavek. Chyby a odmítnutí nespotřebovávají kredit, takže můžete bezpečně zkusit znovu. Chyby ověření vracejí 401 a nedostatek prostředků vrací 402.