Rychlý start: Integrujte chat apertus ai

Požadavky a nastavení

Začněte vytvořením účtu a získáním API klíče. Zaregistrujte se pomocí Google nebo e-mailového hesla na stránce pro generování klíčů. Systém vám klíč okamžitě zobrazí, takže si jej můžete okamžitě zkopírovat. Není vyžadováno telefonní číslo. Obdržíte $0.50 zkušebního kreditu platného po dobu 7 dnů, takže můžete otestovat připojení bez přidání prostředků.

Nastavte proměnnou prostředí nebo klienta SDK tak, aby směřoval na správnou základní URL. Tato URL funguje se standardními knihovnami OpenAI. Změňte pouze základní URL a svůj klíč. ID modelu je „uncensored“. Tento jediný endpoint obsluhuje všechny dokončování textu. Nemusíte spravovat směrování ani vybírat různé modely.

Ujistěte se, že vaše knihovna klienta podporuje protokol OpenAI Chat Completions. Většina moderních SDK funguje bez problémů. Ověřte, že vaše síť povoluje odchozí HTTPS požadavky. Služba přijímá standardní JSON payloady. Kromě autentizace nejsou potřeba žádné speciální hlavičky.

Ověření pomocí API klíčů

Předávejte svůj klíč API v hlavičce Authorization pro každý požadavek. Použijte schéma Bearer následované řetězcem vašeho klíče. Služba ověří klíč vůči vašemu účtu. Neplatné klíče vrátí chybu 401 Unauthorized. Vypršená platnost nebo nedostatečné prostředky vyvolají odpověď 402 Payment Required. Pokud požadavky selhávají, zkontrolujte svůj zůstatek v ovládacím panelu.

"Chraňte svůj klíč. Každý účet má najednou aktivní jeden klíč. Vygenerování nového klíče zneplatní ten předchozí. Nesdílejte svůj klíč ve veřejných repozitářích. API klíč je jediným identifikátorem vašeho využití. Limity rychlosti se vztahují na klíč, nikoliv na účet."

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

Ověření je bezstavové. Server kontroluje token při každém volání. Pokud klíč obměníte, aktualizujte všechny běžící klienty okamžitě. Chybějící hlavička vede k okamžitému odmítnutí. Chybová zpráva jasně uvádí selhání ověření.

Odeslání první žádosti

Odešlete požadavek POST na koncový bod chat completions. Zahrňte ID modelu "uncensored" a historii vašich zpráv. API vrací textovou odpověď. Výstup můžete streamovat nebo počkat na úplné dokončení. Každý požadavek spotřebovává vstupní a výstupní tokeny. Chyby nezúčtují kredity. Odepření odpovědi jsou zdarma.

Copyfrom openai import OpenAI

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

Odpověď obsahuje statistiky využití. Sledujte spotřebu tokenů pro správu předplaceného kreditu. Model odpovídá bez odmítání obsahu pro legální použití pro dospělé. Můžete odeslat systémové příkazy k definování chování. Zprávy uživatele řídí konverzaci. Okno kontextu podporuje celkem 100 000 tokenů.

Začněte jednoduchou dvouzprávovou výměnou. Tím ověříte připojení a kvalitu odpovědi. Upravte teplotu a top_p pro kreativní nebo přesné výstupy. API podporuje standardní parametry. Sekvence zastavení fungují podle očekávání. Hodnoty semene zajišťují reprodukovatelné výsledky.

Streamované odpovědi přes SSE

Povolte streamování nastavením parametru stream na true. API vrací Server-Sent Events (SSE) místo jednoho objektu JSON. Každý chunk obsahuje část generovaného textu. Čtěte chunky, dokud stream neskončí. Poslední chunk zahrnuje celkové využití tokenů.

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í snižuje vnímanou latenci. Uživatelé vidí text objevující se v reálném čase. To je ideální pro chatová rozhraní. S částečnými tokeny zacházejte opatrně. Spojte bloky a vytvořte kompletní odpověď. Server ukončí připojení, když generování skončí.

Sledujte chyby streamu. Přerušení sítě mohou stream přerušit. Implementujte logiku opětovného připojení, pokud je to nutné. API neposílá historii znovu. Začněte nový požadavek, pokud stream selže. Počty tokenů v posledním bloku odrážejí celé generování.

Zvládání parametrů a režimů

Používejte standardní parametry k řízení generování. Nastavte teplotu pro náhodnost. Upravte top_p pro nucleus sampling. Definujte sekvence stop pro předčasné ukončení generování. Předdejte semeno pro deterministické výstupy. Povolte režim JSON nastavením response_format na json_object. Model vrátí platný JSON, když je požadován.

Volání funkcí je podporováno. Definujte nástroje v žádosti. Model vrací volání nástrojů, když je to vhodné. Parsovejte argumenty nástrojů ve svém kódu. Předáte výsledky zpět pro pokračování konverzace. To umožňuje komplexní pracovní postupy agentů.

Copyimport OpenAI from "openai";

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

Tokeny max omezují délku výstupu. Výchozí hodnota je 2 048 tokenů. Nastavte vyšší hodnotu, pokud je to potřeba. Tvrdý limit na požadavek je 16 000 tokenů. Kontextové okno má 100 000 tokenů. Délku historie plánujte příslušně. Penaltové hodnoty pro frekvenci a přítomnost pomáhají snížit opakování.

Chápání limitů a chyb

Omezení rychlosti (rate limits) chrání stabilitu služby. Můžete odeslat 300 požadavků za minutu. Souběžnost je omezena na osm současných požadavků na klíč. Těla požadavků nesmí překročit 8 MB. Překročení limitů vrátí chybu 429 Too Many Errors. Před opakováním počkejte.

Zkontrolujte kódy chyb pro diagnostiku. 401 znamená neplatný nebo chybějící klíč. 402 indikuje nedostatek předplaceného kreditu. Dobijte kryptoměnami a službu znovu spusťte. 429 signalizuje omezení rychlosti. 400 označuje špatný formát požadavku. Podrobnosti naleznete v chybové zprávě.

Správa kontextového okna je kritická. Sečtěte tokeny promptu a dokončení. Zůstaňte výrazně pod hranicí 100 000 tokenů. Pokud je to nutné, ořežte staré zprávy. API automaticky neorezuje historii. Vy určujete délku historie. Efektivní využití kontextu snižuje náklady.