Dokumentasi kunci API Gemma

Pengesahan dan URL Asas

Gunakan kunci API unik anda untuk mengesahkan setiap permintaan. URL asas ialah HTTPS://api.gemmaapikey.com/v1 dan anda menghantar kunci dalam header Authorization. Ini berfungsi dengan mana-mana klien serasi OpenAI dengan menukar base_url dan kunci API. Jika anda kehilangannya, jana yang baharu dari papan pemuka. Kunci lama akan berhenti berfungsi serta-merta. Ralat dan penolakan tidak menggunakan kredit prabayar anda.

Permintaan Pertama

Hantar permintaan POST ke /v1/chat/completions dengan model id "uncensored". Sertakan prompt sistem dan mesej pengguna anda dalam array messages. Model memberi respons dengan teks yang dijana tanpa penolakan kandungan untuk penggunaan dewasa yang sah.

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)

Tetapkan suhu dan top_p untuk mengawal rawak. Gunakan jujukan stop untuk menghentikan penjanaan awal. Respons termasuk penggunaan token dalam potongan akhir jika streaming diaktifkan.

Integrasi SDK Node

Pasang SDK rasmi OpenAI untuk Node.js. Konfigurasikan dengan kunci API anda dan URL asas dari panduan ini. Panggil kaedah chat.completions.create dengan arahan anda.

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

Pendekatan ini mengekalkan kos yang boleh diramal kerana anda hanya membayar untuk token yang digunakan. Kredit pra-dibayar dicalarkan berdasarkan penggunaan sebenar. Tiada yuran bulanan dikenakan. Anda boleh menambah baki dengan kripto pada bila-bila masa.

Respons Streaming

Aktifkan aliran dengan menetapkan stream kepada true dalam permintaan anda. API mengembalikan potongan Acara Dikirim Pelayan (SSE). Setiap potongan mengandungi teks separa sehingga potongan akhir termasuk penggunaan 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)

Penstriman mengurangkan latensi yang dirasakan untuk respons panjang. Ia juga membolehkan anda memaparkan kemajuan kepada pengguna secara masa nyata. Jendela konteks menyokong 100,000 token untuk permintaan dan penyelesaian bersama-sama.

Had had laju dan konteks

Anda terhad kepada 300 permintaan setiap minit per kunci. Hanya 8 permintaan boleh berjalan serentak. Badan permintaan tidak boleh melebihi 8 MB. Had ini memastikan prestasi stabil untuk semua pengguna.

Model ini menyokong panggilan fungsi, mod JSON, dan parameter piawai seperti seed dan presence_penalty. Output maksimum ialah 16,000 token setiap permintaan. Jika anda tidak menetapkan max_tokens, ia akan ditetapkan secara lalai kepada 2,048.

Ralau dan Penyelesaian Masalah

Kesilapan 401 bermaksud kunci API anda tidak sah atau telah luput. Semak papan pemuka untuk kunci aktif anda. Kesilapan 402 menunjukkan kredit pra-dibayar tidak mencukupi. Tambah nilai melalui kripto untuk terus menggunakan perkhidmatan. Kesilapan 429 bermaksud anda telah mencapai had kadar. Tunggu beberapa saat dan cuba lagi.

Kesilapan tidak menggunakan kredit anda. Jika berlaku caj berganda, gunakan halaman Sokongan untuk membetulkannya. Kredit tidak luput, jadi anda boleh menambah baki kemudian.

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