Generează vorbire
Răspunsul reușit este audio binar, nu JSON.
Pe această pagină
https://api.shareai.now/api/v1/audio/speechGenerează vorbire
- URL de bază
https://api.shareai.now- Autentificare
- Cheie API Bearer sau token de acces OAuth aprobat
- Scop necesar
inferenceormonetization_gateway
Răspunsul reușit este audio binar, nu JSON. Salvează-l folosind curl --output speech.mp3 sau citește octeții răspunsului în SDK-ul tău. Alege o voce de model suportată și un format de ieșire; viteza este limitată între 0.25 și 4. Limita de intrare este de 256 KiB, iar limita de răspuns sincron este de 2 MiB.
Înainte de a începe#
Setează SHAREAI_API_KEY pe serverul tău și înlocuiește placeholder-ul modelului cu un model activat în prezent. Nu expune niciodată cheia API în codul browserului. Modelul, contul, acreditivul și providerul trebuie să permită această operațiune. Setările opționale de mai jos necesită suportul modelului; limitele de siguranță ale API-ului nu garantează că fiecare model suportă fiecare valoare.
Trimite o cerere#
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()));Câmpuri cerere#
| Câmp | Tip | Semnificație și limite |
|---|---|---|
model necesar | șir | Identificatorul exact al modelului public activat. Trebuie să declare această operațiune și să fie permis de acreditivul tău. |
input necesar | șir | Text de vorbire necesar, nevid, de cel mult 256 KiB în UTF-8. Tarifele pe caractere se bazează pe caractere Unicode, nu pe octeți codificați. |
voice | șir | Voce opțională suportată de modelul de vorbire selectat, de cel mult 100 de caractere. |
response_format | șir | Codificare audio opțională suportată, cum ar fi mp3. Un răspuns reușit este binar, nu JSON. Rutele tarifate pe durată necesită MP3, WAV sau FLAC auto-descriptiv. |
speed | număr | Viteză de vorbire opțională între 0.25 și 4; modelul poate impune limite mai restrânse. |
provider | obiect | Preferințe opționale de rutare ale providerului. Utilizează provider.only pentru tag-uri de provider acceptate, nu un prefix în ID-ul modelului. Restricțiile contului și acreditivului se aplică în continuare. |
Citește rezultatul#
Succesul returnează HTTP 200 cu audio binar. Răspunsul reușit este audio binar, nu JSON. Salvează-l folosind curl --output speech.mp3 sau citește octeții răspunsului în SDK-ul tău. Alege o voce de model suportată și un format de ieșire; viteza este limitată între 0.25 și 4. Limita de intrare este de 256 KiB, iar limita de răspuns sincron este de 2 MiB.
Unități de facturare#
Vorbirea poate fi tarifată pe caracter de intrare, token raportat de furnizor sau secundă generată, în funcție de model. Numărul de caractere folosește caractere Unicode. Tarifarea pe durată necesită un rezultat MP3, WAV sau FLAC auto-descriptiv. Un rezultat PCM brut nu are rată de eșantionare estimată. Rutele tarifate pe token necesită un certificat de utilizare de încredere.
Alege identificatorul exact al modelului activat din Console. Operațiunea declarată și capacitățile de intrare/ieșire trebuie să se potrivească cu acest endpoint; un model de chat text nu poate fi substituit pentru o altă operațiune. Restricțiile acreditivului, providerului și contului tău se aplică în continuare.
Prețuri și utilizare#
Tarifele sunt publicate în credite AI EUR pentru modelul, providerul, unitățile și variantele selectate. Sunt taxate doar dimensiunile din tariful său activ. O estimare rezervă credite înainte de execuție; taxele finale utilizează utilizarea măsurată. Prețurile pot depinde de rezoluție, formatul de ieșire sau un interval de utilizare. Verifică Console Usage pentru debitul final ShareAI. Câmpurile de cost upstream și byte-urile media nu sunt convertite în număr de token inventat.
Acces și erori#
Utilizează inference pentru inferență aprobată cu costuri de rețea sau monetization_gateway pentru un adaos aprobat de Builder și termeni de facturare acceptați. Accesul doar pe bază de identitate nu autorizează cheltuieli. Validarea, autorizarea modelului, creditele insuficiente, limitele de rată și eșecurile de execuție returnează un error. După un timeout sau o trimitere incertă, inspectează Usage sau job-ul video înainte de a crea o altă cerere potențial plătită.
Ultima actualizare noiembrie 3, 2026