Fish Audio: Transcribe 1
Transcribe 1 convertit de courts enregistrements audio en texte avec détection automatique de la langue et horodatage facultatif des mots. Utilisez la transcription pour des notes vocales, des extraits interrogeables ou la préparation de sous-titres, en conservant les segments horodatés séparément du texte intégral lisible.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Transcribe 1 est le modèle général de reconnaissance vocale de Fish Audio pour les enregistrements courts. Il accepte un fichier audio et renvoie les mots reconnus sous forme de texte, avec la durée de l’enregistrement, des segments horodatés facultatifs et les renseignements linguistiques lorsqu’ils sont connus. Ce modèle est utile pour une courte note vocale, une consigne parlée, un extrait d’enregistrement ou un clip audio qui nécessite une représentation textuelle lisible.
Un exemple de processus pour les notes vocales conserve l’enregistrement avec sa transcription complète et un identifiant du clip original. Une étape ultérieure de l’application peut rechercher dans ce texte, organiser la note ou produire un résumé tout en préservant la source parlée. Pour une commande, la transcription fournit les mots reconnus à l’application; toute action relève d’une étape distincte d’interprétation et d’exécution. Pour un extrait d’entrevue, notez la position du clip dans l’enregistrement complet afin de vérifier une citation au bon endroit.
Le fabricant accepte WAV, MP3, AAC, y compris M4A/MP4, FLAC et Ogg contenant Opus ou Vorbis. Pour ce modèle, les enregistrements WebM provenant d’un navigateur doivent être convertis en Ogg/Opus, MP3 ou WAV; la documentation de Pro indique la prise en charge native de conteneurs supplémentaires. Fournissez un seul fichier audio par requête. La limite de requête documentée du modèle de base est de 50 Mio, avec des fichiers MP3 et Opus de moins de 25 Mio. La taille du fichier et la longueur de l’enregistrement sont deux considérations distinctes : un fichier compressé peut respecter la limite de téléversement tout en exigeant un traitement trop long.
Transcribe 1 est conçu pour les enregistrements courts. Le fabricant recommande Pro pour les fichiers audio de plus de quelques minutes; une longue requête au modèle de base peut échouer si elle dépasse la limite de temps de traitement. Si vous découpez une source plus longue pour transcrire de courts clips, conservez le décalage initial de chacun et confirmez que la transcription renvoyée couvre tout le clip avant de combiner les résultats. Ajoutez le décalage d’origine aux temps locaux des segments pour maintenir le lien de navigation avec l’enregistrement complet. Les indications du modèle de base ne doivent pas être assimilées à la capacité distincte de 60 minutes de Pro.
La réponse du fabricant comprend le texte, la durée et les segments. La durée est exprimée en secondes, et la transcription intégrale lisible doit être conservée comme formulation principale du clip. L’horodatage est facultatif : ignore_timestamps vaut true par défaut dans l’API du fabricant, tandis que false demande des segments au niveau des mots avec texte et temps de début et de fin en secondes. Demander l’alignement allonge le traitement. Un tableau segments vide peut refléter un horodatage omis, l’absence de paroles ou un alignement temporairement indisponible; il ne doit donc pas être interprété automatiquement comme une transcription intégrale vide.
Les segments correspondent généralement à des mots, ou à un ou quelques caractères en chinois et en japonais. Leur texte omet la ponctuation et peut normaliser une valeur différemment de la transcription intégrale; il ne reproduit pas caractère par caractère la réponse lisible. Un segment peut avoir le même temps de début et de fin. Utilisez les segments pour trouver un endroit dans l’enregistrement ou préparer un affichage synchronisé, et le texte intégral lorsque les mots et la ponctuation comptent. Gardez ces deux représentations distinctes dans le livrable.
La langue est détectée automatiquement, qu’un indice linguistique facultatif soit fourni ou non. Le fabricant documente des codes ISO 639-1 en minuscules pour les indices et renvoie un code de langue pour la logique de l’application ainsi qu’un nom de langue pour l’affichage lorsqu’il est connu. La réponse indique une seule langue plutôt que toutes celles d’un enregistrement qui passe d’une langue à l’autre. Conservez les mots de la source et les métadonnées linguistiques disponibles avec le résultat plutôt que de traiter la requête de transcription comme une opération de traduction.
Pour un processus de sous-titrage, regroupez les segments horodatés consécutifs en sous-titres lisibles plutôt que d’afficher un mot à la fois. Un livrable utile est un fichier SRT ou WebVTT lié au clip original, dont les limites correspondent aux pauses et dont la quantité de texte à l’écran reste raisonnable. Vérifiez les temps manquants et assurez-vous que la fin de chaque sous-titre suit son début. Le regroupement des sous-titres et la mise en forme du fichier sont des étapes applicatives fondées sur l’alignement renvoyé; leurs choix d’affichage doivent convenir au lecteur et au public.
Les commandes documentées de Transcribe 1 sont l’audio, un indice de langue et le choix de l’horodatage. Les marqueurs de locuteur, les tours de parole structurés, les commandes d’événements émotionnels et les indices sur le nombre de locuteurs de Pro sont des fonctions distinctes; ils ne font pas partie du contrat de réponse documenté de ce modèle de base. Choisissez le livrable requis avant le traitement : texte lisible seul pour une note, ou texte avec alignement pour la navigation dans la lecture et les sous-titres. La conservation de l’identifiant du clip, de la transcription et de tout horodatage disponible rend ce résultat utile à l’étape suivante de l’application.
Ailoot Ultra · Transcription audio POST /v1/audio/transcriptions fish-audio/transcribe-1
fish-audio/transcribe-1Pour commencer
Transcribe 1 convertit de courts enregistrements audio en texte avec détection automatique de la langue et horodatage facultatif des mots. Utilisez la transcription pour des notes vocales, des extraits interrogeables ou la préparation de sous-titres, en conservant les segments horodatés séparément du texte intégral lisible.
- Entrées acceptées
- Audio
- Résultats
- Texte
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Transcription audio POST /v1/audio/transcriptions
- Entrée
audio- Sortie
text
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites fish-audio/transcribe-1 | Par défaut— |
Champinput_audio | Typeobject | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, input_audio |
Paramètrematerial_types | Contrataudio |
Paramètrematerial_conditions | ContratL’exemple lit votre fichier PCM WAV réel et non vide, encode tous les octets du fichier en base64 et envoie input_audio.format avec la valeur wav. |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id exact d’un enregistrement média existant appartenant à votre compte
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifs
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs Ailoot
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Unité de facturation | Coût |
|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Unité de facturation— | Coût Entrée · Jetons en entrée — / 1K jetons Sortie · Jetons en sortie — / 1K jetons Entrée · Lecture du cache — / 1K jetons Entrée · Écriture dans le cache — / 1K jetons Entrée · Écriture dans le cache, 1 h — / 1K jetons |
| Configurationseconde d’audio en entrée | Barème tarifaire— | Unité de facturationpar seconde d’audio en entrée | Coût Entrée · seconde d’audio en entrée $0.0002 par seconde d’audio en entrée |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
Ailoot Ultra · Transcription audio
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.
Recevoir et enregistrer les résultats
Ailoot Ultra · Transcription audio
Corps de réponse d’origine complet, état et en-têtes transmis. Ce gestionnaire n’ajoute aucune structure JSON universelle, aucun champ de texte et aucune enveloppe de tâche.
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserver tous les résultats terminés
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Conservez la réponse complète et les en-têtes, chaque sortie effective, les identifiants initialement renvoyés et tous les champs d’utilisation. Récupérez l’opération d’origine sans soumettre à nouveau sa création.
Si la réponse d’origine doit être vérifiée
Conservez le X-Client-Request-ID réel et la réponse complète. Consultez les ressources d’origine appartenant à votre compte et leurs URL exactes de contenu signées; ne soumettez jamais de nouveau une création incertaine.
Champs de la réponse
| Champ | Type |
|---|---|
Champtext (when present) | Type |
Champusage (when present) | Type |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionLe corps JSON ou l’identifiant canonique explicite du modèle est invalide. | Étape suivanteConservez la réponse et corrigez le champ de demande indiqué. |
Réponse401 · authentication_error | ConditionLa clé API Ailoot est invalide. | Étape suivanteUtilisez votre clé API Ailoot autorisée. |
Réponse403 · permission_error | ConditionLe groupe de la clé n’autorise pas cette méthode. | Étape suivanteConservez les détails d’erreur retournés. |
Réponse404 · not_found_error | ConditionLa méthode sélectionnée ne possède aucune route autorisée. | Étape suivanteConservez les détails d’erreur retournés. |
Réponse422 · price_unavailable | ConditionLe tarif accepté ne peut pas obtenir la quantité d’entrée ou la borne dont il a besoin. | Étape suivanteConservez la réponse; utilisez la représentation d’entrée exigée par le tarif accepté. |
Réponse503 · | ConditionLe stockage, la route, le tarif de la méthode ou la réservation requis n’est pas disponible. | Étape suivanteConservez la réponse d’origine complète. Une réservation incertaine n’autorise pas une nouvelle soumission. |
Réponse502 · server_error | ConditionLe résultat d’origine, l’utilisation ou le règlement doit être vérifié. | Étape suivanteConservez l’identifiant réel de demande et la réponse d’origine. Consultez l’enregistrement existant appartenant à votre compte; ne soumettez pas de nouveau la demande de création. |
Alias
Alias du modèle
Ailoot Ultra fish-audio/transcribe-1
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · Fish Audio: Transcribe 1
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/audio/transcriptions·fish-audio/transcribe-1:audio→text- Quels champs la requête utilise-t-elle ?
POST /v1/audio/transcriptions·fish-audio/transcribe-1:model,input_audio