Fish Audio: Transcribe 1
Transcribe 1 omdanner korte lydoptagelser til tekst med automatisk sproggenkendelse og valgfrie tidsstempler på ordniveau. Brug transskriptionen til talebeskeder, søgbare klip eller forberedelse af undertekster, og hold tidskodede segmenter adskilt fra den læsbare fulde tekst.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Transcribe 1 er Fish Audios generelle tale-til-tekst-model til korte optagelser. Den modtager en lydfil og returnerer de genkendte ord som tekst sammen med optagelsens varighed, valgfrie tidskodede segmenter og sprogoplysninger, når de er kendt. Modellen er nyttig til en kort talebesked, en mundtlig instruktion, et uddrag af en optagelse eller et lydklip, der skal have en læsbar tekstrepræsentation.
En illustrativ arbejdsgang for talebeskeder bevarer optagelsen sammen med dens fulde transskription og en identifikator for det oprindelige klip. Et senere applikationstrin kan søge i teksten, organisere noten eller udarbejde et sammendrag og samtidig bevare den talte kilde. Ved en kommando leverer transskriptionen genkendte ord til applikationen; en eventuel handling er et separat fortolknings- og udførelsestrin. Ved et interviewuddrag skal du registrere klippets placering i den komplette lyd, så et citat kan kontrolleres på det rigtige sted.
Producenten accepterer WAV, MP3, AAC inklusive M4A/MP4, FLAC og Ogg med Opus eller Vorbis. Browseroptagelser i WebM bør konverteres til Ogg/Opus, MP3 eller WAV til denne model; Pro dokumenterer indbygget understøttelse af yderligere containere. Indsend én lydfil pr. anmodning. Grundmodellens dokumenterede anmodningsgrænse er op til 50 MiB, mens MP3- og Opus-filer skal holdes under 25 MiB. Filstørrelse og optagelseslængde er forskellige forhold: en komprimeret fil kan være inden for uploadgrænsen og alligevel tage for lang tid at behandle.
Transcribe 1 er udviklet til korte optagelser. Producenten anbefaler Pro til lyd, der er længere end nogle få minutter; en lang anmodning til grundmodellen kan mislykkes, hvis den overskrider grænsen for behandlingstid. Når en længere kilde forberedes til transskription som korte klip, skal du bevare hvert klips startforskydning og bekræfte, at den returnerede transskription dækker hele klippet, før resultaterne kombineres. Læg den oprindelige forskydning til de lokale segmenttider, så navigationen fortsat hænger sammen med den fulde optagelse. Vejledningen til grundmodellen skal ikke fortolkes som Pros separate grænse på 60 minutter.
Producentens svar indeholder tekst, varighed og segmenter. Varighed angives i sekunder, og den læsbare fulde transskription bør bevares som klippets primære ordlyd. Tidsstempler er valgfrie: ignore_timestamps er som standard true i producentens API, mens false anmoder om segmenter på ordniveau med tekst samt start- og sluttider i sekunder. Anmodning om tidsjustering øger behandlingstiden. Et tomt segments-array kan skyldes fravalgt tidskodning, ingen tale eller midlertidigt utilgængelig tidsjustering og bør derfor ikke automatisk fortolkes som en tom fuld transskription.
Segmenter er som regel ord eller ét eller nogle få tegn på kinesisk og japansk. Deres tekst udelader tegnsætning og kan normalisere en værdi anderledes end den fulde transskription; den er ikke en tegn-for-tegn-kopi af det læsbare svar. Et segment kan have samme start- og sluttid. Brug segmenter til at finde en position i optagelsen eller forberede tidskodet visning, og brug den fulde tekst, når ordlyd og tegnsætning er vigtige. Hold disse to repræsentationer adskilt i det resulterende materiale.
Sproget genkendes automatisk, uanset om der gives et valgfrit sproghint. Producenten dokumenterer ISO 639-1-koder med små bogstaver til hints og returnerer en sprogkode til applikationslogik sammen med et sprognavn til visning, når det er kendt. Svaret rapporterer ét sprog og ikke alle sprog i en optagelse, der skifter mellem sprog. Bevar kildens ordlyd og tilgængelige sprogmetadata sammen med resultatet i stedet for at betragte transskriptionsanmodningen som en oversættelseshandling.
Ved en arbejdsgang for undertekster skal du samle på hinanden følgende tidskodede segmenter i læsbare tekstblokke frem for at vise ét ord ad gangen. Et nyttigt output er en SRT- eller WebVTT-fil knyttet til det oprindelige klip med blokgrænser, der passer til pauser, og en overskuelig tekstmængde på skærmen. Kontroller for manglende tidskodning, og sørg for, at hver bloks slutning ligger efter dens start. Gruppering af undertekster og filformatering er applikationstrin baseret på den returnerede tidsjustering, og valgene for visning bør passe til afspilleren og målgruppen.
Transcribe 1s dokumenterede indstillinger er lyd, et sproghint og valg af tidsstempler. Pros talermarkører, strukturerede taleture, indstillinger for følelseshændelser og hints om antal talere er separate funktioner; de er ikke en del af denne grundmodels dokumenterede svarkontrakt. Vælg det nødvendige resultat før behandling: almindelig læsbar tekst til en note eller tekst sammen med tidsjustering til navigation ved afspilning og undertekster. Ved at bevare klipidentifikatoren, transskriptionen og eventuelle tilgængelige tider gør du resultatet nyttigt i applikationens næste trin.
Ailoot Ultra · Transskription POST /v1/audio/transcriptions fish-audio/transcribe-1
fish-audio/transcribe-1Start
Transcribe 1 omdanner korte lydoptagelser til tekst med automatisk sproggenkendelse og valgfrie tidsstempler på ordniveau. Brug transskriptionen til talebeskeder, søgbare klip eller forberedelse af undertekster, og hold tidskodede segmenter adskilt fra den læsbare fulde tekst.
- Accepterede input
- Lyd
- Resultater
- Tekst
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Transskription POST /v1/audio/transcriptions
- Inputtyper
audio- Outputtyper
text
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser fish-audio/transcribe-1 | Standard— |
Feltinput_audio | Typeobject | KravPåkrævet | Værdier og grænser | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, input_audio |
Parametermaterial_types | Kontraktaudio |
Parametermaterial_conditions | KontraktEksemplet læser din faktiske, ikke-tomme PCM WAV-fil, koder samtlige bytes i filen som base64 og sender input_audio.format som wav. |
Livscyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · præcist task_id fra en eksisterende mediepost, du ejer
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Ailoot-takster
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Afregningsenhed | Beløb |
|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Afregningsenhed— | Beløb Input · Inputtokens — / 1K tokens Output · Outputtokens — / 1K tokens Input · Cachelæsning — / 1K tokens Input · Cacheskrivning — / 1K tokens Input · Cacheskrivning, 1 time — / 1K tokens |
| Konfigurationsekund inputlyd | Takstplan— | Afregningsenhedpr. sekund lydinput | Beløb Input · sekund inputlyd $0.0002 pr. sekund lydinput |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Transskription
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.
Hent og gem resultater
Ailoot Ultra · Transskription
Hele det oprindelige svarindhold, status og videresendte headere. Denne handler tilføjer hverken en universel JSON-struktur, et tekstfelt eller en opgaveindpakning.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behold alle færdige resultater
Gem hvert fuldstændigt returneret svar, hver fil og hver indholdsdel.
Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.
Hvis det oprindelige svar skal kontrolleres
Behold det faktiske X-Client-Request-ID og hele svaret. Læs de oprindelige aktiver, du ejer, og deres præcise signerede indholds-URL’er; indsend aldrig en oprettelse med usikkert udfald igen.
Svarfelter
| Felt | Type |
|---|---|
Felttext (when present) | Type |
Feltusage (when present) | Type |
Fejl og næste trin
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar400 · invalid_request_error | BetingelseJSON-indholdet eller det eksplicitte kanoniske model-ID er ugyldigt. | Næste trinBehold svaret, og ret det angivne forespørgselsfelt. |
Svar401 · authentication_error | BetingelseAiloot API-nøglen er ugyldig. | Næste trinBrug din autoriserede Ailoot API-nøgle. |
Svar403 · permission_error | BetingelseNøglens gruppe giver ikke adgang til denne metode. | Næste trinBehold de returnerede fejloplysninger. |
Svar404 · not_found_error | BetingelseDen valgte metode har ingen rute med adgangstilladelse. | Næste trinBehold de returnerede fejloplysninger. |
Svar422 · price_unavailable | BetingelseDen accepterede tarif kan ikke hente den påkrævede inputmængde eller grænse. | Næste trinBehold svaret; brug den inputrepræsentation, som den accepterede tarif kræver. |
Svar503 · | BetingelsePåkrævet lager, rute, metodepris eller reservation er utilgængelig. | Næste trinBehold hele det oprindelige svar. En usikker reservation giver ikke tilladelse til at indsende igen. |
Svar502 · server_error | BetingelseDet oprindelige resultat, forbrug eller den oprindelige afregning skal kontrolleres. | Næste trinBehold det faktiske forespørgsels-ID og det oprindelige svar. Læs den eksisterende post, du ejer; indsend ikke oprettelsen igen. |
Aliaser
Modelaliaser
Ailoot Ultra fish-audio/transcribe-1
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · Fish Audio: Transcribe 1
- Hvilke input og resultater er tilgængelige?
POST /v1/audio/transcriptions·fish-audio/transcribe-1:audio→text- Hvilke felter bruger anmodningen?
POST /v1/audio/transcriptions·fish-audio/transcribe-1:model,input_audio