Fish Audio: Transcribe 1
Transcribe 1 gjør korte lydopptak om til tekst med automatisk språkgjenkjenning og valgfrie tidsstempler på ordnivå. Bruk transkripsjonen til talenotater, søkbare klipp eller forberedelse av undertekster, og hold tidsfestede segmenter atskilt fra den lesbare fullteksten.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Transcribe 1 er Fish Audios generelle tale-til-tekst-modell for korte opptak. Den tar imot en lydfil og returnerer de gjenkjente ordene som tekst, med opptakets varighet, valgfrie tidsfestede segmenter og språkinformasjon når den er kjent. Modellen er nyttig for et kort talenotat, en muntlig instruksjon, et utdrag fra et opptak eller et lydklipp som trenger en lesbar tekstversjon.
I et eksempel på en arbeidsflyt for talenotater beholdes opptaket sammen med den fullstendige transkripsjonen og en identifikator for originalklippet. Et senere applikasjonstrinn kan søke i teksten, organisere notatet eller lage et sammendrag mens talekilden bevares. Ved en kommando gir transkripsjonen gjenkjente ord til applikasjonen; enhver handling er et separat trinn for tolkning og utførelse. Ved et intervjuutdrag registrerer du klippets plassering i hele lydopptaket, slik at et sitat kan kontrolleres på riktig sted.
Produsenten godtar WAV, MP3, AAC inkludert M4A/MP4, FLAC og Ogg med Opus eller Vorbis. Nettleseropptak i WebM bør konverteres til Ogg/Opus, MP3 eller WAV for denne modellen; Pro dokumenterer innebygd støtte for flere beholdere. Send én lydfil per forespørsel. Grunnmodellens dokumenterte forespørselsramme er opptil 50 MiB, mens MP3- og Opus-filer skal holdes under 25 MiB. Filstørrelse og opptakslengde er ulike hensyn: en komprimert fil kan passe innenfor opplastingsrammen og likevel ta for lang tid å behandle.
Transcribe 1 er laget for korte opptak. Produsenten anbefaler Pro for lyd som er lengre enn noen få minutter; en lang forespørsel til grunnmodellen kan feile hvis behandlingstidsgrensen overskrides. Når du deler en lengre kilde opp i korte klipp for transkripsjon, bevarer du hvert klipps startforskyvning og bekrefter at den returnerte transkripsjonen dekker hele klippet før resultatene kombineres. Legg til den opprinnelige forskyvningen i segmentenes lokale tider, slik at navigasjonen forblir knyttet til hele opptaket. Veiledningen for grunnmodellen skal ikke tolkes som Pros separate ramme på 60 minutter.
Produsentens svar omfatter text, duration og segments. Varighet uttrykkes i sekunder, og den lesbare fullstendige transkripsjonen bør beholdes som klippets primære ordlyd. Tidsstempler er valgfrie: ignore_timestamps har standardverdien true i produsentens API, mens false ber om segmenter på ordnivå med tekst og start- og sluttider i sekunder. Tidsjustering gir ekstra behandlingstid. En tom segments-tabell kan skyldes at tidsfesting ble utelatt, at det ikke finnes tale, eller at justering er midlertidig utilgjengelig, og skal derfor ikke automatisk tolkes som en tom fullstendig transkripsjon.
Segmenter er vanligvis ord, eller ett eller noen få tegn på kinesisk og japansk. Segmentteksten utelater tegnsetting og kan normalisere en verdi annerledes enn fullteksten; den er ikke en kopi tegn for tegn av det lesbare svaret. Et segment kan ha samme start- og sluttid. Bruk segmenter til å finne en posisjon i opptaket eller forberede tidsstyrt visning, og bruk fullteksten når ordlyd og tegnsetting er viktige. Hold disse to representasjonene atskilt i det ferdige resultatet.
Språket gjenkjennes automatisk, uansett om et valgfritt språkhint er oppgitt. Produsenten dokumenterer ISO 639-1-koder med små bokstaver for hint og returnerer en språkkode til applikasjonslogikken sammen med et språknavn for visning når det er kjent. Svaret rapporterer ett språk, ikke alle språkene i et opptak som veksler mellom språk. Bevar kildens ordlyd og tilgjengelige språkmetadata sammen med resultatet fremfor å behandle transkripsjonsforespørselen som en oversettelse.
Ved en arbeidsflyt for undertekster grupperer du sammenhengende tidsfestede segmenter i lesbare undertekstblokker fremfor å vise ett ord om gangen. Et nyttig resultat er en SRT- eller WebVTT-fil knyttet til originalklippet, med blokkgrenser som passer med pauser og en håndterlig mengde tekst på skjermen. Se etter manglende tidsfesting, og sørg for at hver blokk slutter etter at den starter. Gruppering av undertekster og filformatering er applikasjonstrinn som bygger på den returnerte tidsjusteringen, og visningsvalgene bør passe til avspilleren og publikum.
De dokumenterte innstillingene for Transcribe 1 er lyd, et språkhint og valget om tidsstempler. Pros talermarkører, strukturerte talerturer, innstillinger for følelseshendelser og hint om antall talere er separate funksjoner; de inngår ikke i grunnmodellens dokumenterte svarkontrakt. Velg ønsket resultat før behandling: vanlig lesbar tekst for et notat, eller tekst med tidsjustering for avspillingsnavigasjon og undertekster. Bevaring av klippidentifikator, transkripsjon og tilgjengelig tidsfesting gjør resultatet nyttig i neste applikasjonstrinn.
Ailoot Ultra · Transkripsjon POST /v1/audio/transcriptions fish-audio/transcribe-1
fish-audio/transcribe-1Start
Transcribe 1 gjør korte lydopptak om til tekst med automatisk språkgjenkjenning og valgfrie tidsstempler på ordnivå. Bruk transkripsjonen til talenotater, søkbare klipp eller forberedelse av undertekster, og hold tidsfestede segmenter atskilt fra den lesbare fullteksten.
- Godkjente inndata
- Lyd
- Resultater
- Tekst
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Transkripsjon POST /v1/audio/transcriptions
- Inndatatyper
audio- Utdatatyper
text
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser fish-audio/transcribe-1 | Standard— |
Feltinput_audio | Typeobject | KravPåkrevd | Verdier & grenser | Standard— |
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, input_audio |
Parametermaterial_types | Avtaleaudio |
Parametermaterial_conditions | AvtaleEksemplet leser den faktiske PCM WAV-filen din, som må ha innhold, koder alle filens byte som base64 og sender input_audio.format som wav. |
Livssyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Eksakt task_id fra en eksisterende medieoppføring du eier
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Ailoot-satser
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Faktureringsenhet | Kostnad |
|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Faktureringsenhet— | Kostnad Inndata · Inngående tokener — / 1K tokener Utdata · Utgående tokener — / 1K tokener Inndata · Lesing fra hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time — / 1K tokener |
| Konfigurasjonlydsekund i inndata | Prisplan— | Faktureringsenhetper sekund inndatalyd | Kostnad Inndata · lydsekund i inndata $0.0002 per sekund inndatalyd |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Transkripsjon
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': 'fish-audio/transcribe-1', '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.
Motta og lagre resultater
Ailoot Ultra · Transkripsjon
Hele den opprinnelige svarkroppen, statusen og videresendte svarhoder. Denne behandleren legger ikke til noen universell JSON-struktur, noe tekstfelt eller noen oppgaveinnpakning.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behold alle ferdige resultater
Behold alle fullstendige returnerte svar, filer og innholdsdeler.
Bevar hele svaret og svarhodene, alle faktiske utdata, de opprinnelige returnerte identifikatorene og alle bruksfeltene. Hent den opprinnelige operasjonen igjen uten å sende opprettelsesforespørselen på nytt.
Hvis det opprinnelige svaret må kontrolleres
Behold den faktiske X-Client-Request-ID og hele svaret. Les de opprinnelige ressursene du eier, og deres eksakte signerte innholdsadresser; send aldri en usikker opprettelse på nytt.
Svarfelter
| Felt | Type |
|---|---|
Felttext (when present) | Type |
Feltusage (when present) | Type |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårJSON-kroppen eller den eksplisitte kanoniske modell-ID-en er ugyldig. | Neste trinnBehold svaret og korriger det angitte forespørselsfeltet. |
Svar401 · authentication_error | VilkårAiloot API-nøkkelen er ugyldig. | Neste trinnBruk den autoriserte Ailoot API-nøkkelen din. |
Svar403 · permission_error | VilkårNøkkelgruppen gir ikke tilgang til denne metoden. | Neste trinnBehold de returnerte feildetaljene. |
Svar404 · not_found_error | VilkårDen valgte metoden har ingen godkjent rute. | Neste trinnBehold de returnerte feildetaljene. |
Svar422 · price_unavailable | VilkårDen godtatte tariffen kan ikke hente den nødvendige inndatamengden eller grensen. | Neste trinnBehold svaret; bruk inndatarepresentasjonen som den godtatte tariffen krever. |
Svar503 · | VilkårNødvendig lagring, rute, metodepris eller reservasjon er utilgjengelig. | Neste trinnBehold hele det opprinnelige svaret. En usikker reservasjon gir ikke tillatelse til å sende inn på nytt. |
Svar502 · server_error | VilkårDet opprinnelige resultatet, forbruket eller oppgjøret må kontrolleres. | Neste trinnBehold den faktiske forespørsels-ID-en og det opprinnelige svaret. Les den eksisterende oppføringen du eier; ikke send opprettelsen på nytt. |
Aliaser
Modellaliaser
Ailoot Ultra fish-audio/transcribe-1
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · Fish Audio: Transcribe 1
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/audio/transcriptions·fish-audio/transcribe-1:audio→text- Hvilke felt bruker forespørselen?
POST /v1/audio/transcriptions·fish-audio/transcribe-1:model,input_audio