Kimlik Doğrulama: API Anahtarınızı Kullanma
API anahtarınız, sunucularımıza gönderdiğiniz her isteği doğrular. Tek bir anahtar hesabınız için oluşturulur ve kontrol paneli üzerinden oluşturulur. Bu anahtarı Authorization header Bearer şemasını kullanarak. Geçersiz bir anahtar gönderirseniz 401 hatası döndürürüz. Ön ödemeli krediniz biterse, devam etmeden önce kripto ile yükleme yapmanızı gerektiren bir 402 hatası döndürürüz.
Temel URL ve Uç Nokta Yapısı
Sohbet tamamlamaları için tüm istekleri tek temel URL'mize yönlendirin. Gömme (embedding), görüntü oluşturma veya ince ayar uç noktaları sunmuyoruz. Standart POST /v1/chat/completions promptlarınızı göndermek için yol. Ayrıca sorgulama yapabilirsiniz GET /v1/models kullanılabilir model tanımlayıcısını doğrulamak için. Bu yapı, özel yönlendirme mantığı olmadan mevcut OpenAI SDK istemcileriyle uyumluluğu sağlar.
Hızlı Başlangıç: ablated AI ile İlk İsteğiniz
uncensored modeli hemen test etmek için basit bir metin isteği gönderin. Resmi OpenAI kitaplığını veya herhangi bir HTTP istemcisini kullanarak mesajınızı POST edin. Model, yasal yetişkin içeriği filtrelemeden bir metin yanıtı döndürür. Yer tutucu anahtarı, panodan aldığınız gerçek kimliğinizle değiştirin.
curl https://api.aiablated.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 version of the api"}]
}'
Bu istek temel etkileşim akışını gösterir. Ablated model'den doğrudan bir yanıt alırsınız. Belirli kullanım durumunuz için kişiliği veya bağlamı tanımlamak için sistem istemini ayarlayın.
Python SDK Entegrasyonu
API'yi uygulamalarınıza entegre etmek için resmi OpenAI Python kütüphanesini kullanın. İstemci yapılandırmasında base URL ve API anahtarını ayarlayın. Bu yaklaşım serileştirmeyi ve hata ayrışmasını otomatik olarak halleder. Yanıt akışı yapabilir veya senkron olarak alabilirsiniz. İstemci kütüphanesi bağlantı yaşam döngüsünü sizin için yönetir.
from openai import OpenAI
client = OpenAI(base_url="https://api.aiablated.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)
Bu kod parçacığı istemciyi doğru şekilde başlatır. Belirli temel URL'mize işaret eder. Akış ve fonksiyon çağırma özellikleriyle tam uyumluluk için en son openai paketini yüklediğinizden emin olun.
Node.js SDK Entegrasyonu
API'yi standart SDK'yı kullanarak JavaScript veya TypeScript projelerinize entegre edin. Base URL'yi hizmetimize işaret edecek şekilde yapılandırın. Bu, tanınmış yöntemleri kullanmanıza olanak tanır chat.completions.create. SDK, istek başlıklarını ve yanıt ayrıştırmayı halleder. Hız sınırları veya kimlik doğrulama hataları için kolayca hata yönetimi ekleyebilirsiniz.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aiablated.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 yapılandırma, Node uygulamanızın doğru şekilde iletişim kurmasını sağlar. Temel URL geçersiz kılma işlemi kritik adımdır. Aksi takdirde SDK, sunucularınız yerine OpenAI bulutuna bağlanmaya çalışır.
Akış Yanıtları ve Token Kullanımı
Sunucu Tarafından Gönderilen Etkinlikler (SSE) aracılığıyla token token yanıtlar alın. Bu, uzun çıktılar için algılanan gecikmeyi azaltır. Akışın son chunk'ı, istek için toplam token kullanımını içerir. Ön ödemeli kredi tüketiminizi gerçek zamanlı olarak izleyebilirsiniz. Ayarlayın stream: true bu modu etkinleştirmek için istek yükünüzde. Bu, sohbet arayüzleri ve canlı metke oluşturması için idealdir.
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)
Bu akış yaklaşımı sorunsuz bir kullanıcı deneyimi sağlar. Son parça kullanım istatistiklerini içerir. Ön ödemeli kredinizi etkili bir şekilde yönetmek için bu sayıları izleyin. Akış sırasında oluşan hatalar SDK tarafından zarif şekilde yönetilir.