OpenAI: Whisper 1
Whisper 1 transcribeert een voltooid audiobestand naar tekst, met meertalige herkenning en woord- of segmenttijdstempels. De producent ondersteunt ondertitelformaten en een afzonderlijke workflow voor Engelse vertaling; het transcriptieresultaat behoudt de taal van de opname.
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.
Whisper 1 is het algemene spraakherkennings-API-model van OpenAI, gedocumenteerd als aangedreven door het opensource-model Whisper V2. Het accepteert een audiobestand en retourneert tekst. De maker beschrijft meertalige herkenning, taalidentificatie en een afzonderlijke spraakvertaaltaak. Transcriptie behoudt de gesproken taal; de afzonderlijke vertaalinterface van de producent retourneert Engelse tekst.
Een bruikbare toepassing is het voorbereiden van een interview, spraaknotitie of opgenomen gesprek voor later zoeken en bewerken. Lever de voltooide opname aan en, wanneer bekend, de invoertaal. OpenAI documenteert 98 ondersteunde talen en merkt op dat herkenningsnauwkeurigheid per taal verschilt. De enkelvoudige taalhint gebruikt een ISO-639-1-code; de nieuwere velden voor meerdere talen en keywords van andere transcriptiemodellen zijn afzonderlijke instellingen.
De bestandstranscriptieflow van de producent accepteert bestanden tot 25 MB in MP3-, MP4-, MPEG-, MPGA-, M4A-, WAV- of WebM-formaat. Gebruik voor een grotere opname een gecomprimeerd formaat of verdeel die in fragmenten binnen de limiet. Behoud zinsgrenzen en de volgorde van de fragmenten, zodat het samengestelde transcript aan de oorspronkelijke opname gekoppeld blijft. Een videocontainer levert voor deze taak de audio in plaats van invoer voor een visuele beschrijving.
Een prompt kan namen, acroniemen of opnamespecifieke woordenschat en context van een eerder segment aanleveren. De promptlimiet van Whisper is 224 tokens en de prompt moet met de taal van de audio overeenkomen. De maker stelt dat Whisper instructies niet volgt zoals een algemeen tekstmodel. Gebruik de prompt als relevante transcriptiecontext en controleer belangrijke spellingen daarna tegen de opname in plaats van een termenlijst als woorden te behandelen die de spreker noodzakelijk heeft gezegd.
De producent documenteert JSON, gewone tekst, SRT, VTT en verbose JSON als transcriptieformaten. Woord- en segmenttijdstempels vereisen verbose JSON; één of beide granulariteiten kunnen worden gevraagd. De API-referentie merkt op dat segmenttijdstempels geen extra latentie toevoegen, terwijl woordtijdstempels aanvullende verwerking vereisen. Die uitvoer ondersteunt ondertiteling en het vinden van passages tijdens bewerking; sprekerdiarisatie-annotaties horen bij een ander gespecialiseerd model.
Whisper 1 ondersteunt geen streaming voor bestandstranscriptie. De referentie documenteert ook een samplingtemperatuur tussen nul en één; bij nul kan het model de temperatuur automatisch verhogen wanneer de decodeerdrempels dat vereisen. Dit beschrijft verwerkingsinstellingen van de producent in plaats van een belofte dat elke opname een identiek of perfect nauwkeurig transcript oplevert.
Definieer het uiteindelijke artefact: een transcript voor zoeken, een ondertitelbestand of tekst met woord-/segmenttiming. Bewaar de oorspronkelijke opname, fragmentvolgorde en relevante brontijdverwijzingen bij het resultaat. Een latere tekstbewerkingsstap kan een spelfout corrigeren of een samenvatting voorbereiden, maar vergelijk wijzigingen met de audio zodat de door de spreker bedoelde boodschap behouden blijft. De herkende tekst wordt onderbouwing voor de volgende taak in plaats van een gegenereerd antwoord op de gesproken vraag.
Ailoot Ultra · Spraakherkenning POST /v1/audio/transcriptions openai/whisper-1
openai/whisper-1Aan de slag
Whisper 1 transcribeert een voltooid audiobestand naar tekst, met meertalige herkenning en woord- of segmenttijdstempels. De producent ondersteunt ondertitelformaten en een afzonderlijke workflow voor Engelse vertaling; het transcriptieresultaat behoudt de taal van de opname.
- Toegestane invoer
- Audio
- Resultaten
- transcription
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Spraakherkenning POST /v1/audio/transcriptions
- Invoertypen
audio- Uitvoertypen
transcription- Uitvoerformaat
- json
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten openai/whisper-1 | Standaard— |
Veldfile | Typefile | VereisteVereist | Waarden en limieten Inhoudstype: multipart/form-data | Standaard— |
Veldresponse_format | Typestring | VereisteOptioneel | Waarden en limieten json | Standaard— |
Veldinput_audio.data | Typebase64_string | VereisteVereist | Waarden en limieten Geldt wanneer: WhisperOR JSON-invoer | Standaard— |
Veldinput_audio.format | Typestring | VereisteVereist | Waarden en limieten wav, mp3, flac, ogg, m4a, webm Geldt wanneer: WhisperOR JSON-invoer | Standaard— |
Combinaties van invoermaterialen
· Vereist: model, file
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontours | Contract{"content_types":["application/json","multipart/form-data"],"required_json":["model","input_audio.data","input_audio.format"],"required_multipart":["model","file"],"file_formats":["wav","mp3","flac","ogg","m4a","webm"],"response_format_optional":["json"]}, {"content_types":["multipart/form-data"],"required":["model","file"],"file_formats":["mp3"],"response_format_option":false} |
Parametermax_bytes | Contract26214400 |
Parametermaterial_types | Contractaudio |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Gebruik een daadwerkelijke opname en het bijbehorende formaat.
Bewaar het volledige transcript, de segmenten, spreker-IDs en timing.
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 |
Details van het referentietarief
Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.
OpenAI: Whisper 1
Prijzen per configuratie
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| ConfiguratieOpenAI: Whisper 1 · Standaardconfiguratie | FactureringsvoorwaardenStandaardconfiguratie | Kosten Invoer · Seconden audio-invoer US$ 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 · Spraakherkenning
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_AUDIO_FILE:?Set the path to your actual MP3 recording}"
export AILOOT_AUDIO_FILE
python3 - <<'PY_REQUEST'
import os
from pathlib import Path
p=Path(os.environ["AILOOT_AUDIO_FILE"])
if not p.is_file() or p.suffix.lower()!=".mp3":raise SystemExit("Choose an existing MP3 recording")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/transcriptions \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--form-string model=openai/whisper-1 -F "file=@$AILOOT_AUDIO_FILE" \
-D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("result.json").read_text())))
PY_RESULT
Resultaten ophalen en opslaan
Ailoot Ultra · Spraakherkenning
json
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_MEDIA_TASK_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-task.json").read_text())))
PY_RESULT
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_ASSET_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-asset.json").read_text())))
PY_RESULT
Alle voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar de volledige JSON, niet uitsluitend tekst; behoud elk beschikbaar segment, elke spreker, tijdstempel en daadwerkelijke taak-/assetidentiteit.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de oorspronkelijke operation_id/X-Client-Request-ID voor reconciliatie zonder opnieuw in te dienen; er is geen aparte route om de audiostatus op te vragen.
Antwoordvelden
| Veld | Type |
|---|---|
Veldtext | Typestring |
Veldsegments[] | Typeobject |
Veldtask_id | Typestring |
Veldasset_url | Typestring |
Veldusage | Typeobject |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeHet geretourneerde antwoord geeft aan dat de bewerking of het resultaat moet worden gecontroleerd | Volgende stapBewaar de oorspronkelijk geretourneerde bewerkings-/taak-ID, de aanvraagheaders en het antwoord; blijf de ondersteunde leesacties voor die oorspronkelijke bewerking uitvoeren. Dien de aanmaakaanvraag niet opnieuw in. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra openai/whisper-1
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · OpenAI: Whisper 1
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/audio/transcriptions·openai/whisper-1:audio→transcription- Welke velden gebruikt het verzoek?
POST /v1/audio/transcriptions·openai/whisper-1:model,file,response_format