Temel URL ve Kimlik Doğrulama
API'miz OpenAI Chat Completions standardını takip eder. Servisle etkileşim kurmak için istemcinizi https://api.grokapikey.com/v1 adresine yönlendirmeli ve benzersiz API anahtarınızı Authorization başlığında belirtmelisiniz. Anahtarınızı yalnızca e-posta ve şifre ile kaydolduktan sonra hemen oluşturabilirsiniz. Anahtar oluşturulduğunda bir kez gösterilir, bu nedenle güvenli bir şekilde kaydedin. Kaybettiğinizde dashboardunuzdan yeni bir anahtar yeniden oluşturabilirsiniz; bu işlem öncekinin geçerliliğini anında kaldırır. Deneme hesabı için kredi kartı bağlamanıza gerek yoktur.
İlk İsteğiniz
Bağlantıyı doğrulamak için basit bir metin istemi göndererek başlayın. Model tanımlayıcısı uncensored ile standart chat/completions uç noktasını kullanın. Aşağıdaki örnek, bağlantıyı test etmek için temel bir curl komutu gösterir. Bu, kimlik doğrulamanızın doğru olduğunu ve servisin yanıt verdiğini doğrular. Ardından bu yapıyı özel uygulama mantığınız için uyarlayabilirsiniz.
Bu komutu çalıştırmadan önce YOUR_API_KEY yerine gerçek anahtarınızı yazın.
curl https://api.grokapikey.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
Bir Python uygulaması geliştiriyorsanız, resmi openai kütüphanesini kullanın. İstemciyi temel URL'mize ve API anahtarınıza göre yapılandırın. Bu, sansürsüz modele erişirken tanıdık Python deyimlerinden yararlanmanızı sağlar. İstemci seri hale getirmeyi ve akışı otomatik olarak yönetir. En iyi uyumluluk için ortamınızda kütüphanenin en son sürümünün yüklü olduğundan emin olun.
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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 veya TypeScript projeleri için Node.js OpenAI SDK'sı doğrudan çalışır. Yapılandırma nesnenizde apiKey ve baseURL özelliklerini ayarlayın. Bu, tüm sonraki isteklerin altyapımız üzerinden yönlendirilmesini sağlar. Yanıtları işlemek için standart async/await kalıplarını kullanabilirsiniz. Bu yaklaşım, OpenAI üzerinden proxy olmadan doğrudan API erişimi gerektiren sunucu tarafı uygulamaları veya kenar işlevleri için idealdir.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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ı
Gerçek zamanlı token üretimi avantaj sağlayan uygulamalar için istek gövdenizde stream: true ayarını belirterek akışı etkinleştirin. API, kısmi yanıtlardan oluşan bir Server-Sent Events (SSE) akışı döndürür. Bu, kullanıcılar için algılanan gecikmeyi azaltır ve oluşturulan metnin anında görüntülenmesine olanak tanır. Her parça, yanıtın bir delta'sını içerir. Arayüzü kademeli olarak güncellemek için bu olayları istemci kodunuzda işleyin. Akış, tokenları normal şekilde tüketir ve fiyatlandırmayı etkilemez.
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)Limitler, Hatalar ve Bağlam
Her API anahtarı dakikada 300 istek ve maksimum 8 MB istek gövdesi boyutu ile sınırlıdır. Hız limitini aşarsanız API 429 durum kodunu döndürür; birkaç saniye bekleyip yeniden deneyin. 401 hatası geçersiz veya iptal edilmiş bir anahtarı gösterir; 402 hatası ise ön ödemeli kredinizin tükendiğini belirtir. Model, hem girdi hem de çıktı için toplamda 100.000 token bağlam penceresi destekler. Kısaltma yaşamamak için istemlerinizin bu sınıra sığdığından emin olun. İçerik filtreleri minimum düzeyde kalmaya devam eder; ancak küçükler ile ilgili cinsel içerik için kesin bir engelleme uygulanır.
