Introducción
Transcribe la letra cantada en un archivo de audio y la devuelve como texto en la tarea. Está ajustado a la voz sobre música, no al habla pelada.
HeartMuLa Transcribe extrae la letra cantada de un archivo de audio y la devuelve en texto. Un campo de audio, ninguna opción, multilingüe, se factura por transcripción y no por minuto.
Funciones y aspectos destacados
Ajustado justo donde el reconocimiento de voz genérico se cae
Una línea cantada llega comprimida, doblada, empapada en reverberación y disputando el mismo rango de frecuencias con los instrumentos. Ese es exactamente el caso que un modelo de voz genérico no aprendió, y donde suele devolver fragmentos. Este está ajustado para eso. Lo contrario también vale: para una entrevista o un pódcast, sin mezcla que pelear, un modelo genérico de voz a texto es la mejor herramienta.
Texto en la tarea, ningún archivo que buscar
No se escribe ningún archivo que tengas que ir a buscar. La ejecución termina en la tarea misma, con la transcripción dentro del resultado: sin paso de descarga, sin bucket donde escribir y sin nada que entre en los 14 días de retención de medios. Lee el texto en la tarea terminada y mándalo directo a donde ya viven tus letras.
Un catálogo viejo se multiplica; un montón de clips, no
La duración nunca entra en el precio, así que un tema de seis minutos cuesta lo mismo que un estribillo de veinte segundos. Eso vuelve fácil presupuestar un rezago —cantidad de temas por un solo número— y convierte una carpeta de fragmentos cortos en la forma relativamente cara. Conviene preverlo: una pieza que resulta ser instrumental vuelve casi vacía y aun así cuenta como una ejecución exitosa y cobrada, así que descártalas antes de encolarlas.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
audio_url | Sí | Una URL que resuelve directamente a un archivo de audio. Las páginas que devuelven HTML fallan como material inválido. mínimo 1 caracteres |
Precios
$0.05 / transcripción
Se cobra por transcripción, no por minuto: una transcripción escasa de una pista instrumental también se cobra.
Casos de uso
Convertir voz en texto utilizable
Transcribe la letra cantada en un archivo de audio y la devuelve como texto en la tarea. Está ajustado a la voz sobre música, no al habla pelada. Usa este modo para transcribir una fuente de audio o video. Aporta una grabación clara cuando sea posible y revisa nombres, marcas de tiempo y pasajes de baja confianza.
Productos de audio sin censura
SpicyAPI no aplica ningún filtro de contenido, así que las letras con lenguaje fuerte vuelven transcritas en lugar de rechazadas o suavizadas. Los derechos sobre el audio que envías siguen siendo tu responsabilidad.
Metadatos de catálogo musical
Genera el texto de las letras en todo un catálogo para mejorar búsqueda, visualización y etiquetado. Con cobro por ejecución, el costo de un rezago es una multiplicación simple en vez de una función del tiempo total.
Subtítulos para video con música
Saca las líneas cantadas de una pista para después sincronizarlas como subtítulos de video corto, donde la voz va sobre una mezcla densa.
Guía de prompts y consejos prácticos
Envía una URL directa al archivo de audio
El campo recibe una URL, no un cuerpo de carga. Debe apuntar al audio mismo: una página de reproducción o un enlace para compartir que devuelva HTML falla como material inválido, no como mala transcripción.
Espera texto en la tarea, no un archivo
La transcripción vuelve como texto en el resultado de la tarea. No hay medio que descargar y en este endpoint no se guarda nada en la retención de medios.
Revisa el resultado antes de iterar
Entra una URL de audio, sale la letra en texto y no hay nada que configurar: ni pista de idioma, ni marcas de tiempo, ni etiquetas de hablante, ni valores de confianza, ni elección de formato de salida. El modelo está ajustado a la voz cantada sobre música; las mezclas muy cargadas, las voces susurradas o gritadas y las fuentes de tasa de bits muy baja degradan el resultado, y el audio instrumental devuelve poco o nada. La URL debe resolver directamente a un archivo de audio: una página que devuelve HTML falla como material inválido. Este endpoint no produce ningún medio, así que nada suyo aparece en la retención de medios de 14 días.
Inicio rápido de la 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"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
