Fish Audio: Transcribe 1
Transcribe 1 omvandlar korta ljudinspelningar till text med automatisk språkidentifiering och valfria tidsstämplar på ordnivå. Använd transkriptionen för röstanteckningar, sökbara klipp eller förberedelse av undertexter och håll tidsatta segment åtskilda från den läsbara fulltexten.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
Transcribe 1 är Fish Audios allmänna tal-till-text-modell för korta inspelningar. Den tar emot en ljudfil och returnerar de identifierade orden som text, tillsammans med inspelningens längd, valfria tidsatta segment och språkinformation när den är känd. Modellen är användbar för en kort röstanteckning, en talad instruktion, ett utdrag ur en inspelning eller ett ljudklipp som behöver en läsbar textrepresentation.
Ett illustrativt arbetsflöde för röstanteckningar bevarar inspelningen tillsammans med dess fullständiga transkription och en identifierare för originalklippet. Ett senare applikationssteg kan söka i texten, ordna anteckningen eller ta fram en sammanfattning samtidigt som den talade källan bevaras. För ett kommando levererar transkriptionen identifierade ord till applikationen; varje åtgärd är ett separat steg för tolkning och utförande. För ett intervjuutdrag registrerar du klippets position i hela ljudinspelningen så att ett citat kan kontrolleras på rätt ställe.
Tillverkaren accepterar WAV, MP3, AAC inklusive M4A/MP4, FLAC och Ogg med Opus eller Vorbis. Webbläsarinspelningar i WebM bör konverteras till Ogg/Opus, MP3 eller WAV för denna modell; Pro dokumenterar inbyggt stöd för ytterligare behållarformat. Ange en ljudfil per begäran. Basmodellens dokumenterade begäransgräns är upp till 50 MiB, med MP3- och Opus-filer under 25 MiB. Filstorlek och inspelningslängd är olika hänsyn: en komprimerad fil kan rymmas inom uppladdningsgränsen men ändå ta för lång tid att bearbeta.
Transcribe 1 är utformad för korta inspelningar. Tillverkaren rekommenderar Pro för ljud som är längre än några minuter; en lång begäran till basmodellen kan misslyckas om den överskrider bearbetningens tidsgräns. När en längre källa förbereds för transkription av korta klipp bevarar du varje klipps startförskjutning och bekräftar att den returnerade transkriptionen täcker hela klippet innan resultaten slås samman. Lägg till den ursprungliga förskjutningen till lokala segmenttider för att behålla navigeringens koppling till hela inspelningen. Basmodellens vägledning bör inte tolkas som Pros separata gräns på 60 minuter.
Tillverkarens svar innehåller fälten text, duration och segments. Längden uttrycks i sekunder, och den läsbara fullständiga transkriptionen bör bevaras som klippets primära ordalydelse. Tidsstämplar är valfria: ignore_timestamps har standardvärdet true i tillverkarens API, medan false begär segment på ordnivå med text samt start- och sluttider i sekunder. Att begära tidsjustering ökar bearbetningstiden. En tom segments-array kan bero på att tidsangivelser hoppats över, att tal saknas eller att tidsjustering tillfälligt är otillgänglig och bör därför inte automatiskt tolkas som en tom fullständig transkription.
Segment är i allmänhet ord, eller ett eller några få tecken på kinesiska och japanska. Deras text utelämnar skiljetecken och kan normalisera ett värde annorlunda än den fullständiga transkriptionen; den är inte en kopia tecken för tecken av det läsbara svaret. Ett segment kan ha samma start- och sluttid. Använd segment för att hitta en position i inspelningen eller förbereda tidsatt visning, och använd fulltexten när ordalydelse och skiljetecken är viktiga. Håll dessa två representationer åtskilda i det resulterande materialet.
Språket identifieras automatiskt oavsett om en valfri språkledtråd anges. Tillverkaren dokumenterar ISO 639-1-koder med gemener för ledtrådar och returnerar en språkkod för applikationslogik tillsammans med ett språknamn för visning när det är känt. Svaret rapporterar ett språk snarare än varje språk i en inspelning som växlar mellan språk. Behåll källans ordalydelse och tillgängliga språkmetadata med resultatet i stället för att behandla transkriptionsbegäran som en översättning.
För ett undertextflöde grupperar du på varandra följande tidsatta segment till läsbara textrutor i stället för att visa ett ord åt gången. Ett användbart resultat är en SRT- eller WebVTT-fil kopplad till originalklippet, med gränser som passar pauserna och en hanterbar mängd text på skärmen. Kontrollera om tidsangivelser saknas och säkerställ att varje textrutas sluttid följer dess starttid. Gruppering av undertexter och filformatering är applikationssteg som bygger på den returnerade tidsjusteringen, och visningsvalen bör passa spelaren och publiken.
Transcribe 1:s dokumenterade kontroller är ljud, en språkledtråd och valet av tidsstämplar. Pros talarmarkörer, strukturerade talarturer, kontroller för känslohändelser och ledtrådar om antalet talare är separata funktioner; de ingår inte i denna basmodells dokumenterade svarskontrakt. Välj önskat resultat före bearbetningen: vanlig läsbar text för en anteckning, eller text tillsammans med tidsjustering för uppspelningsnavigering och undertexter. Genom att bevara klippidentifieraren, transkriptionen och eventuella tidsangivelser blir resultatet användbart för nästa applikationssteg.
Ailoot Ultra · Transkribering POST /v1/audio/transcriptions fish-audio/transcribe-1
fish-audio/transcribe-1Start
Transcribe 1 omvandlar korta ljudinspelningar till text med automatisk språkidentifiering och valfria tidsstämplar på ordnivå. Använd transkriptionen för röstanteckningar, sökbara klipp eller förberedelse av undertexter och håll tidsatta segment åtskilda från den läsbara fulltexten.
- Godkända indata
- Ljud
- Resultat
- Text
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Transkribering POST /v1/audio/transcriptions
- Indatatyper
audio- Utdatatyper
text
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser fish-audio/transcribe-1 | Standard— |
Fältinput_audio | Typobject | KravObligatoriskt | Värden & gränser | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, input_audio |
Parametermaterial_types | Avtalaudio |
Parametermaterial_conditions | AvtalExemplet läser din faktiska, icke-tomma PCM WAV-fil, kodar filens samtliga byte som base64 och skickar input_audio.format som wav. |
Livscykel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · exakt task_id från en befintlig mediepost som du äger
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Ailoot-priser
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Debiteringsenhet | Avgift |
|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Debiteringsenhet— | Avgift Indata · Indatatoken — / 1K token Utdata · Utdatatoken — / 1K token Indata · Cacheläsning — / 1K token Indata · Skrivning till cache — / 1K token Indata · Skrivning till cache, 1 tim — / 1K token |
| Konfigurationsekund inkommande ljud | Prislista— | Debiteringsenhetper sekund indataljud | Avgift Indata · sekund inkommande ljud $0.0002 per sekund indataljud |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Transkribering
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.
Ta emot och spara resultat
Ailoot Ultra · Transkribering
Hela den ursprungliga svarskroppen, statusen och vidarebefordrade svarshuvuden. Denna hanterare lägger inte till någon universell JSON-struktur, något textfält eller något uppgiftshölje.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behåll alla färdiga resultat
Behåll varje fullständigt returnerat svar, fil och innehållsdel.
Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.
Om det ursprungliga svaret behöver kontrolleras
Behåll faktiskt X-Client-Request-ID och hela svaret. Läs de ursprungliga tillgångarna som du äger och deras exakta signerade innehållslänkar; skicka aldrig en osäker skapandebegäran igen.
Svarsfält
| Fält | Typ |
|---|---|
Fälttext (when present) | Typ |
Fältusage (when present) | Typ |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorJSON-kroppen eller det uttryckliga kanoniska modell-ID:t är ogiltigt. | Nästa stegBehåll svaret och korrigera det angivna fältet i begäran. |
Svar401 · authentication_error | VillkorAPI-nyckeln för Ailoot är ogiltig. | Nästa stegAnvänd din behöriga API-nyckel för Ailoot. |
Svar403 · permission_error | VillkorNyckelgruppen ger inte tillträde till denna metod. | Nästa stegBehåll de returnerade feluppgifterna. |
Svar404 · not_found_error | VillkorDen valda metoden har ingen tillåten rutt. | Nästa stegBehåll de returnerade feluppgifterna. |
Svar422 · price_unavailable | VillkorDen accepterade tariffen kan inte fastställa den mängd eller gräns för indata som krävs. | Nästa stegBehåll svaret; använd den representation av indata som den accepterade tariffen kräver. |
Svar503 · | VillkorNödvändig lagring, rutt, metodpris eller reservation är inte tillgänglig. | Nästa stegBehåll hela det ursprungliga svaret. En osäker reservation ger inte tillstånd att skicka in igen. |
Svar502 · server_error | VillkorDet ursprungliga resultatet, förbrukningen eller avräkningen kräver kontroll. | Nästa stegBehåll det faktiska begärans-ID:t och det ursprungliga svaret. Läs den befintliga posten som du äger; skicka inte skapandebegäran igen. |
Alias
Modellalias
Ailoot Ultra fish-audio/transcribe-1
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · Fish Audio: Transcribe 1
- Vilka indata och resultat finns?
POST /v1/audio/transcriptions·fish-audio/transcribe-1:audio→text- Vilka fält använder begäran?
POST /v1/audio/transcriptions·fish-audio/transcribe-1:model,input_audio