Tek API: Hızlı Başlangıç Kılavuzu
Tek bir yapılandırma değişikliğiyle sansürsüz LLM API'mizi entegre edin. Tak-çalıştır uyumluluğu, temel URL ve API anahtarını değiştirdikten sonra mevcut kodunuzu korumanız gerektiği anlamına gelir.
Temel URL & Kimlik Doğrulama
İstemcinizi özel OpenAI uyumlu API uç noktamıza yönlendirerek başlayın. Standart kimlik doğrulama başlıklarını kullandığından, yapılandırmanızda yalnızca iki değeri değiştirmeniz yeterlidir.
Temel URL https://api.onekeyllmapi.com/v1 şeklindedir. Benzersiz API anahtarınızı kayıt sayfasında oluşturun. Başlamak için kart gerekmez ve anahtar kayıt sırasında hemen gösterilir. Anahtarı güvende tutun; hizmete yapılan tüm isteklerde kimlik doğrulaması yapar.
Temel Tamamlama
Doğrudan yanıt almak için basit bir metin istemi gönderin. Bu, modelin yasal yetişkin kullanımı için içerik reddi olmadan metin döndürdüğü, yaratıcı veya kısıtlamasız görevler için ideal olan geliştiriciler için AI API teklifimizin özüdür.
- Model Kimliği:
uncensored - Uç Nokta:
POST /v1/chat/completions - Bağlam: 100.000 token
İlk isteğinizi bu örnekle yapın:
curl https://api.onekeyllmapi.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
Hizmetimizle etkileşim kurmak için resmi OpenAI Python kütüphanesini kullanın. Gerekli tek değişiklikler base_url ve api_key'dir. Bu, mevcut mantığınızın değişiklik olmadan çalışmasını sağlar.
pip install openaiile yükleyin- Ortam değişkenlerini ayarlayın veya istemci başlatmasında doğrudan iletin
chat.completions.create()'yi olduğu gibi çağırın
İstemciyi şu şekilde yapılandırın:
from openai import OpenAI
client = OpenAI(base_url="https://api.onekeyllmapi.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 Kullanımı
Standart OpenAI Node paketini kullanarak JavaScript veya TypeScript projelerine entegre edin. İstemciyi URL'mize yönlendirin ve anahtarınızı sağlayın. Bu yaklaşım, herhangi bir OpenAI uyumlu istemci yapısıyla uyumluluğu korur.
npm install openaiile yükleyin- Özel temel URL ile başlatın
- Standart async/await kalıplarını kullanın
Örnek başlatma:
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.onekeyllmapi.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ı
Daha düşük algılanan gecikme için yanıtı token token alın. akış api'imiz Sunucu Tarafı Olayları (SSE) destekler, böylece çıktı oluşturulurken görüntüleyebilirsiniz. Bu, sohbet arayüzleri veya gerçek zamanlı uygulamalar için kullanışlıdır.
- İsteğinizde
stream: trueayarlayın - İstemcide SSE akışını ayrıştırın
- Kısmi token'ları verimli şekilde işleyin
Kodunuzda akışı etkinleştirin:
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 & Bağlam
Sağlam entegrasyonlar oluşturmak için kısıtlamaları anlayın. API 100k bağlam api penceresi destekler; bu da uzun belgeleri veya konuşmaları mümkün kılar. İstekler 8 MB gövde boyutu ile sınırlıdır.
Yaygın hatalar arasında geçersiz anahtarlar için 401, ön ödemeli kredi tükendiğinde 402 ve dakikada 300 isteği aşmak için 429 yer alır. Kullandıkça öde kredisi hiçbir zaman süresi dolmaz ve 10 $'dan başlayan bakiye yükleyebilirsiniz. Fonksiyon yürütme için fonksiyon çağırma desteklenir.
API özellikleri
Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.
| Öğe | Değer |
|---|---|
| Biçim | OpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır |
| Model kimliği | uncensored |
| Base URL | https://api.onekeyllmapi.com/v1 |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| JSON modu | response_format: {"type": "json_object"} |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| İstek boyutu | en fazla 8 MB |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Hız limiti | anahtar başına dakikada 300 istek |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Ücretsiz deneme | $0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300) |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
| Giriş | Google veya e-posta ve şifre |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
Hata kodları
Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.
| Kod | Tür | Anlamı |
|---|---|---|
400 | bad_request | geçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun |
401 | missing_key · invalid_key · key_revoked | anahtar yok, yanlış veya değiştirilmiş |
402 | no_credit | kredi bitti — yükleyin, hemen devam eder |
403 | content_blocked | reşit olmayanları içeren cinsel içerik — reddedildi, ücret yok |
404 | not_found | bilinmeyen uç nokta |
413 | request_too_large | gövde 8 MB'tan büyük |
429 | rate_limited · concurrency | dakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin |
503 | upstream_busy | model meşgul — birkaç saniye sonra tekrar deneyin |
Sorular ve cevaplar
Bu bir OpenAI modeli mi?
Hayır. Kendi GPU sunucularımızda çalışan tek bir özel sansürsüz büyük dil modeli sunuyoruz. GPT, Claude veya başka bir satıcının modeli değil, ancak API yapılarıyla uyumludur.
Fiyatlandırma nasıl çalışır?
Aylık ücreti olmayan, kullandıkça öde modelini kullanıyoruz. Giriş token'ları 1M başına $0,25, çıktı token'ları 1M başına $1,00'dır. Ön ödemeli kredi hiç sona ermez ve $0,50'lik deneme kredisi ile başlayabilirsiniz.
Bağlam penceresi boyutu nedir?
API, hem istem hem de tamamlama için 100.000 token'lık bir bağlam penceresi destekler. Bu, tek bir istek içinde kapsamlı sohbetlere veya uzun belge işleme imkânı verir.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı budur.