ElevenLabs: Scribe v2
Az ElevenLabs Scribe v2 több mint 90 nyelven ír át rögzített hanganyagot, szószintű időzítéssel, a beszélők opcionális elkülönítésével és a nem beszédjellegű események jelölésével. Hosszú felvételekhez, feliratokhoz és szerkeszthető átiratokhoz készült, kontextushoz kapcsolódó kulcskifejezésekkel, valamint szó szerinti vagy tisztázott átírási lehetőségekkel.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
Az ElevenLabs Scribe v2 a rögzített hanganyagokhoz, átíráshoz és feliratozáshoz készült kötegelt beszédfelismerési modell. A Scribe v1-re épít, a hosszú felvételek, szünetek, hangszínváltozások és hosszabb csendek továbbfejlesztett kezelésével. Az eredmény időzítési adatokkal, valamint opcionális beszélő- és hangesemény-jelölésekkel ellátott írott beszéd. A Scribe v2 Realtime különálló élő átírási kiadás; ennek a modellnek a célja teljes felvételek feldolgozása.
A gyártó több mint 90 nyelven dokumentál felismerést és automatikus nyelvfelismerést, a nyelvek között váltó felvételeket is beleértve. Az ismert nyelv megadása segítheti a modellt a hanganyag értelmezésében. Készíts tiszta felvételt, őrizd meg az eredeti nyelvet és neveket, és kerüld az erős levágásos torzítást vagy a beszéd részleteit eltávolító szükségtelen feldolgozást. A gyakori dokumentált bemenetek közé tartozik a WAV, MP3, FLAC, M4A, AAC, OGG, Opus és WebM. Válassz az átírási megvalósítás által támogatott bemeneti formát, és őrizd meg a forrásfelvételt az ellenőrzéshez.
A szokásos válasz a felismert szöveget, a felismert nyelv adatait és időzített szavak sorozatát tartalmazza. A szórekordok kezdő és záró időpontot, beszélőazonosítókat és a felismerés logaritmikus valószínűségét is tartalmazhatják. Ezek feliratokhoz, kereshető interjúkhoz vagy a megfelelő hangrészlethez visszaugró szerkesztőhöz teszik használhatóvá az eredményt. Az időzített eredményt őrizd meg a forráshanggal együtt. Egy podcastnál például az átadandó eredmény lehet szerkeszthető átirat és a szavakhoz igazított adatrekord, amely segít megtalálni a javításokat a feliratok elrendezése előtt.
A beszélők elkülönítése jelöli, hogy több beszélőt tartalmazó hanganyagban ki mikor beszél; a gyártó legfeljebb 32 beszélőt dokumentál. Akkor kapcsold be, ha fontosak a megszólalások váltásai, és ha ismert, adj meg észszerű beszélőszámot. A felismert beszélőcímkét különböztesd meg egy ellenőrzött személy nevétől. Interjúnál vagy megbeszélésnél a felvétel alapján ellenőrizd a váltásokat, különösen akkor, ha a hangok átfedik egymást vagy hasonlóan szólnak. A címke segít rendszerezni az átiratot; önállóan nem igazolja a beszélő személyazonosságát.
Az a felvétel, amelynek minden csatornáján egyetlen beszélő szerepel, más szerkezetű, mint az egy csatornára kevert több hang. A gyártó felülete legfeljebb öt csatornát képes egymástól függetlenül feldolgozni, és külön átiratokat vagy időrendbe rendezett, egyesített átiratot adhat vissza csatornaindexekkel. Tartsd meg ezt a csatornaelrendezést, ha jelentősége van. Egy külön csatornás hívásfelvétel átírás előtti összevonása elveszítheti a beszélőinformációk hasznos forrását. A csatorna alapján megállapított beszélőt különítsd el a kevert hangból kikövetkeztetett beszélőcsoportoktól. Az egyesített csatornás válaszhoz időbélyegek szükségesek, és nem tartalmazhat entitásfelismerést vagy kitakarást.
A kulcskifejezések megadása a kontextus alapján irányítja a nevek, termékkifejezések és szakszókincs felismerését. A jelenlegi kötegelt dokumentáció legfeljebb 1000 kifejezést engedélyez; minden kifejezésnek 50 karakternél rövidebbnek és legfeljebb öt szavasnak kell lennie. Releváns írásmódokat adj meg, ne egy széles, a feladathoz nem kapcsolódó katalógust. Műszaki interjúnál add meg a várható termékneveket és rövidítéseket, majd az eredményben az időbélyegüknél ellenőrizd őket. A kulcskifejezések befolyásolják a felismerést; nem utasítanak egy kifejezés beszúrására, ha azt a felvétel nem támasztja alá.
A tisztázás előtt válaszd meg az átirat célját. A szó szerinti feljegyzés megtartja az elhangzott megfogalmazást, míg a dokumentált no-verbatim lehetőség eltávolítja a töltelékszavakat, az elakadó mondatkezdéseket és a beszéd folyamatosságát megtörő elemeket az olvashatóbb eredményért. A dinamikus hangjelölés azonosíthat nem beszédjellegű eseményeket, például nevetést vagy lépéseket. A letisztázott átirat hasznos lehet feliratozáshoz vagy olvasáshoz, de nem helyettesítheti észrevétlenül a nyers feljegyzést, ha az ismétlések, javítások vagy nem beszédjellegű hangok fontosak a feladatban.
A gyártó entitásfelismerést és kísérleti átiratszerkesztést is dokumentál. A gyártó felületén az átiratszerkesztés nem kombinálható entitásfelismeréssel, entitáskitakarással vagy többcsatornás átírással. A felismert entitások strukturált helyadatokat adnak az átirat kiválasztott információihoz. Az opcionális entitáskitakarás helyettesítő címkékkel fedi el a felismert szöveget; entitásfelismerést igényel, és bekapcsolt kitakarás esetén az entitáslista nem kerül visszaadásra. A kitakarás az átírás során történik, általános helyettesítő jelölővel, kategóriacímkével vagy számozott kategóriacímkével. Az automatikus kitakarás kihagyhat érzékeny tartalmat, ezért megosztás előtt vizsgáld át a kitakart átiratot. A természetes nyelvű szerkesztés szerkesztett szöveget ad vissza az eredeti eredmény mellett, miközben az eredeti időzítés és beszélőrekord elérhető marad. Ezeket az anyagokat tartsd külön: egy javított írásmód vagy átszerkesztett mondat újabb ellenőrzést igényelhet, mielőtt a hanghoz igazítod vagy későbbi adatkinyerésben használod. Ezek a funkciók az átiratot dolgozzák fel; nem igazolják, hogy minden fontos részlet felismerése helyes volt.
A kész átiratban ellenőrizd a neveket, számokat, tagadásokat és beszélőváltásokat a megfelelő hangrészlethez visszatérve. A halk szakaszokra, átfedésekre és nyelvváltásokra is figyelj, ne csak a gördülékeny szöveg alapján ítéld meg a minőséget. A bizonytalan megfogalmazást hagyd javításra, ahelyett, hogy egy nem hallható részletet hihető mondattal egészítenél ki. A hasznos eredmény ellenőrzött szöveges feljegyzés, a kívánt felhasználáshoz szükséges időzítési és beszélőinformációkkal; az átirat ezután külön összefoglalási, fordítási vagy elemzési lépés bemenete lehet.
Ailoot Ultra · Hang átírása POST /v1/audio/transcriptions elevenlabs/scribe-v2
elevenlabs/scribe-v2Kezdő lépések
Az ElevenLabs Scribe v2 több mint 90 nyelven ír át rögzített hanganyagot, szószintű időzítéssel, a beszélők opcionális elkülönítésével és a nem beszédjellegű események jelölésével. Hosszú felvételekhez, feliratokhoz és szerkeszthető átiratokhoz készült, kontextushoz kapcsolódó kulcskifejezésekkel, valamint szó szerinti vagy tisztázott átírási lehetőségekkel.
- Elfogadott bemenetek
- Hang
- Eredmények
- Szöveg
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Hang átírása POST /v1/audio/transcriptions
- Bemenet
audio- Kimenet
text
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok elevenlabs/scribe-v2 | Alapértelmezett— |
Mezőinput_audio | Típusobject | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, input_audio |
Paramétermaterial_types | Szerződésaudio |
Paramétermaterial_conditions | SzerződésA példa beolvassa az Ön tényleges, nem üres PCM WAV-fájlját, a fájl teljes bájttartalmát base64 formában kódolja, és az input_audio.format mezőt wav értékkel küldi el. |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · pontos task_id egy meglévő, Önhöz tartozó médiarekordból
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Díjcsomagok
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Ailoot-díjak
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Elszámolási egység | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Elszámolási egység— | Díj Bemenet · Bemeneti tokenek — / 1K token Kimenet · Kimeneti tokenek — / 1K token Bemenet · Gyorsítótár olvasása — / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
| Beállításbemeneti hangmásodperc | Díjtáblázat— | Elszámolási egységbemeneti hangmásodpercenként | Díj Bemenet · bemeneti hangmásodperc $0.0001222222222222 bemeneti hangmásodpercenként |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot Ultra · Hang átírása
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_AUDIO_FILE:?Set the path to your actual PCM WAV recording}"
export AILOOT_AUDIO_FILE
python3 - <<'PY_REQUEST'
import base64, io, json, os, wave
from pathlib import Path
audio = Path(os.environ['AILOOT_AUDIO_FILE']).read_bytes()
if not (audio[:4] == b'RIFF' and audio[8:12] == b'WAVE'):
raise SystemExit('Supply your actual PCM WAV audio file')
with wave.open(io.BytesIO(audio), 'rb') as recording:
if recording.getcomptype() != 'NONE' or recording.getnframes() <= 0:
raise SystemExit('Supply a nonempty PCM WAV recording')
request = {'model': 'elevenlabs/scribe-v2', 'input_audio': {'data': base64.b64encode(audio).decode('ascii'), 'format': 'wav'}}
Path('request.json').write_text(json.dumps(request, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/transcriptions \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete original response, headers and actual X-Client-Request-ID.
# Read existing owned records for recovery; do not resubmit an uncertain operation.
Eredmények fogadása és mentése
Ailoot Ultra · Hang átírása
A teljes eredeti választörzs, állapot és továbbított fejlécek. Ez a kezelő nem ad hozzá univerzális JSON-szerkezetet, szövegmezőt vagy feladatburkolót.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Őrizzen meg minden elkészült eredményt
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Őrizze meg a teljes választ és a fejléceket, minden tényleges kimenetet, az eredetileg visszaadott azonosítókat és az összes használati adatmezőt. Az eredeti műveletet állítsa helyre, a létrehozási kérés újbóli beküldése nélkül.
Ha az eredeti választ ellenőrizni kell
Őrizze meg a tényleges X-Client-Request-ID értéket és a teljes választ. Kérdezze le az eredeti saját médiaállományokat és pontos aláírt tartalom-URL-címeiket; bizonytalan kimenetelű létrehozást soha ne küldjön be újra.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőtext (when present) | Típus |
Mezőusage (when present) | Típus |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételA JSON-törzs vagy a kifejezetten megadott kanonikus modellazonosító érvénytelen. | Következő lépésŐrizze meg a választ, és javítsa a kérés megjelölt mezőjét. |
Válasz401 · authentication_error | FeltételAz Ailoot API-kulcs érvénytelen. | Következő lépésHasználja az engedélyezett Ailoot API-kulcsát. |
Válasz403 · permission_error | FeltételA kulcscsoport nem használhatja ezt a metódust. | Következő lépésŐrizze meg a visszaadott hiba részleteit. |
Válasz404 · not_found_error | FeltételA kiválasztott metódushoz nincs engedélyezett útvonal. | Következő lépésŐrizze meg a visszaadott hiba részleteit. |
Válasz422 · price_unavailable | FeltételAz elfogadott tarifa nem tudja meghatározni a szükséges bemeneti mennyiséget vagy korlátot. | Következő lépésŐrizze meg a választ; használja az elfogadott tarifa által megkövetelt bemeneti formátumot. |
Válasz503 · | FeltételA szükséges tároló, útvonal, metódusár vagy összegzárolás nem érhető el. | Következő lépésŐrizze meg a teljes eredeti választ. A bizonytalan összegzárolás nem jogosít fel az újraküldésre. |
Válasz502 · server_error | FeltételAz eredeti eredményt, a felhasználást vagy az elszámolást ellenőrizni kell. | Következő lépésŐrizze meg a tényleges kérésazonosítót és az eredeti választ. A meglévő saját rekordot kérdezze le; ne küldje be újra a létrehozási kérést. |
Álnevek
Modell álnevei
Ailoot Ultra elevenlabs/scribe-v2
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · ElevenLabs: Scribe v2
- Milyen bemenetek és eredmények érhetők el?
POST /v1/audio/transcriptions·elevenlabs/scribe-v2:audio→text- Mely mezőket használja a kérés?
POST /v1/audio/transcriptions·elevenlabs/scribe-v2:model,input_audio