Konuşma oluştur
Başarılı yanıt, JSON değil, ikili ses dosyasıdır.
Bu sayfada
https://api.shareai.now/api/v1/audio/speechKonuşma oluştur
- Temel URL
https://api.shareai.now- Kimlik doğrulama
- Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
- Gerekli kapsam
inferenceormonetization_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.mp3Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_SPEECH_MODEL',
'input': 'Hello from ShareAI.',
'response_format': 'mp3'}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/speech', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
with open("speech.mp3", "wb") as output:
output.write(response.read())TypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.shareai.now/api/v1/audio/speech", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}),
});
if (!response.ok) throw new Error(await response.text());
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));İstek alanları#
| Alan | Tür | Anlam ve sınırlar |
|---|---|---|
model gerekli | metin dizisi | Tam etkinleştirilmiş genel model tanımlayıcısı. Bu işlemi bildirmeli ve kimlik bilgileriniz tarafından izin verilmiş olmalıdır. |
input gerekli | metin dizisi | Gerekli, boş olmayan konuşma metni, en fazla 256 KiB UTF-8. Karakter tarifeleri Unicode karakterlerini sayar, kodlanmış baytları değil. |
voice | metin dizisi | Seçilen konuşma modeli tarafından desteklenen isteğe bağlı ses, en fazla 100 karakter. |
response_format | metin dizisi | mp3 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. |
speed | numara | İsteğe bağlı konuşma hızı 0.25 ile 4 arasında; model daha dar sınırlar koyabilir. |
provider | nesne | İ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