modelli

OpenAI: GPT Transcribe

Markdown · JSON

OpenAI: GPT Transcribe

GPT Transcribe trasforma il parlato registrato in testo nella lingua originale, con prompt contestuali, indicazioni letterali su parole chiave e suggerimenti per più lingue. OpenAI documenta la trascrizione di file completi, i risultati di trascrizione dei file restituiti progressivamente e la trascrizione dopo la finalizzazione dei turni audio Realtime.

Informazioni sul modello

Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.

GPT Transcribe è il modello di OpenAI per trascrivere il parlato di file audio completi, restituire progressivamente trascrizioni di file e trascrivere turni audio finalizzati nelle sessioni Realtime. Accetta audio con contesto testuale opzionale e restituisce testo riconosciuto. Il produttore lo presenta per la trascrizione precisa del parlato registrato nella lingua originale, compresi vocabolario specialistico, registrazioni multilingue e alternanza tra lingue. Il risultato utile è una trascrizione che resta collegata alla registrazione, con metadati sulle lingue rilevate quando il modello può formulare una previsione affidabile.

Preparare una registrazione completa

Il flusso di trascrizione di file di OpenAI accetta caricamenti fino a 25 MB. L’attuale riferimento dell’endpoint elenca i formati in ingresso FLAC, MP3, MP4, MPEG, MPGA, M4A, OGG, WAV e WebM e raccomanda metadati sufficienti per identificare il formato, compresi un’estensione del nome del file e un tipo di contenuto adeguati. Per una registrazione più grande, la guida raccomanda di comprimerla o dividerla in file da 25 MB o meno. Evitate di tagliare a metà di una frase, perché rimuovere il parlato circostante può ridurre la precisione del riconoscimento. Mantenete le parti in ordine e conservatene le posizioni nella registrazione originale.

Per una riunione, un’intervista o una presentazione registrata, fornite l’audio effettivo e identificate l’argomento e la terminologia che potrebbe essere pronunciata. Un risultato utile riporta le parole riconosciute anziché un riassunto dedotto della discussione. Preservate l’identificatore della registrazione con il testo restituito, affinché chi verifica un nome, un numero o una frase incerta possa tornare alla fonte corretta. La trascrizione può poi diventare materiale per un flusso separato di riassunto, traduzione o revisione editoriale.

Contesto, parole chiave e lingue attese

Il produttore distingue tre tipi di indicazioni. Un prompt fornisce contesto libero sull’argomento o sulla situazione della registrazione. Le parole chiave indicano parole o espressioni letterali attese nel parlato. Un elenco di lingue identifica le lingue parlate previste. Per una discussione bilingue su un prodotto, descrivete la situazione nel prompt, elencate i nomi dei prodotti pertinenti come parole chiave e fornite le lingue attese. Sono indicazioni per il riconoscimento, non istruzioni per inserire vocaboli che nessuno ha pronunciato.

GPT Transcribe usa il campo plurale languages anziché il precedente campo singolare language; OpenAI dice di non inviarli entrambi. La guida accetta codici ISO 639-1 supportati, alcuni codici ISO 639-3 e codici regionali delle impostazioni locali cinesi, rifiutando valori non supportati o malformati. Ogni parola chiave deve stare su una sola riga e non deve contenere parentesi angolari, ritorni carrello o avanzamenti di riga. Una parola chiave non valida o un prompt troppo lungo possono far rifiutare l’intera richiesta. Mantenete pertinente il contesto e verificate se i nomi suggeriti compaiono effettivamente nell’audio, anziché trattare l’elenco delle indicazioni come la trascrizione.

Uscita JSON e previsioni delle lingue rilevate

Il risultato documentato per i file è JSON contenente la trascrizione e le lingue rilevate. Queste previsioni sulle lingue sono l’uscita del modello, non una copia delle indicazioni linguistiche fornite. Un elenco di lingue vuoto è un risultato valido quando il modello non può formulare una previsione affidabile; non dimostra che la registrazione fosse silenziosa o che la trascrizione sia fallita. Tenete separati testo riconosciuto e metadati linguistici, affinché l’elaborazione successiva possa usare ciascuno secondo il suo significato.

Trasmettere progressivamente la trascrizione di un file

Un file completo può produrre testo trascritto in modo incrementale durante l’elaborazione. OpenAI documenta eventi transcript.text.delta per il testo parziale e transcript.text.done per la trascrizione completa del file; l’evento finale include anche le lingue rilevate. Si trasmette così progressivamente l’uscita di una registrazione già fornita. È utile per mostrare l’avanzamento di un caricamento lungo, mentre l’evento finale stabilisce il testo da conservare come risultato completato.

Turni finalizzati nelle sessioni Realtime

GPT Transcribe ha anche un flusso Realtime specializzato tramite WebSocket. L’audio viene aggiunto al buffer di ingresso, poi l’applicazione finalizza esplicitamente un turno audio. La trascrizione inizia per quel segmento finalizzato e può emettere porzioni di testo prima dell’evento di completamento, comprese informazioni sulle lingue rilevate. Il modello usa automaticamente i turni già trascritti come contesto in questo flusso di sessione del produttore. È distinto dall’emissione continua di sottotitoli in diretta mentre arriva l’audio del microfono; OpenAI indica GPT Live Transcribe per quel flusso continuo.

Per più turni, conservate l’identificatore dell’elemento in ingresso con la trascrizione corrispondente. OpenAI avverte che gli eventi di completamento di turni diversi non arrivano necessariamente nell’ordine del parlato: associate quindi ogni risultato finale al suo ingresso finalizzato, anziché ordinare una conversazione soltanto in base all’ora di completamento. Il risultato utile è una trascrizione ordinata assemblata dagli elementi finali corretti, con il testo provvisorio trattato come avanzamento anziché come un enunciato completato separato.

Uscite specializzate e limiti delle funzionalità

Questo profilo non fornisce un contratto universale per sottotitoli, riferimenti temporali, traduzione o etichette dei parlanti. La guida alla migrazione di OpenAI distingue tali capacità specializzate: i formati nativi dei sottotitoli e i riferimenti temporali delle parole richiedono un modello e un formato compatibili, mentre le etichette dei parlanti usano GPT-4o Transcribe Diarize. Il risultato per i file di GPT Transcribe è JSON, non una risposta direttamente sostituibile a SRT, VTT o a una risposta con riferimenti temporali dettagliati. La scheda esatta del modello non pubblica un limite numerico per il contesto o per l’uscita massima, quindi non va presunta una finestra di token da modello di chat per la trascrizione audio.

Verificate rispetto alla registrazione i vocaboli difficili, i numeri, gli accenti, il rumore di fondo e i cambi di lingua. Controllate che le indicazioni pertinenti abbiano migliorato il riconoscimento senza introdurre termini non pronunciati e che la trascrizione finale includa la fine dell’audio. Per un risultato multilingue, preservate le parole pronunciate prima di preparare una versione tradotta. Questi controlli rendono la trascrizione utile come materiale di origine, mantenendo chiaramente distinti contesto suggerito, lingue rilevate e parlato riconosciuto.

Ailoot Ultra · Trascrizione POST /v1/audio/transcriptions openai/gpt-transcribe

openai/gpt-transcribe

OpenAI /openai/gpt-transcribe

Introduzione

GPT Transcribe trasforma il parlato registrato in testo nella lingua originale, con prompt contestuali, indicazioni letterali su parole chiave e suggerimenti per più lingue. OpenAI documenta la trascrizione di file completi, i risultati di trascrizione dei file restituiti progressivamente e la trascrizione dopo la finalizzazione dei turni audio Realtime.

Input accettati
Audio
Risultati
Testo

Disponibile in Ailoot · input e metodi

Ailoot Ultra · Trascrizione POST /v1/audio/transcriptions
Tipi di input
audio
Tipi di output
text
CampoTipoRequisitoValori e limitiPredefinito
CampomodelTipostringRequisitoObbligatorioValori e limiti
openai/gpt-transcribe
Predefinito—
Campoinput_audioTipoobjectRequisitoObbligatorioValori e limitiPredefinito—
Parametri e ciclo di vita del metodo
ParametroContratto
Parametrocontent_typeContrattoapplication/json
ParametrorequiredContrattomodel, input_audio
Parametromaterial_typesContrattoaudio
Parametromaterial_conditionsContrattoL'esempio legge il tuo file PCM WAV reale e non vuoto, codifica tutti i byte del file in base64 e invia input_audio.format con valore wav.

Ciclo di vita: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id esatto di un record multimediale esistente di tua proprietà

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tariffe

Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.

Modalità rapida
Non specificato Quando è selezionata la modalità rapida
Modalità flex
Non specificato Quando è selezionata la modalità flex
Sforzo massimo di ragionamento
Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)

Tariffe Ailoot

Prezzi per configurazione

Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.

ConfigurazioneListino delle tariffeUnità di fatturazioneCosto
ConfigurazioneTariffe base dei tokenListino delle tariffeTariffa baseUnità di fatturazione—Costo
Input · Token in input — / 1K token
Output · Token in output — / 1K token
Input · Lettura dalla cache — / 1K token
Input · Scrittura nella cache — / 1K token
Input · Scrittura nella cache, 1 ora — / 1K token
Configurazionesecondo audio in ingressoListino delle tariffe—Unità di fatturazioneper secondo di audio in inputCosto
Input · secondo audio in ingresso $0.00015 per secondo di audio in input

Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →

Esempi di richieste

Ailoot Ultra · Trascrizione

curl · file WAV effettivo e risultato originale completo
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': 'openai/gpt-transcribe', '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.

Ricevi e salva i risultati

Ailoot Ultra · Trascrizione

Corpo completo della risposta originale, stato e intestazioni inoltrate. Questo gestore non aggiunge alcuna struttura JSON universale, campo di testo o struttura contenitore dell'attività.

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Conserva tutti i risultati completati

Conserva ogni risposta, file e parte di contenuto restituiti per intero.

Conserva la risposta completa e gli header, ogni output effettivo, gli identificatori originali restituiti e tutti i campi di utilizzo. Recupera l'operazione originale senza inviare nuovamente la richiesta di creazione.

Se occorre verificare la risposta originale

Conserva l'X-Client-Request-ID effettivo e la risposta completa. Consulta le risorse originali di tua proprietà e i relativi URL firmati esatti del contenuto; non inviare mai nuovamente una creazione dall'esito incerto.

Campi della risposta
CampoTipo
Campotext (when present)Tipo
Campousage (when present)Tipo
Errori e passaggi successivi
RispostaCondizionePassaggio successivo
Risposta400 · invalid_request_errorCondizioneIl corpo JSON o l'ID canonico esplicito del modello non è valido.Passaggio successivoConserva la risposta e correggi il campo della richiesta indicato.
Risposta401 · authentication_errorCondizioneLa chiave API Ailoot non è valida.Passaggio successivoUsa la tua chiave API Ailoot autorizzata.
Risposta403 · permission_errorCondizioneIl gruppo della chiave non è autorizzato a utilizzare questo metodo.Passaggio successivoConserva i dettagli dell'errore restituiti.
Risposta404 · not_found_errorCondizioneIl metodo selezionato non dispone di una rotta autorizzata all'utilizzo.Passaggio successivoConserva i dettagli dell'errore restituiti.
Risposta422 · price_unavailableCondizioneLa tariffa accettata non può ottenere la quantità in ingresso o il limite richiesto.Passaggio successivoConserva la risposta; usa la rappresentazione dell'input richiesta dalla tariffa accettata.
Risposta503 · CondizioneL'archiviazione richiesta, la rotta, il prezzo del metodo o la riserva dell'importo non sono disponibili.Passaggio successivoConserva l'intera risposta originale. Una riserva dell'importo dall'esito incerto non autorizza un nuovo invio.
Risposta502 · server_errorCondizioneIl risultato originale, i dati di utilizzo o il conguaglio dell'addebito richiedono una verifica.Passaggio successivoConserva l'ID effettivo della richiesta e la risposta originale. Consulta il record esistente di tua proprietà; non inviare nuovamente la richiesta di creazione.

Alias

Alias del modello

Ailoot Ultra openai/gpt-transcribe

Alias dei percorsi dei metodi

Usa i percorsi dei metodi indicati sopra.

ID di chiamata correlati

openai/gpt-transcribe

FAQ · OpenAI: GPT Transcribe
Quali input e risultati sono disponibili?

POST /v1/audio/transcriptions · openai/gpt-transcribe: audio → text

Quali campi usa la richiesta?

POST /v1/audio/transcriptions · openai/gpt-transcribe: model, input_audio

Maggiori dettagli

Collega Ailoot a Claude Code, OpenCode, Hermes o alla tua applicazione.

L’azienda e il suo portafoglio di progetti

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

Acquista token con uno sconto.

Sconto con abbonamento per lavoro regolare. Codici fino al 50% sull’acquisto di token.

Abbonamento
Scegli un piano scontato per richieste regolari.
Codice fino al 50%
Inserisci il codice all’acquisto. Il prezzo si aggiorna secondo la promozione.
Spese nella cronologia
Modello, token e importo sono salvati per ogni richiesta.

Scegli abbonamento · Consulta prezzi dei modelli

Collega l’API al prodotto che vendi.

SaaS, app e bot secondo offerta e accordo di licenza Ailoot. Per rivendere, richiedi una licenza reseller.

Applicazione commerciale
Integra generazione di testo, immagini, video e suono nelle funzioni a pagamento.
Licenza reseller
Invia descrizione del progetto e schema di accesso. Richiedi condizioni scritte per uso e rivendita.
Documenti sul sito
Offerta, accordo di licenza e politica sui dati sono disponibili prima della connessione.

Richiedi licenza reseller · Offerta e accordo di licenza