Qwen kullanıcıları için hızlı başlangıç

Kimlik Doğrulama ve Temel URL

API'miz standart Bearer token kimlik doğrulamasını kullanır. Google veya e-posta ile kayıt olduktan sonra anahtarınızı hemen alırsınız. Bu anahtarı güvende tutun; ön ödemeli kredinize erişim sağlar. Tüm istekler için temel URL https://api.qwenapi.cc/v1 şeklindedir. İstemci yapılandırmanızı varsayılan OpenAI URL'si yerine bu uç noktaya işaret edecek şekilde güncelleyin.

Kimlik doğrulama, her istekle Authorization başlığı gönderilerek sağlanır. API anahtarı yoksa model bakiyenizi doğrulayamaz ve bu da 401 hatasına neden olur. Gizli başlıklar veya özel kimlik doğrulama şemaları gerekmez.

İlk İstek

Bağlantıyı test etmek için standart bir sohbet tamamlama isteği gönderin. YOUR_API_KEY değerini gerçek anahtarınızla değiştirin. Uç nokta, model, messages ve content alanlarını içeren standart JSON payload'ları kabul eder.

• Model tanımlayıcısı: uncensored
• Uç nokta: POST /v1/chat/completions
• Biçim: JSON

Bu istek, bakiyenizden girdi token'larını tüketir. Bağlantının çalıştığını doğrulamak için istemcinizin JSON yanıtını doğru şekilde işlediğinden emin olun.

Python SDK Entegrasyonu

Resmi OpenAI Python kütüphanesini kullanın. Trafik yönlendirmesi için minimum yapılandırma gerektirir. İstemciyi anahtarınız ve doğru temel URL ile başlatın. Bu yaklaşım, istek mantığını yeniden yazmadan mevcut kod tabanlarından yararlanır.

Yanıt oluştururken uncensored model kimliğini geçin. Kütüphane serileştirme ve ayrıştırma işlemlerini otomatik olarak yönetir. Bu yöntem çoğu arka uç entegrasyonu ve betik tabanlı iş akışları için önerilir.

Node SDK Entegrasyonu

JavaScript veya TypeScript ortamları için @anthropic-ai/sdk veya standart OpenAI Node paketini kullanın. Temel URL'yi bizim API'mize işaret edecek şekilde yapılandırın. Bu sayede mevcut Node uygulamalarımıza hizmetimizi büyük bir yeniden düzenleme yapmadan dahil edebilirsiniz.

Özel temel URL'leri destekleyen SDK'nın güncel bir sürümünü kullandığınızdan emin olun. Sansürsüz modelimizi seçmek için model tanımlayıcısı uncensored'ı geçin. Bu kurulum Express rotaları veya sunucusuz işlevlerle sorunsuz çalışır.

Akışlı Yanıtlar

İsteğinizde stream: true ayarını yaparak akış özelliğini etkinleştirin. API, model metin oluştururken Server-Sent Events (SSE) döndürür. Bu, son kullanıcılar için daha düşük gecikme süresi sağlar ve çıktının gerçek zamanlı olarak görüntülenmesine olanak tanır.

Token kullanım istatistikleri akışın son parçasında dahil edilir. Tam yanıtı oluşturmak için her artışı artımlı olarak işleyin. Bu özellik, anında geri bildirim gerektiren sohbet arayüzleri ve uygulamalar için gereklidir.

Limitler, Hatalar ve Bağlam

Hizmet kesintisini önlemek için hız limitlerine saygı gösterin. API, dakika başına 300 istek ve anahtar başına 8 eşzamanlı istek izni verir. Maksimum istek gövdesi boyutu 8 MB'tır. Bu limitleri aşarsanız 429 hatası alırsınız.

Kimlik doğrulama hataları 401 döndürür, bu da geçersiz veya eksik bir anahtara işaret eder. Bakiye hataları 402 döndürür, bu da ön ödemeli kredinizin tükendiği anlamına gelir. Bağlam penceresi toplamda 100.000 token destekler, istek başına maksimum çıktı 32.000 token'dır. Hatalar ve reddedilen yanıtlar kredileri tüketmez.

cURL

Copycurl https://api.qwenapi.cc/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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qwenapi.cc/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ış

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)