Tek uç nokta üzerinden istemler ve komut dosyaları
Sansürsüz metin API anahtarınızı alın ve dakikalar içinde stableaudio metin pipeline'ınıza istek göndermeye başlayın. Tahmin edilebilir ön ödeme faturalandırması ile istem mühendisliği, altyazı veya son işleme için OpenAI uyumlu uç noktasını kullanın.
Temel URL ve Kimlik Doğrulama
Herhangi bir standart OpenAI uyumlu istemci ile https://api.stableaudio.top/v1 temel URL'sini kullanın. API anahtarınızı Authorization başlığında Bearer YOUR_API_KEY olarak iletin. API anahtarı sayfasında Google veya e-posta + şifre kullanarak anında bir anahtar oluşturabilirsiniz. Her hesap bir aktif anahtar destekler; yeni bir anahtar çıkarmak önceki anahtarı değiştirir. Uç nokta yalnızca POST /v1/chat/completions ve GET /v1/models destekler. Gömme vektörleri, görüntü, ses veya video üretimi burada mevcut değildir. Bu, ses işleme hattınız için metin tabanlı bir katmandır.
İlk İsteğinizi Gönderin
Metin oluşturmak için standart bir sohbet tamamlama isteği gönderin. Model kimliği uncensored'dir. Yasal yetişkin konularda daha az içerik reddi için ayarlanmış açık ağırlıklı bir modeldir. temperature ve top_p gibi parametreleri ayarlayabilirsiniz. Modelin 100.000 token'lık bir bağlam penceresi vardır. Yanıt başına 32.000 token'a kadar istekte bulunabilirsiniz. Fiyatlandırma şeffaftır: 1M girdi token başına $0,15 ve 1M çıktı token başına $0,50. Hatalar ve reddetmeler krediden düşmez.
curl https://api.stableaudio.top/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 SDK Entegrasyonu
API'yi Python betiklerinize entegre etmek için resmi OpenAI Python SDK'sını kullanın. İstemci yapılandırmanızda base_url ve api_key'i ayarlayın. Bu, zaten OpenAI arayüzünü kullanan mevcut kod tabanlarından yararlanmanızı sağlar. İstemci, JSON serileştirmesini ve yanıt ayrıştırmayı otomatik olarak halleder. Yanıtları akış olarak alabilir veya toplu iş modunda işleyebilirsiniz. Bu yaklaşım, istem üretimi, betik yazma veya ses iş akışınız için metin girdilerinden yapılandırılmış veri çıkarma için çalışır.
from openai import OpenAI
client = OpenAI(base_url="https://api.stableaudio.top/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 Entegrasyonu
API'yi OpenAI Node SDK'sını kullanarak Node.js uygulamalarınıza entegre edin. Doğru temel URL ve API anahtarını kullanarak istemciyi yapılandırın. Bu, standart OpenAI kalıplarıyla uyumluluğu sağlar. Senkron veya asenkron istekler yapabilirsiniz. Bu, web kancalarında veya arka plan işlerinde gerçek zamanlı metin işleme için kullanın. SDK, yeniden deneme mantığını ve yanıt ayrıştırmayı halleder. Bu, abonelik ücreti olmadan güvenilir, sansürsüz metin çıktısı gerektiren seslendirme betikleri veya altyazı işleme hatları oluşturmak için idealdir.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.stableaudio.top/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ı (SSE)
İsteğinizde stream: true ayarlayarak akış özelliğini etkinleştirin. API, Sunucu Tarafı Olaylar (SSE) döndürür. Token kullanım bilgisi son parçada yer alır. Bu, uzun metin üretimi için algılanan gecikmeyi azaltır. Canlı altyazılama veya etkileşimli istem iyileştirme için kullanın. Model kimliği uncensored olarak kalır. Akış, fiyatlandırma modelini değiştirmez. Yalnızca oluşturulan gerçek token'lar için ödeme yapmaya devam edersiniz. Akış sırasında oluşan hatalar, ekstra kredi tüketmeden uyumlu şekilde işlenir.
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)
Token Limitleri ve Kotalar
Model 100.000 token'lık bir bağlam penceresini destekler. Maksimum çıktı isteği başına 32.000 token'dır veya max_tokens ayarlanmamışsa 2.048'dir. Anahtar başına dakikada 300 isteğe kadar sınırlısınız. Eşzamanlı istekler anahtar başına 8 eşzamanlı istekle sınırlıdır. İstek gövdeleri 8 MB'ı geçmemelidir. Hız limitini aşarsanız 429 hatası alırsınız. Anahtarınız geçersizse 401 hatası alırsınız. Yeterli ön ödemeli krediniz yoksa 402 hatası alırsınız. Hatalar ve reddetmeler ücretsizdir. Kredi süresi dolmaz. USDT TRC20 veya USDC Base ile $20 ile $500 arasında kart (Visa, Mastercard, Apple Pay, Google Pay) veya kripto ile bakiye yükleyin.
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.stableaudio.top/v1 |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON modu | response_format: {"type": "json_object"} |
| 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 |
| 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ı) |
| Hız limiti | anahtar başına dakikada 300 istek |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| İstek boyutu | en fazla 8 MB |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Fiyat | 1M girdi token'ı $0,15 · 1M çıktı token'ı $0,50 |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10, $200'dan itibaren +%15 |
| Ü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) |
| Yükleme | USDT (TRC20) veya USDC (Base), $20–$500 arası herhangi bir tam tutar |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
| Giriş | Google veya e-posta ve şifre |
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
Bu API için 'sansürsüz' ne anlama gelir?
Model, yasal yetişkin, kurgusal, güvenlik araştırmaları veya tartışmalı konuları reddetmez. İçerik reddi olmadan yanıt verecek şekilde ayarlanmıştır. Tek katı sınır, çocuklarla ilgili cinsel içeriklerin her zaman engellenmesidir.
Faturalandırma nasıl yapılır ve hatalar ne zaman ücretsiz olur?
Sadece gerçek token kullanımına ödeme yaparsınız. Hatalar ve reddetmeler ön ödemeli kredinizi tüketmez. Kredi kart (Visa, Mastercard, Apple Pay, Google Pay) veya kripto (USDT TRC20, USDC Base) ile yüklenir ve asla sona ermez. $20 ile $500 arasında bakiye yükleyebilirsiniz.
Bunu görüntü veya ses üretimi için kullanabilir miyim?
Hayır. Bu metin tabanlı bir chat-completions API'sidir. Ses pipeline'ınız için metin katmanını (örneğin istem yazma veya altyazı) destekler. Kendisi görüntü, ses veya video üretmez.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.