OpenAI Uyumlu API: İstemcinizi üç satırda değiştirin
İstemcinizi üç satırda değiştirin: temel URL'yi ve API anahtarını değiştirin, ardından mevcut kodunuzu koruyun. Bu drop-in OpenAI uyumlu API, şeffaf token başına fiyatlandırma ile sansürsüz LLM API deneyimi sunar.
- Temel URL
- https://api.openaicompatibleapi.com/v1
- Model
- sansürsüz
Önkoşullar: OpenAI SDK'yı Yükleyin
İstek göndermeden önce geliştirme ortamınızda tercih ettiğiniz dil için resmi OpenAI SDK'sının yüklü olduğundan emin olun. Bu, geliştiricilerin OpenAI uyumlu API ile etkileşime girmesinin standart yoludur ve tutarlı yazım ile hata işleme sağlar. Python için pip install openai kullanın. Node.js için npm install openai çalıştırın. Bu kütüphaneler altta yatan HTTP ayrıntılarını yönetir, böylece istemleri iletmek ve metin çıktıları almak üzerine odaklanabilirsiniz.
Temel URL'yi ve API Anahtarını Yapılandırın
Hizmetimizin temel avantajı, yalnızca iki yapılandırma değerini güncellemeniz gerektiğidir. İstemcinizi temel URL'mize yönlendirin: https://api.openaicompatibleapi.com/v1. Ardından kayıt sayfasında API anahtarınızı oluşturun; kredi kartı gerekmeden hemen gösterilir. İstemci başlatmasında base_url ve api_key değerlerini ayarlayın. Bu, mantığı yeniden yazmadan mevcut projeleriniz için doğrudan GPT API alternatifi olmamızı sağlar.
İlk İsteğinizi Gönderin
uncensored model kimliğini kullanarak standart bir sohbet tamamlama isteği gönderin. Bu model, yasal yetişkin kullanım için içerik reddi olmadan yanıt vermeye ayarlanmış açık ağırlıklı bir büyük dil modelidir. GPT, Claude veya başka bir satıcının modeli değildir. Basit bir metin istemiyle bağlantıyı hemen test edebilirsiniz. Yanıt, oluşturulan metni content alanında döndürür.
curl https://api.openaicompatibleapi.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."}]
}'
Akış Yanıtlarını Etkinleştirin
Daha iyi kullanıcı deneyimi için, tokenlar oluşturulurken almak üzere akışı etkinleştirin. İsteğinizde stream=True ayarlayın. SDK, parçalar geldiğinde bunları verecektir, böylece kısmi sonuçları anında görüntüleyebilirsiniz. Bu, 100.000 tokena kadar uzun bağlam pencereleri için özellikle yararlıdır. Akış, standart OpenAI istemcileriyle aynı şekilde çalışır ve mevcut hata işleme mantığınızla uyumluluğu korur.
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)
Araç Çağırma (Fonksiyon Çağırma) Kullanın
API'miz yapılandırılmış araç çağırma destekler. İşlevlerinizi tools parametresinde tanımlayın ve model yanıtta araç çağrıları döndürür. Ardından bu araçları çalıştırabilir ve sonuçları modelin daha fazla muhakeme yapması için modele gönderebilirsiniz. Bu özellik, standart araç çağırma formatını destekleyen herhangi bir OpenAI uyumlu istemci ile çalışır. Karmaşık bir LLM proxy'si yönetmeden ajanlar oluşturmak veya iş akışlarını otomatikleştirmek için idealdir.
from openai import OpenAI
client = OpenAI(base_url="https://api.openaicompatibleapi.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)
Mevcut Modelleri Kontrol Edin
Mevcut modelleri doğrulamak için GET /v1/models uç noktasını sorgulayın. uncensored modelinin listelendiğini göreceksiniz. Bu, API anahtarınızın ve temel URL'nizin doğru yapılandırıldığını doğrular. Bu uç noktayı kimlik doğrulama sorunlarını hata ayıklamak için de kullanabilirsiniz. Uç nokta bir liste döndürürse, geliştiriciler için ai api bağlantınız etkindir. Diğer hiçbir model sunulmaz, bu da yapılandırmayı basit tutar.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.openaicompatibleapi.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);Teknik özellikler
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 |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Model kimliği | uncensored |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.openaicompatibleapi.com/v1 |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| JSON modu | response_format: {"type": "json_object"} |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| 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 |
| İstek boyutu | en fazla 8 MB |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Ü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) |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
| Giriş | Google veya e-posta ve şifre |
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
Hız limitleri nelerdir?
Her API anahtarı için dakika başına 300 istekle sınırlısınız. İstek gövdesi boyutu 8 MB ile sınırlıdır. Limiti aşarsanız 429 hatası alırsınız. İlişkiyi sıfırlamak için anahtarınızı istediğiniz zaman yeniden oluşturabilirsiniz; ancak hız limiti anahtara uygulanır.
Neden 401 veya 402 hatası alıyorum?
401 hatası, geçersiz veya süresi dolmuş bir API anahtarı olduğunu gösterir. 402 hatası, ön ödemeli kredinizin tükendiğini belirtir. Sınırsız ücretsiz bir katman sunmuyoruz; sansürsüz LLM API'sini kullanmaya devam etmek için bakiye yüklemeniz gerekir. Kredi süresi dolmaz, bu nedenle kredi (USDT veya USDC) ile 10 $'dan başlayan şekilde bakiye yükleyebilirsiniz.
Bağlam penceresi gerçekten 100k mı?
Evet, model hem istem hem de tamamlama için toplam 100.000 token bağlam penceresini destekler. Bu, kapsamlı belge işleme veya uzun konuşmalar için olanak sağlar. Kesme veya hatalardan kaçınmak için girdilerinizin bu sınıra uygun olduğundan emin olun.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı bu.