TR ▾

speechtotextapis.comMetin boru hatları için sansürsüz LLM

Speech To Text API
API anahtarı al

OpenAI Uyumlu API Anahtarı: Bir Tane Alın ve İstek Gönderin

OpenAI uyumlu bir API anahtarı, istemciyi farklı bir base URL'e yönlendirdiğinizde herhangi bir OpenAI SDK ile çalışan normal bir bearer token'dır. Bu sayfa, bu sitedeki barındırılan metin API'si için nasıl anahtar alınacağını ve birkaç dakikada çalışan bir çağrı yapmayı gösterir.

GüncellendiSpeech To Text API

Uyumlu bir metin API'si için bir API anahtarını temsil eden, bir terminal penceresini bir sunucuya bağlayan parlayan bir anahtar

Anahtarın aslında ne olduğu

"OpenAI uyumlu" ifadesi, arkasındaki şirketi değil, HTTP API'nin yapısını tanımlar. Hizmet, OpenAI SDK'larının gönderdiği POST /v1/chat/completions üzerinde aynı JSON gövdesini kabul eder ve Authorization: Bearer başlığını okur. Bu nedenle, bu hizmetten bir anahtar, özel bir base URL ve API anahtarı ayarlamanıza olanak tanıyan herhangi bir araca (resmi Python ve Node kütüphaneleri, LangChain, düz curl ve çoğu masaüstü sohbet istemcisi) uyar.

Anahtar bir OpenAI anahtarı değildir ve api.openai.com üzerinde çalışmaz. Tam tersi de doğrudur: bir OpenAI anahtarı burada çalışmaz. Her anahtar bir hizmete aittir ve bu hizmet, yasal yetişkin kullanımı için içerik reddi olmadan cevap vermeye yönelik olarak ayarlanmış tek bir açık ağırlıklı modeli çalıştırır. Bağımsız bir sağlayıcı tarafından barındırılır. Herhangi bir model satıcısının resmi API'si değildir ve diğer satıcılara yönlendirme yapmaz.

Bunları hatırlamanız gerekir. Bu site için base URL https://api.speechtotextapis.com/v1 şeklindedir. Model ID'si uncensored'dir. Anahtar, kayıt olduktan sonra aldığınız dizgedir. Aşağıdakilerin tümü bu üç değerin bir varyasyonudur.

Hizmet yalnızca metin içindir. Sohbet tamamlamaları, akış, tool calling ve JSON modunu destekler. Görüntü veya ses üretmez, embedding veya model ince ayarı sunmaz. Bir ses pipeline'ından buraya geldiyseniz, tipik görev transkripsiyondan sonraki metin aşamasıdır: bir transkripti temizleme, sahnelere bölme, diyalogları yeniden yazma veya yapılandırılmış veri çıkarma. Sesli metin işleme kılavuzu bu konuyu daha ayrıntılı ele alır.

Anahtarınızı dört adımda alın

  1. Kaydolun. Google kullanın veya bir e-posta adresi ve şifre ile kaydolun.
  2. API anahtar sayfasını açın. Bu sitedeki anahtar sayfasında yer alır. Anahtarınız burada oluşturulur ve gösterilir.
  3. Deneme kredisi talep edin. Aynı sayfadaki bir düğme, tek tıkla size $0,50 deneme kredisi verir. Kişi başı bir kez geçerlidir, 7 gün için geçerlidir ve kart gerektirmez.
  4. Anahtarı bir gizli depoya kopyalayın. Yerel bir test için bir ortam değişkeni yeterlidir. Dağıtılan her şey için ana bilgisayarınızın gizli yöneticisini kullanın.

Deneme, entegrasyonun çalıştığını kanıtlamak ve herhangi bir ödeme yapmadan önce tasarlanmıştır. Mevcut fiyatta, birçok kısa istek için yeterlidir ve aşağıdaki maliyet bölümü aritmetiği gösterir. Devam etmeye hazır olduğunuzda, fiyatlandırma sayfası bakiye yükleme miktarlarını listeler. Kredi ön ödemelidir, abonelik yoktur ve kredi süresi dolmaz, bu nedenle bir son tarihten önce yüklediğiniz bakiyeyi harcama konusunda baskı yoktur.

Deneme anahtarları, tam anahtarlardan daha sıkı sınırlamalara sahiptir: dakikada 60 istek ve 2 eşzamanlı istek. Bu, ilk bir komut dosyası için fazlasıyla yeterlidir. Onlarca transkript parçasını eşzamanlı olarak yaymayı planlıyorsanız, fonlanmış bir hesaba geçene kadar limite takılacağınızı bekleyin.

Her istemcinin sorduğu üç ayar

Kullandığınız yazılım ne olursa olsun, kurulum ekranı aynı üç şeyi biraz farklı isimler altında sorar.

AyarTipik alan adıDeğer
Uç NoktaTemel URL, API tabanı, hosthttps://api.speechtotextapis.com/v1
Kimlik bilgisiAPI anahtarı, token, gizli anahtarAnahtar sayfasındaki anahtarınız
ModelModel, model adı, motoruncensored

Bir detay insanları şaşırtabilir: base URL zaten /v1 ile biter. SDK'lar /chat/completions'i kendileri ekler, bu yüzden siz eklememelisiniz. İstemciniz base URL yerine sohbet uç noktasının tam URL'sini isterse, değer https://api.speechtotextapis.com/v1/chat/completions olur.

Bir araç yalnızca sabit bir host sunan ve düzenlenemeyen bir "OpenAI" ön ayarı sunuyorsa, bu hizmetle iletişim kuramaz. Temel URL alanını ortaya çıkaran bir "özel", "OpenAI-uyumlu" veya "gelişmiş" seçeneği arayın.

İlk isteğiniz

curl ile başlayın, çünkü bu, sizi API'den ayıran tüm katmanları kaldırır. YOUR_KEY yerine kopyaladığınız anahtarı yerleştirin.

curl https://api.speechtotextapis.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
      {"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
    ]
  }'

Başarılı bir yanıt, choices dizisi içeren bir JSON nesnesidir. Metin choices[0].message.content içinde yer alır ve usage bloğu, faturalandırılan tokenları bildirir.

Resmi Python kütüphanesiyle aynı çağrı şöyle görünür. Sadece base_url ve api_key varsayılan bir OpenAI kurulumundan farklıdır.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.speechtotextapis.com/v1",
    api_key=os.environ["API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
        {"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
    ],
)
print(resp.choices[0].message.content)

Ve Node'da, aynı paketi kullanarak:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.speechtotextapis.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
  ],
});
console.log(resp.choices[0].message.content);

max_tokens ayarlamanıza gerek yok. Belirtilmediğinde, tamamlama, isteminizden sonra kalan 100.000 token penceresinin kalan kısmını kullanabilir. Çağrı başına maliyet için bir üst sınır istiyorsanız kendiniz ayarlayın.

Anahtarın token harcamadan çalıştığını kontrol edin

Bir anahtarı daha büyük bir sisteme bağlamadan önce, modeller uç noktasına ucuz bir çağrı yapın. Bu, anahtarın kabul edildiğini ve temel URL'nin doğru olduğunu doğrular.

curl -i https://api.speechtotextapis.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

-i bayrağı, bu API'nin yararlı durumu bildirdiği yanıt başlıklarını yazdırır:

  • X-Request-Id isteği tanımlar. Belirli bir çağrı hakkında destek ile iletişime geçerseniz bunu ekleyin.
  • X-Balance-USD hesapta kalan krediyi gösterir.
  • X-RateLimit-Limit-Requests ve X-RateLimit-Limit-Concurrency, anahtarınız için geçerli olan limitleri gösterir, böylece anahtarın deneme mi yoksa tam limitlere mi sahip olduğunu bir bakışta anlayabilirsiniz.

Kendi kodunuzda X-Balance-USD okumak, kredi bitmeden önce kendinizi uyarmak için ucuz bir yoldur. Gürültülü bir çıktı istemiyorsanız, istek başına değil, iş başına bir kez günlüğe kaydedin.

Bir anahtarın kullanım maliyeti

Bir anahtarın sahibi olmak ücretsizdir. Tokenlar için ödeme yaparsınız: 1M giriş tokenı başına $0,15 ve 1M çıktı tokenı başına $0,50, ön ödemeli krediden düşülür. Başarısız veya reddedilen istekler için ücret alınmaz.

Yukarıdaki transkript temizleme çağrısı ile çalışılmış bir örnek. Diyelim ki bir istem 1.000 token ve temizlenmiş yanıt 500 token olsun.

  • Girdi: 1.000 / 1.000.000 x $0,15 = $0,00015
  • Çıktı: 500 / 1.000.000 x $0,50 = $0,00025
  • Toplam: Çağrı başına $0,0004

$0,50 deneme, bu boyuttaki yaklaşık 1.250 çağrıyı karşılar ($0,50 / $0,0004). Kendi sayılarınız farklı olacaktır, çünkü transkriptler uzunluk açısından değişkendir, ancak yöntem aynıdır: giren tokenları sayın, çıkan tokenları sayın, çarpın.

Bakiye yüklediğinizde, $20 ile $500 arasındaki tam miktarlar kabul edilir. Daha büyük yüklemeler bonus getirir: $50'den itibaren +%5, $100'den itibaren +%10 ve $200'den itibaren +%15. Örneğin, $100'lük bir yükleme size $110 kredi verir. Kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile ödeme yapabilirsiniz.

Anahtarı güvende tutma

Bir API anahtarı, bakiyeniz için bir şifredir. Ona sahip olan herkes kredinizi harcayabilir, bu yüzden ona göre davranın.

  • Kaynak kontrolünde tutmayın. Bir ortam değişkeninden veya bir gizli yöneticiden okuyun.
  • Tarayıcı JavaScript'inde veya mobil uygulama paketinde kullanmayın. Kullanıcı cihazında çalışan her şey incelenebilir. Ön ucunuz ile API arasında küçük bir sunucu kurun ve sunucunun başlığı eklemesine izin verin.
  • Ekran görüntülerine, bilet sistemlerine veya sohbet mesajlarına yapıştırmayın.
  • Bir anahtarın sızdığını düşünüyorsanız, bir şey olup olmadığını beklemek yerine kullanmayı bırakın ve hemen destek ile iletişime geçin.

Gizlilik konusunda: API'ye gönderilen istemler eğitim için kullanılmaz. Bu bir hizmet beyanıdır, göndermeniz gerekmeyen gizli bilgileri göndermek için bir neden değildir. Görev gerektirmiyorsa, transkriptlerden kişisel verileri redakte edin.

Bir çağrı başarısız olduğunda

İlk gün yaşanan sorunların çoğu dört nedenden birinden kaynaklanır.

Temel URL yanlış

İki yaygın hata, eksik /v1 ve çift /chat/completions'dir. Değerinizi yukarıdaki tablodakiyle karakter karakter karşılaştırın.

Anahtarın içinde yabancı bir karakter var

Bir sayfadan kopyalama genellikle sonuna boşluk veya yeni satır getirir. Kodunuzdaki değeri temizleyin ve başlığın Bearer, bir boşluk, ardından anahtar şeklinde olduğunu emin olun.

Model adı uncensored değil

İstemciler genellikle başka bir model adına varsayılan olarak geçer. Her çağrıda modeli açıkça ayarlayın.

HTTP 429

İki tür vardır ve hata kodu bunları ayırt eder. rate_limited, dakikada çok fazla istek gönderdiğiniz anlamına gelir. concurrency, aynı anda çok fazla istek gönderdiğiniz anlamına gelir. Akışlı bir istek, akış bitene kadar eşzamanlılık slotunu tutar, bu nedenle yavaş bir okuyucu düşük istek hızında bile bu hataya neden olabilir. Retry-After: 5 başlığı içeren bir 429 hatası, hizmetin kısa süreli olarak aşırı yüklü olduğunu gösterir; beş saniye bekleyin ve yeniden deneyin. İstemcinizdeki kısa üstel geri çekilme (backoff) üç durumu da yönetir.

Tam parametre listesi, akış formatı ve fonksiyon çağırma ayrıntıları için API belgelerine bakın.

Sorular ve cevaplar

Bu bir OpenAI anahtarı ile aynı mı?

Hayır. Aynı istek formatını izler, bu nedenle OpenAI SDK'ları ile çalışır, ancak bu hizmet tarafından verilir ve yalnızca bu hizmetin temel URL'sine karşı çalışır.

Anahtar almak için kredi kartına ihtiyacım var mı?

Hayır. Google veya e-posta ile kaydolun ve ardından anahtar sayfasında tek tıkla $0,50 deneme kredisi talep edin. Deneme için kart gerekmez ve 7 gün boyunca geçerlidir.

Hangi model adını kullanmalıyım?

Model alanında uncensored kullanın. GET /v1/models çağrısı, anahtarın erişebileceği modelleri listeleyecektir.

Anahtarı birden fazla sunucudan kullanabilir miyim?

Evet, ancak limitler genel anahtara uygulanır: tam anahtar için 8 eşzamanlı istek ve dakikada 300 istek, deneme anahtarı için 2 ve 60.

Anahtar görseller veya ses için çalışır mı?

Hayır. API yalnızca metin içindir. Ses veya görsel üretmez veya transkript etmez ve gömme (embedding) veya ince ayar (fine-tuning) özelliği yoktur.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Bu tüm kurulum işidir.

API anahtarı alDokümantasyonu oku