Gemma api anahtarı dokümantasyonu

Kimlik Doğrulama ve Temel URL

Her isteği kimlik doğrulamak için benzersiz API anahtarınızı kullanın. Temel URL HTTPS://api.gemmaapikey.com/v1'dir ve anahtarı Authorization başlığında iletirsiniz. Bu, base_url ve API anahtarını değiştirerek herhangi bir OpenAI-uyumlu istemci ile çalışır. Anahtarı kaybederseniz panelden yeni bir tane oluşturabilirsiniz. Eski anahtar hemen çalışmayı bırakır. Hatalar ve reddetmeler ön ödemeli kredinizi tüketmez.

İlk İstek

"uncensored" model kimliği ile /v1/chat/completions adresine POST isteği gönderin. messages dizisine sistem ipucunuzu ve kullanıcı mesajınızı ekleyin. Model, yasal yetişkin kullanım için içerik reddetmeleri olmadan oluşturulan metinle yanıt verir.

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)

Rastgeleliği kontrol etmek için temperature ve top_p değerlerini ayarlayın. Üretimi erken durdurmak için stop dizileri kullanın. Yanıt, streaming etkinleştirildiğinde son chunk'ta token kullanımını içerir.

Node SDK Entegrasyonu

Resmi OpenAI SDK'sını Node.js için yükleyin. API anahtarınız ve bu kılavuzdaki temel URL ile yapılandırın. İsteminizle chat.completions.create yöntemini çağırın.

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

Bu yaklaşım maliyetleri öngörülebilir kılar çünkü yalnızca kullanılan tokenlar için ödeme yaparsınız. Ön ödemeli kredi gerçek kullanım üzerinden yansıtılır. Aylık ücret yoktur. İstediğiniz zaman kripto para ile bakiye yükleyebilirsiniz.

Akış Yanıtları

İsteğinizde stream'i true olarak ayarlayarak akışı etkinleştirin. API Sunucu Tarafı Olayları (SSE) parçaları döndürür. Her parça kısmi metin içerir, son parça token kullanımını içerir.

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)

Akış, uzun yanıtlar için algılanan gecikmeyi azaltır. Ayrıca kullanıcılara ilerlemeyi gerçek zamanlı olarak da gösterebilirsiniz. Bağlam penceresi, istem ve tamamlama için birlikte 100.000 belirteci destekler.

Saniye Başına İstek Limitleri ve Bağlam

Her anahtar başına dakikada 300 istekle sınırlısınız. Sadece 8 istek eşzamanlı çalışabilir. İstek gövdesi 8 MB'ı geçmemelidir. Bu limitler, tüm kullanıcılar için kararlı performansı sağlar.

Model, seed ve presence_penalty gibi standart parametrelerin yanı sıra fonksiyon çağırma ve JSON modunu destekler. Maksimum çıktı isteği başına 16,000 token'dır. max_tokens ayarlanmazsa varsayılan olarak 2,048 değerine düşer.

Hatalar ve Sorun Giderme

Bir 401 hatası, API anahtarınızın geçersiz veya süresi dolmuş olduğunu gösterir. Aktif anahtarınız için panloyu kontrol edin. Bir 402 hatası, yetersiz ön ödemeli kredi olduğunu gösterir. Devam etmek için kripto ile yükleyin. Bir 429 hatası, hız sınırına ulaştığınızı gösterir. Birkaç saniye bekleyin ve yeniden deneyin.

Hatalar kredinizi tüketmez. Çift ücretlendirme yaşarsanız, düzeltmek için Destek sayfasını kullanın. Kredi süresi dolmaz, bu nedenle daha sonra yeniden yükleyebilirsiniz.

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