Dokumentace klíče API Gemma

Autentizace a základní URL

Použijte svůj unikátní API klíč k autentizaci každého požadavku. Základní URL je HTTPS://api.gemmaapikey.com/v1 a klíč odesíláte v hlavičce Authorization. To funguje s libovolným klientem kompatibilním s OpenAI změnou base_url a API klíče. Pokud ho ztratíte, vygenerujte nový z dashboardu. Starý klíč okamžitě přestane fungovat. Chyby a odmítnutí nespotřebují váš předplacený kredit.

První požadavek

Odešlete požadavek POST na /v1/chat/completions s modelem id "uncensored". Zahrňte svůj systémový prompt a uživatelskou zprávu do pole messages. Model odpovídá vygenerovaným textem bez odmítání obsahu pro legální použití dospělými.

Copyfrom openai import OpenAI

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

Nastavte temperature a top_p pro ovládání náhodnosti. Použijte sekvence stop pro předčasné zastavení generování. Odpověď obsahuje spotřebu tokenů v posledním chunku, pokud je povoleno streamování.

Integrace SDK pro Node

Nainstalujte oficiální SDK OpenAI pro Node.js. Nakonfigurujte ho svým API klíčem a základní URL z tohoto průvodce. Zavolejte metodu chat.completions.create s vaším promptem.

Copyimport OpenAI from "openai";

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

Tento přístup udržuje náklady předvídatelné, protože platíte pouze za použité tokeny. Předplacený kredit je účtován podle skutečného využití. Neplatí žádné měsíční poplatky. Účet můžete kdykoli doplnit pomocí kryptoměn.

Streamované odpovědi

Povolte streamování nastavením stream na true v požadavku. API vrací části Server-Sent Events (SSE). Každá část obsahuje částečný text, dokud poslední část neobsahuje 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)

Streaming snižuje vnímanou latenci pro dlouhé odpovědi. Také vám umožňuje zobrazovat uživatelům postup v reálném čase. Okno kontextu podporuje 100,000 tokenů pro prompt a dokončení dohromady.

Limity rychlosti a kontext

Na klíč máte limit 300 požadků za minutu. Současně může běžet pouze 8 požadků. Tělo požadku nesmí překročit 8 MB. Tato omezení zajišťují stabilní výkon pro všechny uživatele.

Model podporuje volání funkcí, režim JSON a standardní parametry jako seed a presence_penalty. Maximální výstup je 16 000 tokenů na požadavek. Pokud nezadáte max_tokens, výchozí hodnota je 2 048.

Chyby a řešení problémů

Chyba 401 znamená, že váš klíč API je neplatný nebo expiroval. Zkontrolujte ovládací panel pro váš aktivní klíč. Chyba 402 znamená nedostatek předplaceného kreditu. Dobijte jej pomocí kryptoměn, abyste mohli pokračovat. Chyba 429 znamená, že jste narazili na limit rychlosti. Počkejte několik sekund a zkuste to znovu.

Chyby nesnižují váš kredit. Pokud dojde k dvojímu účtování, použijte stránku Podpora k opravě. Kredity nevyprší, takže je můžete později doplnit.

cURL

Copycurl https://api.gemmaapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the current system status"}]
  }'