Gemma API: İlk istek beş dakikada

Base URL & Kimlik Doğrulama

İşleme API anahtarını al sayfasında bir hesap oluşturarak başlayın. Deneme kredisi için yalnızca bir e-posta ve şifre yeterlidir; telefon numarası veya kredi kartı gerekmez. Kayıt olduktan sonra API anahtarınız hemen görüntülenir. Bu anahtarı kopyalayın ve güvenli bir yerde saklayın. Tüm isteklerde Authorization başlığı altında Bearer token olarak kullanın. Tüm uç noktalar için temel URL https://api.gemma4api.com/v1 şeklindedir. Bu URL, yapılandırmanızdaki temel URL'yi ve API anahtarını değiştirerek sağlayıcı değiştirmenize olanak tanıyan herhangi bir standart OpenAI uyumlu istemci ile çalışır.

İlk İstek

Bağlantı doğrulamak için curl kullanarak ilk isteminizi gönderin. YOUR_API_KEY yerine gerçek anahtarınızı yazın. Model tanımlayıcısı uncensored şeklindedir. Bu basit metin-giriş, metin-çıkış isteği kimlik doğrulamanızın doğru olduğunu ve modelin yanıt verdiğini doğrular. choices dizisi içeren bir JSON yanıtı alırsanız kurulumunuz tamamlanmış demektir. Artık daha karmaşık iş akışları için SDK'yı entegre edebilirsiniz.

Copycurl https://api.gemma4api.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK Entegrasyonu

Resmi OpenAI Python paketini yükleyin. Temel URL ve API anahtarı ortam değişkenlerini ayarlayın veya bunları istemci yapıcısına doğrudan iletin. Özel örneğimizi çağırdığınızdan emin olmak için uncensored model kimliğini kullanın. Bu yaklaşım, kodunuzun standart OpenAI kalıplarıyla uyumlu kalmasını sağlarken içerik üretimi için sansürsüz modelimizi kullanmanızı sağlar. SDK, yeniden denemeleri ve JSON ayrıştırmayı otomatik olarak halleder.

Copyfrom openai import OpenAI

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

Node.js SDK Entegrasyonu

JavaScript ortamları için OpenAI Node.js paketini yükleyin. İstemciyi https://api.gemma4api.com/v1 temel URL'si ve API anahtarınızla yapılandırın. Tamamlama isteklerinizde uncensored model kimliğini kullanın. Bu kurulum, sunucularımızda barındırılan spesifik model davranışından yararlanırken standart OpenAI uyumlu kod yapılarını korumanıza olanak tanır. Node.js olay döngüsü içinde asenkron yanıtları doğru şekilde işlediğinizden emin olun.

Copyimport OpenAI from "openai";

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

Akış Yanıtları

API isteğinizde stream parametresini true olarak ayarlayarak akışı etkinleştirin. Bu, tokenlar oluşturuldukça görüntülemenize olanak tanıyan bir Sunucu Tarafı Olayları (SSE) akışı döndürür. Bu, gecikmenin önemli olduğu sohbet arayüzleri için idealdir. Her parça, yanıtın kısmi bir delta'sını içerir. Üretimin tamamlandığını bilmek için akış sonu olayını işleyin. Bu yöntem, tam yanıtın beklenmesine kıyasla algılanan gecikmeyi önemli ölçüde azaltır.

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)

Limitler, Hatalar & Bağlam Penceresi

İstekleriniz, hem istem hem de yanıt için birlikte 100.000 token'lık bir bağlam penceresi destekler. Hız limiti, anahtar başına dakikada 300 istektir ve maksimum istek gövdesi boyutu 8 MB'dir. Yaygın hatalar arasında geçersiz anahtarlar için 401, ön ödemeli krediniz tükendiğinde 402 ve dakikalık limiti aştığınızda 429 yer alır. API anahtarınızı yeniden oluşturmak eskisini iptal eder ancak hız sayacını sıfırlamaz. Sorunsuz çalışmayı sürdürmek için istemcinizin bu HTTP durum kodlarını uygun şekilde işlediğinden emin olun.