Gemma api -avain dokumentaatio

Todennus ja base URL

Käytä ainutlaatuista API-avaintasi autentikoidaksesi jokaisen pyynnön. Base URL -osoite on HTTPS://api.gemmaapikey.com/v1 ja lähetät avaimen Authorization-otsikossa. Tämä toimii minkä tahansa OpenAI-yhteensopivan asiakasohjelman kanssa muuttamalla base_url:ia ja API-avainta. Jos menetät sen, luo uusi hallintapaneelista. Vanha avain lakkaa toimimasta välittömästi. Virheet ja hylkäykset eivät kuluta esimaksullista krediittiäsi.

Ensimmäinen pyyntö

Lähetä POST-pyyntö osoitteeseen /v1/chat/completions mallitunnuksella "uncensored". Sisällytä system-promptisi ja käyttäjän viestisi messages-taulukkoon. Malli vastaa tekstimuotoisella luodulla sisällöllä ilman sisältökieltoja lailliseen aikuisille suunnattuun käyttöön.

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)

Aseta temperature ja top_p hallitaksesi satunnaisuutta. Käytä stop-sekvenssejä lopettaaksesi tuotannon ajoissa. Vastaus sisältää token-käytön lopullisessa chunkissa, jos streamaus on käytössä.

Node SDK -integraatio

Asenna virallinen OpenAI:n SDK Node.js:lle. Määritä se API-avaimellasi ja tämän oppaan base URL -osoitteella. Kutsu chat.completions.create-metodia kehotteellasi.

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);

Tämä lähestymistapa pitää kustannukset ennustettavina, koska maksat vain käytetyistä tokenneista. Esimaksutili lasketaan todellisen käytön mukaan. Ei kuukausimaksuja. Voit lisätä varoja kryptolla milloin tahansa.

Streamausvastaukset

Ota streamaus käyttöön asettamalla stream arvoksi true pyynnössä. API palauttaa Server-Sent Events -tapahtumia (SSE) lohkoissa. Jokainen lohko sisältää osittaista tekstiä, kunnes viimeinen lohko sisältää token-käytö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)

Streamaus vähentää havaittua viivettä pitkissä vastauksissa. Se mahdollistaa myös edistymisen näyttämisen käyttäjille reaaliajassa. Kontesttilaakso tukee 100 000 merkkiä promptin ja täydennyksen yhteensä.

Nopeusrajoitukset ja konteksti

Sinulla on rajoitus 300 pyyntöä minuutissa avainta kohden. Vain 8 pyyntöä voi juosta samanaikaisesti. Pyyntörungon koko ei saa ylittää 8 megatavua. Nämä rajat varmistavat vakaan suorituskyvyn kaikille käyttäjille.

Malli tukee funktiokutsuja, JSON-tilaa ja vakio-parametreja kuten seed ja presence_penalty. Maksimi tulostus on 16 000 tokenia pyyntöä kohden. Jos et aseta max_tokensia, se olettaa arvon 2 048.

Virheet ja vianmääritys

Virhe 401 tarkoittaa, että API-avain on virheellinen tai vanhentunut. Tarkista aktiivinen avain hallintapaneelista. Virhe 402 tarkoittaa, että esimaksukrediitti on riittämätön. Lisää varoja kryptomaksulla jatkaaksesi. Virhe 429 tarkoittaa, että osuit nopeusrajoitukseen. Odota muutama sekunti ja yritä uudelleen.

Virheet eivät kuluta krediittiasi. Jos tapahtuu kaksoisperintä, käytä Tuki-sivua korjataksesi sen. Krediitti vanhenee, joten voit ladata saldoa myöhemmin.

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"}]
  }'