ShareAI Platform Docs

Konuşma oluştur

Başarılı yanıt, JSON değil, ikili ses dosyasıdır.

Markdown olarak görüntüle
Bu sayfada
POST https://api.shareai.now/api/v1/audio/speech

Konuşma oluştur

Temel URL
https://api.shareai.now
Kimlik doğrulama
Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
Gerekli kapsam
inference or monetization_gateway

Başarılı yanıt, JSON değil, ikili ses dosyasıdır. Şu şekilde kaydedin: curl --output speech.mp3 veya yanıt baytlarını SDK'nizde okuyun. Desteklenen bir model sesi ve çıktı formatı seçin; hız 0.25 ile 4 arasında sınırlandırılmıştır. Giriş limiti 256 KiB ve eşzamanlı yanıt limiti 2 MiB'dir.

Başlamadan önce#

SHAREAI_API_KEY'i sunucunuzda ayarlayın ve model yer tutucusunu şu anda etkin olan bir modelle değiştirin. API anahtarını tarayıcı kodunda asla ifşa etmeyin. Model, hesap, kimlik bilgisi ve sağlayıcı bu işlemi izin vermelidir. Aşağıdaki isteğe bağlı ayarlar model desteği gerektirir; API güvenlik sınırları, her modelin her değeri desteklediği anlamına gelmez.

Bir istek gönder#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/speech" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_SPEECH_MODEL",
  "input": "Hello from ShareAI.",
  "response_format": "mp3"
}' --output speech.mp3

İstek alanları#

AlanTürAnlam ve sınırlar
model gereklimetin dizisiTam etkinleştirilmiş genel model tanımlayıcısı. Bu işlemi bildirmeli ve kimlik bilgileriniz tarafından izin verilmiş olmalıdır.
input gereklimetin dizisiGerekli, boş olmayan konuşma metni, en fazla 256 KiB UTF-8. Karakter tarifeleri Unicode karakterlerini sayar, kodlanmış baytları değil.
voicemetin dizisiSeçilen konuşma modeli tarafından desteklenen isteğe bağlı ses, en fazla 100 karakter.
response_formatmetin dizisimp3 gibi desteklenen isteğe bağlı ses kodlaması. Başarılı yanıt ikilidir, JSON değildir. Süre bazlı fiyatlandırma rotaları, kendini tanımlayan MP3, WAV veya FLAC gerektirir.
speednumaraİsteğe bağlı konuşma hızı 0.25 ile 4 arasında; model daha dar sınırlar koyabilir.
providernesneİsteğe bağlı sağlayıcı yönlendirme tercihleri. Kabul edilen sağlayıcı etiketleri için provider.only kullanın, model kimliğinde bir ön ek olarak değil. Hesap ve kimlik bilgisi kısıtlamaları yine de geçerlidir.

Sonucu okuyun#

Başarı, ikili ses ile HTTP 200 döndürür. Başarılı yanıt, JSON değil, ikili ses dosyasıdır. Şu şekilde kaydedin: curl --output speech.mp3 veya yanıt baytlarını SDK'nizde okuyun. Desteklenen bir model sesi ve çıktı formatı seçin; hız 0.25 ile 4 arasında sınırlandırılmıştır. Giriş limiti 256 KiB ve eşzamanlı yanıt limiti 2 MiB'dir.

Faturalandırma birimleri#

Konuşma, modele bağlı olarak giriş karakteri, sağlayıcı tarafından bildirilen token veya üretilen saniye başına fiyatlandırılabilir. Karakter sayımları Unicode karakterlerini kullanır. Süre fiyatlandırması, desteklenen kendini tanımlayan MP3, WAV veya FLAC sonucu gerektirir. Ham PCM sonucu tahmini örnekleme oranına sahip değildir. Token bazlı fiyatlandırma rotaları güvenilir bir kullanım makbuzu gerektirir.

Konsol'dan tam etkin model tanımlayıcısını seçin. Beyan edilen işlem ve giriş/çıkış yetenekleri bu uç noktayla eşleşmelidir; bir metin sohbet modeli başka bir işlem için değiştirilemez. Kimlik bilgileriniz, sağlayıcı ve hesap kısıtlamaları hala geçerlidir.

Fiyatlandırma ve kullanım#

Oranlar, seçilen model, sağlayıcı, birimler ve varyantlar için EUR AI kredisi olarak yayımlanır. Yalnızca aktif tarifesindeki boyutlar ücretlendirilir. Bir tahmin, yürütmeden önce kredileri ayırır; nihai ücretler ölçülen kullanıma göre hesaplanır. Fiyatlar çözünürlüğe, çıktı formatına veya bir kullanım bandına bağlı olabilir. Nihai ShareAI borçlandırmasını görmek için Konsol Kullanımı'nı kontrol edin. Yukarı akış maliyet alanları ve medya baytları, uydurulmuş token sayısına dönüştürülmez.

Erişim ve hatalar#

Kullan inference onaylanmış ağ maliyeti çıkarımı için veya monetization_gateway onaylanmış bir Builder kar marjı ve kabul edilen faturalandırma şartları için. Yalnızca kimlik doğrulama erişimi harcama yetkisi vermez. Doğrulama, model yetkilendirmesi, yetersiz kredi, oran sınırları ve yürütme hataları yapılandırılmış bir şekilde döner. error. Bir zaman aşımı veya belirsiz gönderimden sonra, başka bir potansiyel ücretli istek oluşturmadan önce Kullanımı veya video işini inceleyin.

Son güncelleme Kasım 3, 2026

ShareAI Platform Belgeleri
Tüm belgeler

Başlık veya içerik ile ara.

Bu sayfa hakkında soru sor

Bu sayfayı keşfetmek için bir asistan seçin. Ayrıca sayfayı kopyalayıp konuşmanıza yapıştırabilirsiniz.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI