TR ▾
API anahtarı al

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.

ÖğeDeğer
BiçimOpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır
Model kimliğiuncensored
Uç noktalarPOST /v1/chat/completions · GET /v1/models
Kimlik doğrulamaAuthorization: Bearer YOUR_KEY
Base URLhttps://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 moduresponse_format: {"type": "json_object"}
Parametrelertemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Fonksiyon çağırmaevet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak
Bağlam penceresi100.000 token (girdi + çıktı)
İstek boyutuen fazla 8 MB
Hız limitianahtar başına dakikada 300 istek
Eşzamanlılıkanahtar 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üklemeUSDT (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
Fiyat1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00
Anahtarlarhesap başına bir aktif anahtar; yenisi eskisinin yerini alır
GirişGoogle veya e-posta ve şifre
İçerikyetiş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.

KodTürAnlamı
400bad_requestgeçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun
401missing_key · invalid_key · key_revokedanahtar yok, yanlış veya değiştirilmiş
402no_creditkredi bitti — yükleyin, hemen devam eder
403content_blockedreşit olmayanları içeren cinsel içerik — reddedildi, ücret yok
404not_foundbilinmeyen uç nokta
413request_too_largegövde 8 MB'tan büyük
429rate_limited · concurrencydakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin
503upstream_busymodel 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.

API anahtarı al