Unhinged Grok kullanıcıları için hızlı başlangıç

Kimlik Doğrulama ve Temel URL

API'miz OpenAI ile uyumludur, bu nedenle yeni bir kütüphaneye ihtiyacınız yoktur. Mevcut yapılandırmanızda yalnızca base_url ve api_key değerlerini güncellemeniz yeterlidir. API anahtarınız Google veya e-posta ile kaydolduğunuzda hemen oluşturulur. Bu anahtarı güvende tutun; kimlik doğrulama için gereken tek kimlik bilgisi budur.

Standart OpenAI base URL'sini bizim uç noktamızla değiştirin. Bu değişiklik, sonraki tüm istekleri sansürsüz model sunucularımıza yönlendirir. Temel metin üretimi için başka kod değişikliğine gerek yoktur.

Yapılandırma Örneği

• Base URL: https://api.unhingedgrok.com/v1
• API Anahtarı: Panelden aldığınız benzersiz anahtar

Mevcut modelleri listelemek için bağlantınızı doğrulayın. Bu, üretim isteklerini göndermeden önce kimlik doğrulamanızın doğru çalıştığını onaylar.

İlk İstek

Basit bir metin tamamlama isteği göndererek başlayın. Bu örnek, ham HTTP yapısını göstermek için curl kullanır. İstek, model ID'si uncensored ile /v1/chat/completions uç noktasını hedef alır. Yanıt, oluşturulan metni choices dizisi içinde döndürür.

Bu doğrudan yaklaşım standart OpenAI HTTP formatlarını destekleyen herhangi bir dil veya araç için çalışır. Anahtarınızı oluşturduktan hemen sonra bunu test edebilirsiniz.

Doğrudan HTTP İsteği

Kopyalacurl https://api.unhingedgrok.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

API'mizi entegre etmek için resmi OpenAI Python kütüphanesini kullanın. Paketi pip aracılığıyla yükleyin. İstemciyi anahtarınız ve özel base URL ile başlatın. chat.completions.create gibi SDK yöntemleri, OpenAI için belgelendirildiği şekilde tam olarak çalışır.

Bu yöntem arka uç hizmetleri, veri işleme betikleri veya otomatik iş akışları için idealdir. SDK, JSON serileştirmesini ve yanıt ayrışmasını otomatik olarak halleder.

Python Kod Örneği

Kopyalafrom openai import OpenAI

client = OpenAI(base_url="https://api.unhingedgrok.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 ortamları için resmi openai npm paketini kullanın. İstemciyi aynı base URL ve anahtarla yapılandırın. Node SDK hem geri çağrı hem de vaat (promise) tabanlı desenleri destekler.

Bu kurulum, sansürsüz metin üretimini doğrudan web uygulamalarına, sunucusuz işlevlere veya Node tabanlı otomasyon araçlarına yerleştirmenizi sağlar. Hata işleme, standart OpenAI SDK davranışıyla tutarlı kalır.

Node.js Kod Örneği

Kopyalaimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.unhingedgrok.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ışlı Yanıtlar

stream: true ayarlayarak gerçek zamanlı token üretimini etkinleştirin. API, Sunucu Tarafı Olayları (SSE) akışı döndürür. Her parça kısmi bir yanıt içerir. Son parça token kullanım istatistiklerini içerir.

Akış, son kullanıcılar için algılanan gecikmeyi azaltır. Sohbet arayüzleri ve etkileşimli uygulamalar için gereklidir. Arayüzü hemen güncellemek için her parçayı artımlı olarak işleyin.

Akış Kod Örneği

Kopyalastream = 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

Hizmet kesintilerini önlemek için işletimsel kısıtlamaları anlayın. Bağlam penceresi toplamda 100,000 token destekler ve max_tokens ayarlanmazsa yanıt pencerenin sonuna kadar uzayabilir.

Hız limitleri anahtar başına dakikada 300 isteğe izin verir. Eşzamanlı istekler 8 ile sınırlıdır. İstek gövdeleri 8 MB'ı geçmemelidir. Standart HTTP hata kodlarını işleyin: 401 geçersiz bir anahtarı, 402 yetersiz krediyi ve 429 hız limitini belirtir. Hatalar krediden düşülmez.