Kimlik Doğrulama ve API Anahtarları
Hemen API anahtarınızı almak için bir hesap oluşturmaya başlayın. Telefon numarası gerekmeden Google veya e-posta şifresi kullanarak kaydolabilirsiniz. Sistem hesabı başına bir aktif anahtar oluşturur ve yeni bir anahtar oluşturmak eski olanı anında değiştirir. Başlamak için yalnızca bir e-posta adresine ihtiyacınız vardır ve istemleriniz eğitim için kullanılmaz. Bu anahtarı şurada kullanın Authorization header'ı tüm istekler için bearer token olarak kullanın.
İlk İstek
API anahtarınızı kullanarak chat completions uç noktasına ilk çağrınızı yapın. Temel URL https://api.aidphn.com/v1 ve standart OpenAI-uyumlu istemcilerle çalışır. Model uncensored filtrelenmemiş büyük dil modele erişim. Hatalar ve reddetmeler ön ödemeli kredilerinizi tüketmez, bu nedenle güvenle test edebilirsiniz.
curl https://api.aidphn.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 Rust crates for async HTTP clients"}]
}'
Anahtarınızın çalıştığını model listesi uç noktasını kontrol ederek doğrulayın. Bu, karmaşık istemler göndermeden önce bağlantıyı onaylar. API, metni girdi olarak kabul eder ve metni döndürür; sıcaklık ve top_p gibi standart parametreleri destekler.
Python SDK Entegrasyonu
Resmi OpenAI Python kütüphanesini endpoint'imizle etkileşim kurmak için kullanın. Base URL'yi API sunucumuza ayarlayın ve anahtarınızı sağlayın. Bu yaklaşım, büyük değişiklikler yapmadan mevcut OpenAI projelerinden gelen kodu yeniden kullanmanıza olanak tanır. Model ID'si uncensored tüm tamamlamalar için.
from openai import OpenAI
client = OpenAI(base_url="https://api.aidphn.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)
Parametreleri şu şekilde yapılandırabilirsiniz: max_tokens çıktı uzunluğunu kontrol etmek için. Varsayılan maksimum çıktı 2.048 token'dir ancak her istek için bunu 16.000'e kadar artırabilirsiniz. Gecikmeyi azaltmak için uzun yanıtlar için akış (streaming) mevcuttur.
Node SDK Kullanımı
API'yi standart SDK kullanarak Node.js uygulamalarınıza entegre edin. İstemciyi temel URL'mize yönlendirin ve anahtarınızla kimlik doğrulaması yapın. Bu yöntem esnek entegrasyon için hem senkron hem de asenkron istekleri destekler. Fonksiyon çağırma için araçlar iletebilir veya JSON çıktı modlarını zorunlu kılabilirsiniz.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aidphn.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);
Yanıtları, tamamlama nesnesinden içerik alanını ayrıştırarak yönetin. API, standart parametreleri destekler. stop ayarlayabilirsiniz. seed yeniden üretilebilirlik için. Hata yönetimi, hız sınırlamalarını ve bakiye durumunu dikkate almalıdır.
SSE Üzerinden Akış Yanıtları
Ayarlayarak akışı etkinleştirin stream: true istekinizde. API, gerçek zamanlı token teslimi için Sunucu Tarafından Gönderilen Etkinlikler (SSE) döndürür. Her parça kısmi içerik içerir, bu da çıktıyı oluşturulurken görüntülemenizi sağlar. Son parça, faturalandırma şeffaflığı için toplam token kullanımını içerir.
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)
Akış, uzun yanıtlar bekleyen kullanıcılar için algılanan gecikmeyi azaltır. Belirtileri artımlı olarak işleyebilir veya daha sonra kullanmak üzere arabelleğe alabilirsiniz. Bağlam penceresi, istem ve tamamlama için birlikte 100.000 belirtece kadar destekler.
Limitler ve Hatalar
Sıkı hız limitleri ve kredi bakiyeleriyle kullanımınızı izleyin. Dakika başına 300 istek gönderebilir ve anahtar başına 8 eşzamanlı isteğiniz olabilir. Maksimum istek gövdesi boyutu 8 MB'tır. 401 gibi hatalar geçersiz bir anahtarı belirtir, 402 ise yenileme yapmanız gerektiğini gösterir. 429 hataları hız limitini aştığınızı işaret eder. Hizmeti kesintisiz kullanmaya devam etmek için yalnızca kripto ile yenileyin, başlangıç $20'den.