Transkriptio-API: Yleiskatsaus, autentikointi ja rajoitukset
VoxScribern REST-API:n käyttö: kenellä on pääsy, miten vpt_live_-avaimet toimivat, Bearer-autentikointi, pyyntörajoitukset ja laskutus sykleissä.
VoxScribern REST-API mahdollistaa äänitiedostojen lähettämisen URL-osoitteella ja valmiin transkription vastaanottamisen järjestelmääsi ilman, että käyt verkkosivustolla. Se käyttää samoja moottoreita ja veloittaa samat syklit kuin hallintapaneelissa tehdyt transkriptiot.
Kuka voi käyttää
API on käytettävissä alkaen Profissional (R$ 39,90/kk) -suunnitelmasta. Pääsyn omaavat: Profissional, Premium, kaikki yrityssuunnitelmat (kuukausi- ja vuosisopimukset) sekä vastaavat vanhat suunnitelmat. Jos tilisi ei ole oikeutettu, avainreitit palauttavat virheen 403 PLAN_NOT_ELIGIBLE.
API-avaimet
Luo avain
Kopioi salaisuus heti
vpt_live_... ja se näytetään vain kerran luontihetkellä. Säilytämme vain sen hajautusarvon — sitä ei voi myöhemmin palauttaa.Säilytä turvallisesti
Kadotitko avaimen? Sitä ei voi näyttää uudelleen. Kumoa vanha avain ja luo uusi. Vaarantuneet avaimet tulee kumota välittömästi.
Henkilökohtaisten avainten luontiin ei ole vielä omaa näkymää hallintapaneelissa. Jos suunnitelmasi on oikeutettu ja haluat aloittaa API:n käytön, avaa tiketti, niin tiimi aktivoi pääsyn kanssasi.
Autentikointi
Jokainen pyyntö sisältää avaimen Authorization-otsikossa:
Authorization: Bearer vpt_live_SUA_CHAVE
Pyyntö ilman otsikkoa palauttaa 401 MISSING_API_KEY.
Äänen lähettäminen transkriptioon
Transkription päätepiste sijaitsee api.voxscriber.com-yhdyskäytävässä:
curl -X POST https://api.voxscriber.com/v1/transcriptions \
-H "Authorization: Bearer vpt_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"audio_url": "https://exemplo.com/gravacoes/reuniao.mp3",
"webhook_url": "https://seusistema.com/webhooks/vozparatexto",
"formats": ["txt", "srt"]
}'
Pyynnön rungossa hyväksytyt kentät: audio_url, webhook_url, engine (ASSEMBLYAI, WHISPER tai ELEVENLABS), language, formats (txt, json, srt, vtt, docx, pdf), metadata ja idempotency_key. Tulos saapuu webhook_url-osoitteeseesi — katso Webhooks ja ilmoitukset.
Käytä idempotency_key-kentässä omaa tunnistettasi (esim. tallenteen ID järjestelmässäsi). Jos sama pyyntö lähetetään vahingossa uudelleen, ääntä ei käsitellä — eikä veloiteta — kahdesti.
Rajoitukset
| Rajoitus | Arvo |
|---|---|
| Pyyntöjä avainta kohti | 60 minuutissa |
| URL-osoitteesta ladattu ääni | enintään 500 MB (60 sekunnin aikakatkaisu) |
| Ääni passthrough'n kautta (Premium-moottori lukee URL-osoitteen suoraan) | enintään 5 GB |
| Aktiivisia avaimia tiliä kohti | 20 |
URL-osoitteiden turvallisuussäännöt: vain https, ei uudelleenohjauksia, ja sisäiset/yksityiset osoitteet ovat estettyjä. Äänen URL-osoitteen on oltava julkisesti saatavilla.
Saatavilla olevat vientimuodot noudattavat suunnitelmasi porttia, kuten sivustollakin — suunnitelman ulkopuoliset muodot palautetaan exports_skipped-luettelossa.
Laskutus
API veloittaa samat syklit kuin sivustolla tehty transkriptio valitun moottorin mukaan (Vakio/Whisper: 1 sykli/min; Premium: 4 sykliä/min; Ultra: 10 sykliä/min). Tällä hetkellä ei ole kuukausittaista pyyntökiintiötä eikä avainkohtaista kulukattoa — seuraa kulutusta syklisaldostasi. Katso Sykli-järjestelmä.
FAQ
Kadotin API-avaimeni. Miten saan sen takaisin?
Sitä ei voi palauttaa — vain hajautusarvo on tietokannassa. Kumoa kadonnut avain ja luo uusi.
Veloittaako API enemmän kuin sivusto?
Ei. Kustannus sykleissä on identtinen, ja sen määrää moottori ja äänen kesto.
Voinko lähettää tiedoston suoraan URL-osoitteen sijaan?
Pääkanava on audio_url. Jos äänilläsi ei ole julkista URL-osoitetta, ota yhteyttä tukeen, niin arvioimme parhaan toimintatavan tapaukseesi.
Onko OpenAPI-dokumentaatiota?
Julkinen spec osoitteessa /.well-known/openapi.json kattaa tällä hetkellä vain julkiset päätepisteet (tilastot ja jaetut transkriptiot). Muuhun käytä tätä ohjekeskusta ja tukea.
Aiheeseen liittyvät artikkelit
Ei ratkennut? Avaa tiketti — tiimimme vastaa nopeasti.