Qwen AI API Hızlı Başlangıç

Kimlik Doğrulama & Base URL Kurulumu

API anahtarınızı dashboard'da oluşturun. Temel URL https://api.qwenaiapi.com/v1 ve anahtarınızı Authorization header. Bu yapılandırma, kod değişikliği gerektirmeden herhangi bir standart OpenAI SDK istemcisi ile çalışır. Hesap başına bir aktif anahtar alırsınız; yeni bir anahtar oluşturmak öncekini hemen geçersiz kılar. Kayıt için telefon numarası gerekmez.

İlk İstek

Şuraya bir POST isteği gönderin /v1/chat/completions anahtarınız ve model kimliğinizle birlikte. Model tanımlayıcısı uncensored ve standart sohbet mesajlarına yanıt verir. Gecikme süresini ve yanıt formatını doğrulamak için basit bir sistem istemci mesajı ile bağlantı testini yapabilirsiniz. 401 hataları geçersiz bir anahtarı, 402 hataları ise önceden ödenmiş kredinizin tükendiğini gösterir.

Copycurl https://api.qwenaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this pull request diff"}]
  }'

Python SDK Entegrasyonu

Endpoint ile etkileşim kurmak için resmi Python istemcisini kullanın. Base URL ve API anahtarını başlatma parametrelerinde ayarlayın. SDK, tokenizasyonu ve JSON seri hale getirmeyi otomatik olarak yönetir. Bu yaklaşım, altta yatan model sağlayıcısını değiştirirken mevcut uygulama mantığınızı korur. İstemci hem senkron hem de asenkron işlemleri destekler.

Copyfrom openai import OpenAI

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

Node SDK Kullanımı

Node.js istemcisini temel URL'niz ve anahtarınızla başlatın. Paket, standart sohbet tamamlama isteklerini destekler. uncensored uç noktasına eriştiğinizden emin olmak için model kimliğini yapılandırabilirsiniz. Bu entegrasyon, programatik erişim gerektiren sunucu taraflı uygulamalar için idealdir. SDK, yüksek hacimli istekler için bağlantı havuzlamasını verimli bir şekilde yönetir.

Copyimport OpenAI from "openai";

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

Akış Yanıtları

Akışı etkinleştirmek için stream parametresini true olarak ayarlayın. Belirteçler oluşturulurken sunucu tarafından gönderilen olaylar (SSE) alırsınız. Son parça, faturalandırma amacıyla toplam belirteç kullanımını içerir. Bu, metni aşamalı olarak görüntüleyerek kullanıcılar için algılanan gecikmeyi azaltır. Son kullanım verilerini yakalamak için akışı doğru şekilde işlemelisiniz.

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)

Bağlam Penceresi & Sınırları

Model, birleşik istek ve tamamlama için 100.000 token'lık bir bağlam penceresi destekler. İstek başına en fazla 16.000 çıktı token'ı gönderebilirsiniz. Hız sınırları dakikada 300 istek ve anahtar başına 8 eşzamanlı istek sağlar. İstek gövdeleri 8 MB ile sınırlıdır. Bu sınırları anlamak, 429 hatalarına takılmadan isteklerinizi etkili bir şekilde gruplandırmanıza yardımcı olur. Hatalar ön ödemeli kredinizi tüketmez.