ShareAI Platform Docs

Generează vorbire

Răspunsul reușit este audio binar, nu JSON.

Vizualizează ca Markdown
Pe această pagină
POST https://api.shareai.now/api/v1/audio/speech

Generează vorbire

URL de bază
https://api.shareai.now
Autentificare
Cheie API Bearer sau token de acces OAuth aprobat
Scop necesar
inference or monetization_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.mp3

Câmpuri cerere#

CâmpTipSemnificație și limite
model necesarșirIdentificatorul exact al modelului public activat. Trebuie să declare această operațiune și să fie permis de acreditivul tău.
input necesarșirText 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șirVoce opțională suportată de modelul de vorbire selectat, de cel mult 100 de caractere.
response_formatșirCodificare 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.
speednumărViteză de vorbire opțională între 0.25 și 4; modelul poate impune limite mai restrânse.
providerobiectPreferinț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

Documentația platformei ShareAI
Toată documentația

Caută după titlu sau conținut.

Întreabă despre această pagină

Alege un asistent pentru a explora această pagină. Poți, de asemenea, să copiezi pagina și să o inserezi în conversația ta.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI