Speechdash genel API'si yayında

Speechdash genel API'si artık api.speechdash.com/v1 adresinde kullanıma sunuldu. Kullanıcıların metin dinlemesi gereken ürünler geliştiriyorsanız, tarayıcı arayüzünü açmadan belgeler oluşturabilir ve konuşma üretebilirsiniz.

Bu gönderi, neyin yayınlandığını, faturalandırmanın nasıl çalıştığını ve ilk isteğinizi birkaç dakika içinde nasıl gerçekleştireceğinizi ele alıyor.

API'nin bugünkü işlevleri

REST API, uygulamada bildiğiniz dinleme yığınına benzer şekilde çalışır:

• Kullanıcının Speechdash kitaplığında belge oluşturma ve yönetme (başlık ve dil ile metin içe aktarma)
• birçok dilde Anlatıcı, Soru Soran ve Uzman ses ayarlarıyla konuşma üretme
• Tahmin edilebilir JSON uç noktaları aracılığıyla belgeleri listeleme, okuma, güncelleme ve silme

API üzerinden oluşturulan belgeler speechdash.com adresindeki kitaplığa eklenir. Kullanıcılar uygulamada dinlemeye devam edebilir, metni düzenleyebilir, sesi dışa aktarabilir veya başka bir cihazdan devam edebilir.

Konuşma sentezi, uygulama içi oynatmayla aynı bulut seslerini kullanır. Kullanım, üründeki bulut dinlemeyle aynı kurallara tabi olan hesabın kredi cüzdanından düşülür.

Kimler için uygun?

Ekipler, dinleme işlevinin başka bir ürünün içinde yer alması gerektiğinde API'ye başvurur:

• Ödevlere veya makalelere okuma özelliği eklemek isteyen LMS ve eğitim platformları
• SaaS araçları içindeki erişilebilirlik katmanları
• İçeriklerin toplu olarak içe aktarıldığı ve kulakla gözden geçirilmesi gereken iç araçlar
• Tam bir arayüz yayınlamadan önce konuşma önizlemesi gerektiren prototipler

Kullanıcılarınızın zaten Speechdash hesapları varsa, tek bir cüzdan ve belge kitaplığına sahip olurlar. API, ayrı bir ürün değil, ek bir giriş kapısıdır.

Kimlik doğrulama ve belgeler

Her hesap, uygulamada Ayarlar → API bölümünde API anahtarları oluşturur. Anahtarlar sadece bir kez gösterilir; sadece bir önek sunucu tarafında saklanır.

Her istekte Authorization: Bearer sh_live_… gönderin. Geçersiz veya iptal edilen anahtarlar 401 yanıtı alır.

Geliştirici belgeleri Yardım Merkezi'nde yer alır:

• API genel bakış (kimlik doğrulama, sınırlar, faturalandırma, tekrarlanabilirlik)
• Canlı OpenAPI sözleşmesi: api.speechdash.com/v1/openapi.json

Pazarlama özellik sayfası Public API, ekibinizdeki geliştirici olmayanlar için hikayeyi özetler.

Faturalandırmaya genel bakış

Konuşma istekleri tahmini tutar, ardından ölçülen süreyi netleştirir. Yeniden denemelerde, ağ sorunları çift faturalandırmaya yol açmaması için belge oluşturma ve konuşma sırasında Idempotency-Key gönderilebilir.

Hesap başına (anahtar başına değil) oran sınırları uygulanır. Yanıtlar, geri çekilmeniz gerektiğinde standart oran sınırı başlıklarını ve Retry-After değerini içerir.

Beş dakikada ilk istek

1. speechdash.com adresinde oturum açın ve Ayarlar → API bölümünü açın
2. Bir anahtar oluşturun ve hemen kopyalayın
3. API genel bakış belgesini okuyun
4. Kısa bir metni /v1/documents adresine POST gönderin veya bir ses ayarı ve dil ile /v1/audio/speech adresini çağırın

Tam bir bölümü akışa almadan önce iki cümlelik bir örnekle başlayın. Genel bakış belgesinde tam alanlar ve örnek yanıtlar listelenir.

Sonraki adımlar

Ürün ihtiyaçları büyüdükçe API'yi genişleteceğiz. Bugün entegre olursanız, erken geri bildirim için Discord grubuna katılın veya sözleşmedeki bir şey belirsizse Yardım Merkezi'ni açın.

Speechdash ile yaptığınız çalışmalardan dolayı teşekkür ederiz. Ne inşa ettiğinizi duymak için heyecanlıyız.

İlgili rehberler

• Public API özellik sayfası
• Speechdash'a başlarken
• Bulut oynatma
• İçe aktarma biçimleri
• Hangi işlemler kredi kullanır