Whisper boru hatları için hızlı başlangıç
Standart OpenAI uyumlu sohbet tamamlama API'si ile sansürsüz metin modelinizi konuşma veya görüntü boru hatlarınıza entegre edin. Bu kılavuz, istek gönderme, akış işleme ve son işlem görevleri için bağlam penceresi yönetimi için gerekli adımları kapsar.
Önkoşullar
Başlamadan önce, aktif bir hesabınız ve API anahtarınız olduğundan emin olun. Yalnızca e-posta ve şifre kullanarak API anahtarını al sayfasında kaydolun. Anahtar hemen görünür. 7 gün boyunca geçerli $0.50 ücretsiz deneme kredisi alırsınız, kredi kartı gerekmez. Üretim için $10 üzerinden kripto para (USDT veya USDC) ile bakiye yükleyin. Fiyatlandırma basittir: 1M giriş token'ı başına $0.25 ve 1M çıktı token'ı başına $1.00. Krediler asla sona ermez.
Temel URL: https://api.whisperapis.com/v1. Bu uç nokta herhangi bir OpenAI uyumlu istemci ile çalışır. Temel URL'yi yapılandırmanız ve yetkilendirme başlığında API anahtarınızı sağlamanız yeterlidir. Temel HTTP istekleri için özel SDK'lara gerek yoktur.
İstemciyi Başlat
Çoğu geliştirici resmi OpenAI SDK'sını veya uyumlu bir kütüphaneyi kullanacaktır. İstemciyi temel URL'mize işaret ederek başlatın. Bu, tüm isteklerin OpenAI sunucuları yerine sansürsüz modelimize yönlendirilmesini sağlar. Model kimliği her zaman uncensored olarak kalır.
Ortam değişkeni OPENAI_API_KEY değerinin panodan aldığınız anahtar olarak ayarlandığından emin olun. Farklı bir dil veya kitaplık kullanıyorsanız, özel Base URL'leri desteklediğinden emin olun. SDK, JSON serileştirmesini ve başlık enjeksiyonunu sizin için halleder, bu da veri yolunuzdaki kod miktarını azaltır.
Bir Sohbet Tamamlama Gönder
Boru hattı çıktınızı iyileştirmek için standart bir sohbet tamamlama isteği gönderin. Örneğin, konuşmadan metne transkriptlerinden yapılandırılmış JSON çıkarın veya içerik filtreleri olmadan görüntüler için altyazı oluşturun.
Uç nokta POST /v1/chat/completions şeklindedir. Model kimliğini, mesaj dizinizi ve isteğe bağlı olarak sansürsüz davranışı tanımlamak için sistem isteminizi ekleyin.
curl https://api.whisperapis.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."}]
}'Modelimiz yüksek bağlam verilerini iyi işler ve toplamda 100.000 token'a kadar destekler. Bu, uzun transkriptleri veya ayrıntılı görüntü açıklamalarını tek bir işlemde işlemek için idealdir.
Akış Yanıtları
Gerçek zamanlı son işlem veya etkileşimli boru hatları için akışı etkinleştirin. İsteğinizde stream parametresini true olarak ayarlayın. API, tek bir JSON nesnesi yerine Sunucu Tarafı Olayları (SSE) döndürür.
delta alanlarını geldikçe ayrıştırın. Bu, büyük çıktılar için algılanan gecikmeyi azaltır, örneğin ayrıntılı betikler oluşturma veya gürültülü OCR sonuçlarından uzun metin blokları çıkarma. Akış formatı standart OpenAI SDK akış işleyicileri ile uyumludur.
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)İstemcinizin kısmi parçaları doğru şekilde işlediğinden emin olun. Akış finish_reason değeri stop veya length ile bittiğinde tam metin yanıtını yeniden oluşturmak için delta'ları birleştirin.
Araç Çağırma Desteği
Sansürsüz modelimiz fonksiyon çağırma'yı destekler, bu da boru hatlarınız için yapılandırılmış çıktılar tanımlamanıza olanak tanır. Araçlarınızı JSON şema tanımları ile tools dizisinde tanımlayın.
Model, yanıtta araç çağrıları döndürür; bunları konuşma bağlamını güncellemek için çalıştırabilirsiniz. Bu, konuşma transkriptlerinden tarihler, isimler veya koordinatlar gibi belirli veri noktalarını yapılandırılmamış metinden çıkarmak için kullanışlıdır.
from openai import OpenAI
client = OpenAI(base_url="https://api.whisperapis.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)Araç çağrılarını sonraki mesajlarda API'ye iletin. Model, sonuçlara göre çıktısını iyileştirecektir. Bu, sohbet arayüzünden ayrılmadan karmaşık çok adımlı akıl yürütme sağlar. Hatalı JSON yanıtlarından kaçınmak için şemanızın sıkı olduğundan emin olun.
Limitler, Hatalar ve Bağlam
Kesintileri önlemek için kullanımınızı izleyin. API, anahtar başına dakikada 300 istek limiti uygular. Bunu aşarsanız, 429 hız limiti hatası alırsınız. İstemcinizde üstel geri çekilme uygulayın.
Yaygın Hatalar:
401: Geçersiz veya süresi dolmuş API anahtarı. Anahtarınızı panodan yeniden oluşturun.402: Yetersiz kredi. İşlemeye devam etmek için hesabınızı güncelleyin.429: Hız limiti aşıldı. İstek sıklığını azaltın veya daha küçük görevleri toplu olarak işleyin.
Bağlam Penceresi: Model, istem + tamamlama için 100.000 token destekler. Girdiniz bunu aşarsa, eski mesajları kısaltın veya veriyi bölün. İstek gövdeleri 8 MB ile sınırlıdır. Güvenilir performans için yüklerinizin bu kısıtlamalar içinde olduğundan emin olun.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.whisperapis.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);API özellikleri
Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.
| Öğe | Değer |
|---|---|
| Biçim | OpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır |
| Model kimliği | uncensored |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.whisperapis.com/v1 |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| JSON modu | response_format: {"type": "json_object"} |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| İstek boyutu | en fazla 8 MB |
| Hız limiti | anahtar başına dakikada 300 istek |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Ücretsiz deneme | $0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300) |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
| Giriş | Google veya e-posta ve şifre |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
Hata kodları
Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.
| Kod | Tür | Anlamı |
|---|---|---|
400 | bad_request | geçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun |
401 | missing_key · invalid_key · key_revoked | anahtar yok, yanlış veya değiştirilmiş |
402 | no_credit | kredi bitti — yükleyin, hemen devam eder |
403 | content_blocked | reşit olmayanları içeren cinsel içerik — reddedildi, ücret yok |
404 | not_found | bilinmeyen uç nokta |
413 | request_too_large | gövde 8 MB'tan büyük |
429 | rate_limited · concurrency | dakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin |
503 | upstream_busy | model meşgul — birkaç saniye sonra tekrar deneyin |
Sorular ve cevaplar
Bağlam penceresi boyutu nedir?
Model, hem istemi hem de tamamlamayı içeren 100.000 token'lık bir bağlam penceresini destekler. Bu, büyük transkriptleri veya ayrıntılı açıklamaları tek bir istekte işlemenize olanak tanır.
Bu API görüntü veya ses oluşturur mu?
Hayır. Bu, yalnızca metin içeren bir sohbet tamamlama API'sidir. Konuşmadan metne veya görüntü oluşturma gibi diğer modallerden metin çıktılarını son işlemek için tasarlanmıştır. Ses, görüntü veya video oluşturmaz.
Akış hatalarını nasıl yönetirim?
Akış yanıtları SSE olayları döndürür. Bir hata oluşursa, akış genellikle son parçada error alanında bir hata mesajı ile sona erer. İstemcinizin bağlantı kopmalarını zarifçe yönettiğinden ve gerekirse yeniden deneme yaptığından emin olun.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı budur.