API Dokümantasyonu ve Uç Noktalar
Bu kılavuz, sansürsüz metin üretimi için OpenAI-uyumlu API'mize istemcinizi nasıl bağlayacağınızı gösterir. Temel URL'yi, kimlik doğrulama adımlarını ve tercih ettiğiniz dil için kod örneklerini bulacaksınız.
Kimlik Doğrulama ve Temel URL
API, her istek için geçerli bir anahtar gerektirir. Bu anahtarı, Google veya e-posta adresiyle kaydolduğunuzda anında oluşturursunuz. Anahtarı Authorization header kullanarak Bearer şeması. Temel URL'miz HTTPS://api.unfilteredllms.com/v1'dir ve resmi OpenAI SDK'ları ile herhangi bir OpenAI-uyumlu istemci ile çalışır, sadece base_url yapılandırmasını değiştirerek. HTTPS://api.qwenaipricing.com/v1. Bu URL, resmi OpenAI SDK'ları ve herhangi bir uyumlu istemci ile, temel yapılandırmayı güncelleyerek çalışır.
Sohbet Tamamlamaları Uç Noktası
Birincil uç nokta POST /v1/chat/completionsÜzerine JSON gövdesi kabul eder. messages dizi ve a model alanı. Sınırsız çıktılar için ayarlanmış büyük dil modeline erişmek için model kimliğini "uncensored" olarak ayarlayın. Sohbet bağlamınızı yapılandırmak için sistem, kullanıcı ve asistan rollerini tanımlayabilirsiniz.
curl https://api.qwenaipricing.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the monthly cost for the 72B model?"}]
}'
Yanıt, oluşturulan içeriği, kullanım istatistiklerini ve bitiş nedenini içerir. Hatalar, geçersiz anahtarlar için 401 veya ön ödemeli krediniz tükendiğinde 402 gibi standart HTTP kodlarını döndürür. API, gömme (embedding), görüntü oluşturma veya ince ayar uç noktalarını desteklemez.
Python SDK Entegrasyonu
Resmi openai API ile etkileşim kurmak için Python paketi. İstemciyi API anahtarınızı sağlayarak ve temel URL'yi uç noktamıza ayarlayarak başlatın. Bu, tanınan yöntemleri kullanmanıza olanak tanır chat.completions.create() istemci mantığınızı yeniden yazmadan. Kütüphane JSON serileştirmesini ve yanıt ayrıştırmayı otomatik olarak halleder.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwenaipricing.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)
Mesajlarınızı bir sözlük listesi olarak iletin. SDK temperature ve top_p gibi tüm standart parametreleri destekler. Bu yaklaşım, OpenAI-compatible bir arayüz bekleyen mevcut kod tabanlarıyla uyumluluğu sağlar.
Node.js SDK Entegrasyonu
Node.js SDK Python sürümüne benzer şekilde çalışır. Yükleyin openai package ve base URL ile API anahtarını yapılandırın. Ardından istediğiniz parametrelerle chat completions endpoint'ini çağırabilirsiniz. Bu yöntem, metinleri eşzamansız olarak oluşturması gereken sunucu taraflı uygulamalar veya arka uç hizmetleri için idealdir.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwenaipricing.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ıt akışını veya promise'ı işleyerek oluşturulan tokenları işleyin. SDK, HTTP bağlantısını ve hata yönetimini sizin için yönetir. Ayrıca şunu da kullanabilirsiniz GET /v1/models mevcut model kimliğini doğrulamak için uç nokta.
Akış ve Kullanım
Ayarlayarak akışı etkinleştirin stream: true istekinizde. API, kısmi yanıtların Sunucu Tarafından Gönderilen (SSE) akışını döndürür. Her parça oluşturulan metnin bir parçasını içerir. Bu, metin oluşturuldukça gösteren gerçek zamanlı kullanıcı arayüzleri için kullanışlıdır.
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ıştaki son parça, istek için toplam token kullanımını içerir. Kullanım istatistiklerini izleyerek ön ödemeli kredinizin tüketimini takip edebilirsiniz. Akış sırasında oluşan hatalar bağlantının erken sonlanmasına neden olabilir.
Limitler, Hatalar ve Bağlam Penceresi
Model, istem ve tamamlama için birleşik olarak 100.000 token'lık bir bağlam penceresi destekler. İstek başına maksimum çıkış 16.000 token'dır. Ayarlamazsanız max_tokens, limit 2.048 token'dır. Dakikada 300 istek ve anahtar başına 8 eşzamanlı istekle sınırlısınız. 429 hatası bu limitleri aştığınızı gösterir. Hatalı veya reddedilen istekler kredi tüketmez. API SLA garantileri veya sertifikaları sunmaz.
Sık sorulan sorular
Filtresiz model için context window limiti nedir?
Model, istem ve tamamlama için birleşik olarak 100.000 token'lık bir bağlam penceresi destekler. Tek bir istekte 16.000 token'a kadar üretebilirsiniz.
Kimlik doğrulama hatalarını nasıl yönetebilirim?
Bir 401 hatası, geçersiz veya eksik bir API anahtarı olduğunu gösterir. Anahtarın Authorization başlığında Bearer belirteci olarak iletildiğinden emin olun. Mevcut anahtar iptal edilmişse hesap panelinizden yeni bir anahtar oluşturun.
API Qwen Image gibi görsel oluşturma destekliyor mu?
Hayır, bu API yalnızca sohbet-tamamlama uç noktası aracılığıyla metin üretimi sağlar. Gömme (embeddings), ses, video veya görüntü üretimi desteklemez. Bu modlar için farklı bir uç nokta veya hizmet kullanmanız gerekir.