API Hızlı Başlangıç: İstemcinizi Sınırlandırılmamış Modelimize Bağlayın
Bu hızlı başlangıç kılavuzu, OpenAI-uyumlu bir istemciyi uncensored metin modelimize nasıl yönlendireceğinizi gösterir. Bir temel URL, bir model id ve anahtarınız gerekir.
Kimlik Doğrulama ve Temel URL
Her istek https://doesgrokhaveanapi.com/v1 ve anahtarınızı Authorization başlıkta bearer token olarak kullanın. Anahtarı API anahtarı al sayfasından kopyalayın; kaydolmadan sonra gösterilir ve istediğiniz zaman değiştirebilirsiniz.
Kısa ve net: Mevcut bir istemciyi taşıdığınızda değişen tek iki değer, temel URL ve anahtardır.
curl https://api.doesgrokhaveanapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the current API endpoint for the model?"}]
}'
Chat Completions Endpoint
Gönder POST /v1/chat/completions bir mesaj listesi ile. Yanıt, OpenAI sohbet tamamlama yanıtıyla aynı yapıdadır, bu nedenle mevcut ayrıştırıcılar çalışmaya devam eder.
- Rolü kullanın
useristeminiz için vesystemtalimatlar için. - Cevabı şuradan okuyun
choices[0].message.content. - Token sayıları şurada döndürülür
usage, ve krediniz buna göre tahsil edilir.
from openai import OpenAI
client = OpenAI(base_url="https://api.doesgrokhaveanapi.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)
Desteklenen Model: 'uncensored'
Model alanını şuraya ayarlayın uncensored. Bu servisteki tek model kimliği olduğu için seçilecek başka bir şey yoktur. GET /v1/models döndürür; bu, anahtarın çalıştığını doğrulamanın hızlı bir yoludur.
Model, kendi sunucularımızda çalışan açık ağırlıklı bir modeldir. Yasal yetişkin, kurgusal veya tartışmalı istekleri reddetmez. Tek katı sınır, reşit olmayanlarla ilgili cinsel içeriktir.
Akış ve Fonksiyon Çağırma
Ekle stream: true sunucu tarafından gönderilen olaylar olarak tokenler almak için. Son parça kullanım sayılarını taşır, böylece ikinci bir çağrı yapmadan istek başına maliyeti loglayabilirsiniz.
İşlev çağırma standart üzerinden çalışır tools ve tool_choice alanlar. Her işlevi bir JSON şemasıyla tanımlayın ve tool_calls yanıtın dizisinde taşır.
stream = 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)
Parametreler: Sıcaklık, Top P ve Durdur
Desteklenen örnekleme parametreleri şunlardır: temperature, top_p, stop, seed, presence_penalty ve frequency_penalty. Kod ve çıkarım için düşük bir sıcaklık, kurgu için ise daha yüksek bir sıcaklık kullanın.
Eğer max_tokens, varsayılan çıktı sınırı 2.048 token'dir. Her istek için kesin maksimum 16.000 token'dir.
JSON Modu ve Yanıt Biçimleri
Ayarla response_format için { 'type': 'json_object' } makineler tarafından okunabilir çıktı gerektiğinde. İsteminde JSON istemeniz de iyi olur, çünkü model hem talimatı hem de formatı takip eder.
- Sistem mesajında ihtiyaç duyduğunuz alanları açıklayın.
- Örneği kısa tutun, iki veya üç anahtar.
- Sonucu veritabanınıza kaydetmeden önce kodunuzda doğrulayın.
Kotası ve Hata Yönetimi
Her anahtar dakikada 300 istek ve aynı anda 8 istek gönderebilir. Gövdesi 8 MB'ın üzerinde olan istekler reddedilir. 401, anahtarın yanlış olduğunu; 402, kredinin bittiğini; 429 ise hız sınırına ulaşıldığını gösterir: Bekleyin ve geri çekilme (backoff) ile yeniden deneyin.
Hatalar ve reddetmeler ücretlendirilmez. Uzun konuşmalar için 100.000 token'lık bağlam penceresini göz önünde bulundurun: İstem ve tamamlama birlikte sayılır.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.doesgrokhaveanapi.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);Sıkça sorulan sorular
Hangi base URL'i kullanmalıyım?
Temel URL olarak https://doesgrokhaveanapi.com/v1 kullanın. Temel URL'yi ve anahtarı değiştirdiğinizde, kodunuzdaki başka hiçbir şeyi değiştirmenize gerek kalmadan herhangi bir OpenAI-uyumlu SDK bunu kabul eder.
Hangi model ID'sini göndermeliyim?
Kısıtlanmamış modeli gönderin. Servisteki tek model budur. Kimliğinizi doğrulayın ve anahtarınızın aktif olduğunu büyük işleri çalıştırmadan önce GET /v1/models çağrısı ile teyit edin.
Neden isteğim 402 hatası döndürüyor?
402 yanıtı, hesap üzerindeki ön ödemeli kredinin tükendiğini gösterir. TRC20 üzerinde USDT veya Base üzerinde USDC ile minimum $20'lik bir yükleme yapın, sonraki istek başarıyla gerçekleşir. Başarısız istekler için ücret alınmaz.
API anahtarınız bir adım uzaktadır
Kaydolun, tokenınızı kopyalayın, uç noktayı güncelleyin. Bu, tüm süreçtir.