Introduction
Il transcrit les paroles chantées d’un fichier audio et les renvoie en texte sur la tâche. Il est réglé pour le chant par-dessus la musique, pas pour la parole seule.
HeartMuLa Transcribe extrait les paroles chantées d’un fichier audio et les renvoie en texte. Un champ audio, aucune option, multilingue, facturé à la transcription plutôt qu’à la minute.
Fonctionnalités et points forts
Calé sur ce que la reconnaissance vocale généraliste laisse tomber
Une ligne chantée arrive compressée, doublée, noyée de réverbération et en concurrence avec les instruments dans sa propre bande de fréquences. C’est précisément le cas qu’un modèle de parole généraliste n’a pas appris, et là où il renvoie des fragments. Celui-ci est réglé pour ça. L’inverse vaut aussi : pour un entretien ou un podcast, sans mix à combattre, un modèle de speech-to-text généraliste reste le meilleur outil.
Du texte sur la tâche, aucun fichier à récupérer
Aucun fichier n’est écrit pour que vous alliez le chercher. L’exécution se termine sur la tâche elle-même, la transcription figurant dans le résultat : pas d’étape de téléchargement, pas de bucket où écrire, et rien qui entre dans les 14 jours de conservation des médias. Lisez le texte sur la tâche terminée et envoyez-le directement là où vivent déjà vos paroles.
Un catalogue se multiplie, un tas de clips non
La durée n’entre jamais dans le prix : un titre de six minutes coûte autant qu’un refrain de vingt secondes. Un arriéré se budgète donc simplement – le nombre de titres multiplié par un seul chiffre – tandis qu’un dossier de courts extraits est la forme relativement coûteuse. À prévoir : un morceau qui se révèle instrumental revient presque vide et compte quand même comme un appel réussi et facturé, alors écartez-les avant de les mettre en file.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
audio_url | Oui | Une URL qui résout directement vers un fichier audio. Les pages qui renvoient du HTML échouent comme ressource invalide. 1 caractères minimum |
Tarification
$0.05 / transcription
Facturation à la transcription, non à la minute : une transcription maigre issue d’un morceau instrumental est facturée elle aussi.
Cas d’utilisation
Transformer la parole en texte exploitable
Il transcrit les paroles chantées d’un fichier audio et les renvoie en texte sur la tâche. Il est réglé pour le chant par-dessus la musique, pas pour la parole seule. Utilisez ce mode pour transcrire une source audio ou vidéo. Fournissez un enregistrement clair lorsque possible, puis vérifiez les noms, horodatages et passages peu fiables.
Produits audio sans censure
SpicyAPI n’applique aucun filtre de contenu : les paroles crues reviennent transcrites plutôt que refusées ou édulcorées. Les droits sur l’audio que vous envoyez restent votre responsabilité.
Métadonnées de catalogue musical
Produisez le texte des paroles sur tout un catalogue pour améliorer la recherche, l’affichage et l’étiquetage. Avec une facturation à l’appel, le coût d’un arriéré est une simple multiplication plutôt qu’une fonction de la durée totale.
Sous-titres de vidéos sur fond musical
Sortez les lignes chantées d’un titre pour les caler ensuite dans les sous-titres d’une vidéo courte, là où la voix repose sur un mixage dense.
Guide de prompt et conseils pratiques
Envoyez une URL directe vers le fichier audio
Le champ attend une URL, pas un corps de téléversement. Elle doit pointer vers l’audio lui-même : une page de lecture ou un lien de partage qui renvoie du HTML échoue comme ressource invalide, et non comme mauvaise transcription.
Attendez du texte sur la tâche, pas un fichier
La transcription revient en texte dans le résultat de la tâche. Il n’y a pas de ressource média à récupérer, et rien n’est conservé en rétention média pour ce point de terminaison.
Vérifiez le résultat avant la prochaine itération
Une URL audio à l’entrée, les paroles en texte à la sortie, et rien à régler : ni indication de langue, ni horodatages, ni étiquettes de locuteur, ni valeurs de confiance, ni choix de forme de sortie. Le modèle est réglé pour le chant par-dessus la musique ; les mixages très denses, les voix chuchotées ou criées et les sources à très faible débit dégradent le résultat, et un morceau purement instrumental ne renvoie presque rien. L’URL doit résoudre directement vers un fichier audio : une page qui renvoie du HTML échoue comme ressource invalide. Ce point de terminaison ne produit aucune ressource média, rien n’entre donc dans la rétention média de 14 jours.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "heartmula/transcribe/speech-to-text",
"input": {
"audio_url": "https://example.com/reference.mp3"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
