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
- Invoer
audio- Uitvoer
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} · daadwerkelijk teruggegeven task_id of record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Gebruik een werkelijke opname en het bijbehorende formaat.
Bewaar de volledige transcriptie, segmenten, spreker-ID's en tijdsgegevens.
Tarieven
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor 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 alleen de tekst; behoud elk beschikbaar segment, elke spreker en tijdstempel en de werkelijke taak- en assetidentiteit.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de oorspronkelijke operation_id/X-Client-Request-ID voor reconciliatie zonder de aanvraag opnieuw in te dienen; er is geen afzonderlijke route om de audiostatus te pollen.
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 | VoorwaardeDe teruggegeven respons geeft aan dat de bewerking of het resultaat gecontroleerd moet worden | Volgende stapBewaar de oorspronkelijk teruggegeven bewerkings-/taak-ID, aanvraagheaders en respons; blijf de oorspronkelijke bewerking uitlezen via de ondersteunde leesaanvragen. 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