fi
4 min lukuaika Uploading Files

Lähetä ääni URL-osoitteella ja API:n kautta

Kuinka tuoda ääni suoralla URL-osoitteella käyttöliittymässä ja kuinka lähettää transkriptioita ohjelmallisesti API:n kautta: tukikelpoiset suunnitelmat, avaimet, todennus, rajoitukset ja webhookit.

Tiedoston lataamisen lisäksi on kaksi tapaa ”ilman tiedostoa käsillä”: liitä media-URL käyttöliittymään (kaikille käyttäjille) ja lähetä API:n kautta (Pro-tason ja sitä korkeammille suunnitelmille) — ihanteellinen transkription integrointiin järjestelmiin, PABX-puhelinjärjestelmiin ja automaatioihin.

1. Tuo URL-osoitteella käyttöliittymässä

Uuden transkription näytöllä sama vaihtoehto, joka hyväksyy YouTuben, hyväksyy myös suorat ääni-/videotiedostojen URL-osoitteet (https). Palvelin lataa median ja jatkaa normaalia työnkulkua: kielen valinta (tai automaattinen tunnistus), suunnitelman moottori ja kustannus sykleissä keston mukaan. Suunnitelmasi kesto- ja kokorajoitukset pätevät samalla tavalla.

2. Transkriptio-API

Kuka voi käyttää

API on käytettävissä Pro-suunnitelmasta alkaen (R$ 39,90/kk) — mukaan lukien Premium, yrityssuunnitelmat ja vastaavat vanhat suunnitelmat. Muissa suunnitelmissa avaimen luonti palauttaa tiedon, ettei suunnitelma ole tukikelpoinen.

API-avaimet

  • Tokenin muoto: vpt_live_...;
  • Salaisuus näytetään vain kerran luonnin yhteydessä — säilytä se turvallisessa paikassa. Emme tallenna salaisuutta, vain sen sormenjäljen;
  • Enintään 20 aktiivista avainta per tili; voit kumota minkä tahansa milloin tahansa;
  • Henkilökohtaisten avainten hallinta käyttöliittymässä on parhaillaan käyttöönotossa — jos et löydä vaihtoehtoa tililtäsi, avaa lippu, niin aktivoimme sen sinulle.

Kuinka kutsu toimii

Todennus tapahtuu headerilla Authorization: Bearer vpt_live_.... Bodyssa annat äänen URL-osoitteen (audio_url, vain https), webhook-osoitteen tuloksen vastaanottamista varten, ja valinnaisesti moottorin, kielen, vientimuodot ja idempotenssiavaimeen.

  • Pyyntöraja: 60 pyyntöä minuutissa per avain;
  • Koko: URL-osoitteesta ladattava ääni enintään 500 Mt palvelimelle; Premium-moottorilla jopa 5 Gt:n URL-osoitteet voidaan lukea suoraan moottorista ilman väliin jäävää latausta;
  • Hinta: samat syklit kuin sivustolla, keston ja moottorin mukaan.

Tuloksen vastaanottaminen (webhookit)

Tulos saapuu webhookina, joka on allekirjoitettu HMAC-SHA256-menetelmällä (headerit X-VPT-Signature ja X-VPT-Event) — vahvista allekirjoitus ennen kuin luotat payloadiin. Jos päätepisteesi on alhaalla, lähetämme uudelleen asteittain kasvavalla viiveellä: enintään 6 yritystä noin 24 tunnin aikana.

Hyväksymme vain https-URL-osoitteita ja estämme sisäiset/yksityiset osoitteet turvallisuussyistä. Jos äänesi on todennuksen takana, luo tilapäinen allekirjoitettu URL-osoite tallennustilassasi ennen API-kutsua.

Ei julkista URL-osoitetta tiedostolle (esim. PABX-tallenteet)? Yritysten auditorointi-API tarjoaa latauspäätepisteen, joka palauttaa tilapäisen lähetys-URL-osoitteen (voimassa 1 tunnin) — ota yhteyttä myyntiin, jos kyseessä on volyymipuheluiden auditorinti.

Usein kysytyt kysymykset

Menetitkö avaimen salaisuuden? Miten saan sen takaisin?

Sitä ei voi palauttaa — kumoa avain ja luo uusi. Salaisuus on olemassa vain luontihetkellä.

Onko API:lla dokumentaatiota?

Täydellinen integraatioviite toimitetaan käyttöoikeuden aktivoinnin yhteydessä. Avaa lippu ja kerro käyttötapauksesi.

Voinko valita moottorin ja kielen kutsussa?

Kyllä, molemmat ovat valinnaisia parametreja — ilman niitä käytetään suunnitelman oletusmoottoria ja kielen tunnistusta.

Maksaako API eri tavalla kuin sivusto?

Ei. Samat syklit, samat säännöt (mukaan lukien alennus vain onnistumisen jälkeen).

Miten kumoan vaarantuneen avaimen?

Kumoa se välittömästi avainten hallinnassa (tai tuen kautta). Kumoaminen katkaisee pääsyn heti.

Aiheeseen liittyvät artikkelit


Eikö kysymykseesi löytynyt vastausta? Avaa lippu — normaaliprioriteetin liput käsitellään 24 tunnin kuluessa.