Qwen API: İlk istek beş dakika içinde

Temel URL ve Kimlik Doğrulama

API'miz standart OpenAI formatını takip eder, böylece mevcut istemci yapılandırmanızı değiştirmek kolaydır. Tüm istekler için temel URL https://api.qwenapis.com/v1 şeklindedir. İsteklerinizi kimlik doğrulamak için bir API anahtarına ihtiyacınız vardır. Henüz oluşturmadıysanız, yalnızca e-posta ve şifrenizi kullanarak bir anahtar oluşturmak için API anahtarını al sayfasını ziyaret edin. Deneme kredisiyle başlamak için kredi kartı gerekmez.

Her hesap için aynı anda yalnızca bir aktif anahtarla sınırlısınız. Anahtarınızı istediğiniz zaman yenileyebilirsiniz; bu işlem önceki anahtarı hemen geçersiz kılar. Bu, anahtarınız ortaya çıktığında, aylık döngüyü beklemek yerine hesabınızı anında güvende tutmanızı sağlar. Anahtarınızı ortam değişkenlerinde veya gizli yöneticide güvende tutun.

İlk İsteğinizi Gönderin

Kurulumunuzu basit bir metin tamamlama isteği göndererek doğrulayın. Aşağıdaki örnek, sansürsüz modele bir istem göndermek için curl kullanır. YOUR_API_KEY yerine önceki adımda oluşturulan anahtarı yerleştirin. Model kimliği, yasal yetişkin kullanım için içerik reddetmeleri olmadan yanıt vermeye ayarlanmış olan uncensored olarak ayarlanmıştır.

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

Başarılı olursanız, oluşturulan metni içeren bir JSON yanıtı alırsınız. 401 hatası alırsanız anahtarınızın doğru olduğundan emin olun. 402 hatası, ön ödemeli kredinizin tükendiğini gösterir.

Python SDK Entegrasyonu

Python geliştiricileri için resmi OpenAI SDK'sı uç noktamızla doğrudan çalışır. Kütüphaneyi pip kullanarak yükleyin, ardından istemciyi temel URL'mize işaret edecek şekilde yapılandırın. Bu, uygulama mantığınızı önemli ölçüde değiştirmeden chat.completions.create() gibi tanıdık yöntemleri kullanmanızı sağlar. SDK, JSON serileştirmesini ve yeniden deneme mantığını sizin için halleder.

Copyfrom openai import OpenAI

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

api_key ve base_url değerlerini doğru ayarladığınızdan emin olun. Model adı uncensored olarak kalır. Bu yaklaşım, diğer sağlayıcılar için yazılmış kodlarla uyumluluğu sağlar ve farklı uç noktalara geçmeyi veya test etmeyi kolaylaştırır.

Node SDK Kullanımı

Node.js geliştiricileri @anthropic-ai/sdk veya resmi openai npm paketini kullanabilir. İstemciyi temel URL'miz ve API anahtarınızla yapılandırın. İsteğin yapısı diğer OpenAI uyumlu hizmetlerle aynıdır. Bu, sansürsüz Qwen'i mevcut Node.js uygulamalarınıza minimal kod değişikliğiyle entegre etmenizi sağlar.

Copyimport OpenAI from "openai";

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

Asenkron yanıtı uygun şekilde işlediğinizden emin olun. SDK, token kullanım istatistiklerini de içeren tam tamamlama nesnesini döndürür. Bu, ön ödemeli kredi tüketiminizi gerçek zamanlı olarak izlemenize yardımcı olur.

Akışı Etkinleştirin

Daha düşük gecikme süresi ve daha iyi bir kullanıcı deneyimi için isteklerinizde akış özelliğini etkinleştirin. Akış, yanıtı oluşturuldukça token token gönderir ve uygulamanızın çıktıyı aşamalı olarak görüntülemesini sağlar. İsteğinizde stream parametresini true olarak ayarlayın. SDK, yinelenebilir bir parça akışı sağlayacaktır.

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)

Bu durum, uzun formatlı içerik oluşturma veya etkileşimli uygulamalar için özellikle yararlıdır. Her parça kısmi metne sahiptir; bunu görüntü arabelleğinize ekleyebilirsiniz. Akış, model yanıtı tamamladığında veya bağlam sınırına ulaştığında sona erer.

Limitler, Hatalar ve Bağlam

API'miz adil kullanım için belirli limitlere sahiptir. Anahtar başına dakikada 300 istek göndermenize izin verilir. Maksimum istek gövdesi boyutu 8 MB'dir. Bağlam penceresi 100.000 token'dir ve hem istemi hem de tamamlamayı kapsar. Hız limitini aşarsanız 429 hatası alırsınız. Krediniz yetersizse 402 hatası alırsınız. Geçersiz anahtarlar için 401 hatası alırsınız. Bu hatalar, uygulamanızın akışını ve kredi kullanımını etkili bir şekilde yönetmenize yardımcı olur.