İlk istek beş dakikada

OpenAI SDK'sını yükleyin

Uç noktamız standart chat.completions protokolünü izler, bu nedenle tercih ettiğiniz dilin resmi SDK'larını kullanabilirsiniz. Python için paketi pip aracılığıyla yükleyin. Node.js için npm kullanın. Bu kütüphaneler serileştirme, yeniden deneme ve akış işlemlerini hazır olarak yönetir.

pip install openai

npm install openai

tool_choice ve response_format gibi tüm parametreleri desteklemek için SDK'nın güncel bir sürümünü kullandığınızdan emin olun. İstemci kitaplığı HTTP isteklerini yönetir, bu nedenle yalnızca yük yapısına odaklanmanız yeterlidir.

Temel URL ve Anahtarı Yapılandırın

İstemcinizi özel uç noktamıza yönlendirin. Model adı mantığını değiştirmenize gerek yoktur; isteklerinizde model: "uncensored" geçirmenizi bekliyoruz. Kimlik doğrulama, başlıkta geçirilen basit bir API anahtarı ile yapılır.

base_url değerini https://api.qwenapi.top/v1 olarak ayarlayın. qwen api key değerini panelde oluşturun. Anahtar, kayıttan hemen sonra gösterilir. İlk kurulum için telefon numarası veya kredi kartı gerekmez.

Temel Sohbet Tamamlama İsteği

Standart bir tamamlama isteği gönderin. Model, metin yanıtlarını doğrudan döndürür. Karmaşık yönlendirme katmanları yoktur; sansürsüz çıktılar için ayarlanmış tek bir örnekle konuşuyorsunuz.

Bağlantı ve yanıt formatını doğrulamak için curl kullanan minimal bir örnek aşağıda verilmiştir.

Copycurl https://api.qwenapi.top/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."}]
  }'

Yanıt, choices[0].message.content içinde oluşturulan metni içerir. Yaratıcılığı kontrol etmek için temperature ve top_p gibi parametreleri ayarlayabilirsiniz.

Akış Yanıtları

Gerçek zamanlı token üretimi için akışı etkinleştirin. Sunucu SSE (Sunucu Gönderimli Olaylar) gönderir. Son parça token kullanım istatistiklerini içerir, böylece kredi tüketimini doğru şekilde izleyebilirsiniz.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.qwenapi.top/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)

Akış, uzun çıktılar için gereklidir. Akışı ayrıştırabilir ve tokenları geldikçe işleyebilirsiniz. SDK, SSE ayrıştırmayı otomatik olarak yönetir.

Fonksiyon Çağırma Desteği

İsteğinizde araçları tanımlayın. Model yapılandırılmış araç çağrıları döndürür. Aracı çalıştırın, sonucu geri iletin ve model devam eder. Bu, tool_choice ve standart fonksiyon tanımları ile çalışır.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qwenapi.top/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);

JSON modu ayrıca response_format aracılığıyla da mevcuttur. Araç yükü olmadan sıkı JSON çıktısı gerektiğinde kullanın.

Sınırlar, Hatalar ve Bağlam

Bağlam penceresi toplam 100.000 token'dır. İstek başına maksimum çıktı 32.000 token'dır (belirtilmezse 2.048). Hız limiti dakikada 300 istek ve anahtar başına 8 eşzamanlı istektir. İstek gövdeleri 8 MB altında kalmalıdır.

Hataları yönetin: 401 geçersiz anahtar anlamına gelir, 402 yetersiz kredi anlamına gelir, 429 hız limitinin aşıldığı anlamına gelir. Hatalar ücretsizdir; yalnızca tüketilen tokenlar için ödeme yaparsınız. Kredi hiç sona ermez. Çift ücretlendirme olursa, düzeltme için Destek sayfasını kullanın.

Akış

Copystream = 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)