Fish Audio: Transcribe 1
Transcribe 1 zet korte audio-opnamen om in tekst met automatische taaldetectie en optionele tijdstempels op woordniveau. Gebruik het transcript voor spraaknotities, doorzoekbare fragmenten of het voorbereiden van ondertitels en houd segmenten met tijdsaanduidingen gescheiden van de leesbare volledige tekst.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Transcribe 1 is het algemene spraak-naar-tekstmodel van Fish Audio voor korte opnamen. Het ontvangt een audiobestand en geeft de herkende woorden terug als tekst, met de opnameduur, optionele segmenten met tijdsaanduidingen en taalinformatie wanneer die bekend is. Dit model is nuttig voor een korte spraaknotitie, een gesproken instructie, een fragment uit een opname of een audioclip waarvoor een leesbare tekstweergave nodig is.
Een voorbeeldwerkwijze voor spraaknotities bewaart de opname samen met het volledige transcript en een identificatie van de oorspronkelijke clip. Een latere stap in de toepassing kan die tekst doorzoeken, de notitie ordenen of een samenvatting maken terwijl de gesproken bron behouden blijft. Bij een opdracht levert het transcript herkende woorden aan de toepassing; elke actie is een afzonderlijke interpretatie- en uitvoeringsstap. Leg voor een interviewfragment de positie van de clip in de volledige audio vast, zodat een citaat op de juiste plek kan worden gecontroleerd.
De producent accepteert WAV, MP3, AAC inclusief M4A/MP4, FLAC en Ogg met Opus of Vorbis. Browseropnamen in WebM moeten voor dit model worden omgezet naar Ogg/Opus, MP3 of WAV; Pro documenteert ingebouwde ondersteuning voor extra containers. Lever één audiobestand per verzoek aan. Het gedocumenteerde verzoekbudget van het basismodel is maximaal 50 MiB, waarbij MP3- en Opus-bestanden kleiner dan 25 MiB moeten blijven. Bestandsgrootte en opnamelengte zijn verschillende aandachtspunten: een gecomprimeerd bestand kan binnen de uploadlimiet vallen en toch te lang duren om te verwerken.
Transcribe 1 is ontworpen voor korte opnamen. De producent beveelt Pro aan voor audio langer dan enkele minuten; een lang verzoek aan het basismodel kan mislukken als het de verwerkingstijdlimiet overschrijdt. Bewaar bij het opdelen van een langere bron voor transcriptie in korte clips de beginoffset van elke clip en bevestig dat het teruggegeven transcript de volledige clip dekt voordat u de resultaten samenvoegt. Tel de oorspronkelijke offset op bij de lokale segmenttijden om navigatie aan de volledige opname te blijven koppelen. De richtlijn voor het basismodel mag niet worden uitgelegd als de afzonderlijke limiet van 60 minuten van Pro.
Het antwoord van de producent bevat tekst, duur en segmenten. De duur wordt uitgedrukt in seconden en het leesbare volledige transcript moet als primaire verwoording van de clip worden bewaard. Tijdstempels zijn optioneel: ignore_timestamps staat in de API van de producent standaard op true, terwijl false segmenten op woordniveau opvraagt met tekst, begin- en eindtijden in seconden. Het aanvragen van uitlijning kost extra verwerkingstijd. Een lege segments-array kan wijzen op overgeslagen tijdsbepaling, afwezigheid van spraak of tijdelijk niet-beschikbare uitlijning en mag daarom niet automatisch worden opgevat als een leeg volledig transcript.
Segmenten zijn meestal woorden, of één of enkele tekens in het Chinees en Japans. Hun tekst bevat geen leestekens en kan een waarde anders normaliseren dan het volledige transcript; het is geen teken-voor-tekenkopie van het leesbare antwoord. Een segment kan dezelfde begin- en eindtijd hebben. Gebruik segmenten om een positie in de opname te vinden of een getimede weergave voor te bereiden en gebruik de volledige tekst wanneer formulering en interpunctie belangrijk zijn. Houd deze twee weergaven gescheiden in het uiteindelijke resultaat.
De taal wordt automatisch gedetecteerd, ongeacht of een optionele taalhint is aangeleverd. De producent documenteert ISO 639-1-codes in kleine letters voor hints en geeft voor toepassingslogica een taalcode terug, samen met een taalnaam voor weergave wanneer die bekend is. Het antwoord rapporteert één taal, niet elke taal in een opname waarin tussen talen wordt gewisseld. Bewaar de bronformulering en beschikbare taalmetadata bij het resultaat in plaats van het transcriptieverzoek als een vertaalbewerking te behandelen.
Groepeer voor ondertitels opeenvolgende getimede segmenten tot leesbare ondertitelblokken in plaats van één woord tegelijk te tonen. Een bruikbare uitvoer is een SRT- of WebVTT-bestand dat is gekoppeld aan de oorspronkelijke clip, met blokgrenzen die aansluiten op pauzes en een behapbare hoeveelheid tekst op het scherm. Controleer op ontbrekende tijden en zorg dat de eindtijd van elk blok na de begintijd ligt. Het groeperen van ondertitels en bestandsopmaak zijn toepassingsstappen op basis van de teruggegeven uitlijning; de weergavekeuzes moeten passen bij de speler en het publiek.
De gedocumenteerde instellingen van Transcribe 1 zijn audio, een taalhint en de keuze voor tijdstempels. De sprekermarkeringen, gestructureerde spreekbeurten, instellingen voor emotiegebeurtenissen en hints voor het aantal sprekers van Pro zijn afzonderlijke functies; ze maken geen deel uit van het gedocumenteerde antwoordcontract van dit basismodel. Kies vóór verwerking het benodigde resultaat: gewone leesbare tekst voor een notitie, of tekst met uitlijning voor afspeelnavigatie en ondertitels. Door de clipidentificatie, het transcript en alle beschikbare tijdsaanduidingen te bewaren blijft het resultaat nuttig voor de volgende stap in de toepassing.
Ailoot Ultra · Transcriptie POST /v1/audio/transcriptions fish-audio/transcribe-1
fish-audio/transcribe-1Aan de slag
Transcribe 1 zet korte audio-opnamen om in tekst met automatische taaldetectie en optionele tijdstempels op woordniveau. Gebruik het transcript voor spraaknotities, doorzoekbare fragmenten of het voorbereiden van ondertitels en houd segmenten met tijdsaanduidingen gescheiden van de leesbare volledige tekst.
- Toegestane invoer
- Audio
- Resultaten
- Tekst
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Transcriptie POST /v1/audio/transcriptions
- Invoertypen
audio- Uitvoertypen
text
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten fish-audio/transcribe-1 | Standaard— |
Veldinput_audio | Typeobject | VereisteVereist | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, input_audio |
Parametermaterial_types | Contractaudio |
Parametermaterial_conditions | ContractHet voorbeeld leest uw eigen niet-lege PCM WAV-bestand, codeert alle bestandsbytes als base64 en verstuurt input_audio.format als wav. |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · exacte task_id uit een bestaand mediarecord dat u bezit
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Ailoot-tarieven
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Rekeneenheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Rekeneenheid— | Kosten Invoer · Invoertokens — / 1K tokens Uitvoer · Uitvoertokens — / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| Configuratieseconde audio-invoer | Tariefstaffel— | Rekeneenheidper seconde audio-invoer | Kosten Invoer · seconde audio-invoer $0.0002 per seconde audio-invoer |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Transcriptie
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.
Resultaten ophalen en opslaan
Ailoot Ultra · Transcriptie
Volledige oorspronkelijke antwoordbody, status en doorgestuurde headers. Deze handler voegt geen universele JSON-structuur, tekstveld of taakenvelop toe.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de daadwerkelijke X-Client-Request-ID en het volledige antwoord. Lees de oorspronkelijke assets die u bezit en hun exacte ondertekende inhouds-URLs; dien een onzekere aanmaak nooit opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldtext (when present) | Type |
Veldusage (when present) | Type |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeDe JSON-body of expliciete canonieke model-ID is ongeldig. | Volgende stapBewaar het antwoord en corrigeer het aangegeven verzoekveld. |
Antwoord401 · authentication_error | VoorwaardeDe Ailoot API-sleutel is ongeldig. | Volgende stapGebruik uw geautoriseerde Ailoot API-sleutel. |
Antwoord403 · permission_error | VoorwaardeDe sleutelgroep laat deze methode niet toe. | Volgende stapBewaar de geretourneerde foutdetails. |
Antwoord404 · not_found_error | VoorwaardeDe geselecteerde methode heeft geen toegelaten route. | Volgende stapBewaar de geretourneerde foutdetails. |
Antwoord422 · price_unavailable | VoorwaardeHet geaccepteerde tarief kan de vereiste invoerhoeveelheid of bovengrens niet verkrijgen. | Volgende stapBewaar het antwoord; gebruik de invoerweergave die het geaccepteerde tarief vereist. |
Antwoord503 · | VoorwaardeVereiste opslag, route, methodeprijs of reservering is niet beschikbaar. | Volgende stapBewaar het volledige oorspronkelijke antwoord. Een onzekere reservering geeft geen toestemming om opnieuw in te dienen. |
Antwoord502 · server_error | VoorwaardeHet oorspronkelijke resultaat, gebruik of de afrekening moet worden gecontroleerd. | Volgende stapBewaar de daadwerkelijke verzoek-ID en het oorspronkelijke antwoord. Lees het bestaande record dat u bezit; dien de aanmaak niet opnieuw in. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra fish-audio/transcribe-1
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · Fish Audio: Transcribe 1
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/audio/transcriptions·fish-audio/transcribe-1:audio→text- Welke velden gebruikt het verzoek?
POST /v1/audio/transcriptions·fish-audio/transcribe-1:model,input_audio