ShareAI Platform Docs

Generează audio

Endpointul ShareAI returnează un rezultat audio JSON limitat.

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

Generează audio

URL de bază
https://api.shareai.now
Autentificare
Cheie API Bearer sau token de acces OAuth aprobat
Scop necesar
inference or monetization_gateway

Endpointul ShareAI returnează un rezultat audio JSON limitat. Cererile de generare audio cu modalities:["text","audio"] pot folosi și /api/v1/chat/completions. Cererea ta este direcționată către operațiunea audio declarată. Acest răspuns sincron este colectat înainte de returnare; fluxurile incomplete ale furnizorului nu devin rezultate facturate cu succes. Formatele de ieșire audio sunt mp3, wav, flac, pcm16 sau pcm24, în funcție de model. PCM brut nu poate susține un tarif pe durată. Setează fie max_tokens, fie max_completion_tokens pentru a limita tokenii generați; nu furniza ambele.

Î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/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_AUDIO_MODEL",
  "messages": [
    {
      "role": "user",
      "content": "A short instrumental melody."
    }
  ],
  "modalities": [
    "text",
    "audio"
  ],
  "audio": {
    "format": "mp3"
  },
  "max_completion_tokens": 1024
}'

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.
messages necesararray1–256 mesaje de conversație cu rol/conținut. Folosește doar modalitățile de conținut acceptate de modelul audio selectat.
modalitiesarrayUna sau două valori unice din text și audio; audio este obligatoriu. Implicit este audio. Acest endpoint sincron nu acceptă fluxuri.
audioobiectOpțiuni de ieșire opționale: doar voce și format. format este mp3, wav, flac, pcm16 sau pcm24, în funcție de suportul modelului. PCM brut este incompatibil cu tarifele pe durată.
temperaturenumărTemperatura de generare opțională, acceptată de model.
top_pnumărValoarea opțională de eșantionare a nucleului, acceptată de model.
max_tokensîntregLimită opțională de tokeni de ieșire, 1–262144. Nu combina cu max_completion_tokens.
max_completion_tokensîntregLimită opțională de tokeni de ieșire, 1–262144. Nu combina cu max_tokens.
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 JSON. Endpointul ShareAI returnează un rezultat audio JSON limitat. Cererile de generare audio cu modalities:["text","audio"] pot folosi și /api/v1/chat/completions. Cererea ta este direcționată către operațiunea audio declarată. Acest răspuns sincron este colectat înainte de returnare; fluxurile incomplete ale furnizorului nu devin rezultate facturate cu succes. Formatele de ieșire audio sunt mp3, wav, flac, pcm16 sau pcm24, în funcție de model. PCM brut nu poate susține un tarif pe durată. Setează fie max_tokens, fie max_completion_tokens pentru a limita tokenii generați; nu furniza ambele.

Unități de facturare#

Modelele audio pot publica dimensiuni separate de tokeni text și audio, durată, melodie sau rate de cerere. Totalurile incluzive de tokeni sunt împărțite în contoare distincte text/audio; aceiași tokeni audio nu sunt taxați din nou ca text. Utilizarea neacceptată sau lipsă nu este aproximată din octeți codificați.

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