Transcribir audio
Proporcione audio en base64 en input_audio.data y su formato real.
En esta página
https://api.shareai.now/api/v1/audio/transcriptionsTranscribir audio
- URL base
https://api.shareai.now- Autenticación
- Clave API Bearer o token de acceso OAuth aprobado
- Alcance requerido
inferenceormonetization_gateway
Proporcione audio en base64 en input_audio.data y su formato real format. Los idiomas admitidos, los prompts, los formatos de respuesta y las opciones de marcas de tiempo dependen del modelo. Este endpoint JSON no acepta cargas de archivos multipart. La respuesta contiene la transcripción y el uso reportado.
Antes de comenzar#
Configure SHAREAI_API_KEY en su servidor y reemplace el marcador de posición del modelo con un modelo actualmente habilitado. Nunca exponga la clave API en el código del navegador. El modelo, la cuenta, las credenciales y el proveedor deben permitir esta operación. Las configuraciones opcionales a continuación requieren soporte del modelo; los límites de seguridad de la API no garantizan que todos los modelos admitan todos los valores.
Envía una solicitud#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/transcriptions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
"input_audio": {
"data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"format": "wav"
}
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_TRANSCRIPTION_MODEL',
'input_audio': {'data': 'UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
'format': 'wav'}}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/transcriptions', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/transcriptions", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
"input_audio": {
"data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"format": "wav"
}
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);El ejemplo contiene un pequeño archivo WAV silencioso únicamente para mostrar un transporte base64 válido. Reemplace input_audio.data con el base64 estándar de su propio archivo de audio; para Python use base64.b64encode(Path(“audio.wav”).read_bytes()).decode(“ascii”). No pegue una URL de audio en este campo.
Campos de solicitud#
| Campo | Tipo | Significado y límites |
|---|---|---|
model requerido | cadena | Identificador exacto de modelo público habilitado. Debe declarar esta operación y estar permitido por sus credenciales. |
input_audio requerido | objeto | Campos de datos y formato requeridos. data es el base64 estándar de los bytes reales del audio; el formato debe coincidir. Solo JSON; multipart no es compatible. Las tarifas de duración requieren WAV, MP3 o FLAC con una base de tiempo conocida, con un máximo de 600 segundos combinados. |
language | cadena | Código de idioma opcional admitido por el modelo. |
prompt | cadena | Contexto de transcripción opcional admitido por el modelo; no es un prompt para generación de audio. |
response_format | cadena | Formato de respuesta admitido por el modelo, con un máximo de 100 caracteres. La operación determina si el resultado es JSON o binario. |
timestamp_granularities | matriz | Valores opcionales de granularidad de marcas de tiempo admitidos por el modelo. La disponibilidad depende del formato de respuesta y del modelo. |
provider | objeto | Preferencias opcionales de enrutamiento del proveedor. Use provider.only para etiquetas de proveedor aceptadas, no como prefijo en el ID del modelo. Las restricciones de cuenta y credenciales aún se aplican. |
Leer el resultado#
El éxito devuelve HTTP 200 con JSON. Proporcione audio en base64 en input_audio.data y su formato real format. Los idiomas admitidos, los prompts, los formatos de respuesta y las opciones de marcas de tiempo dependen del modelo. Este endpoint JSON no acepta cargas de archivos multipart. La respuesta contiene la transcripción y el uso reportado.
Unidades de facturación#
La transcripción utiliza la duración publicada del modelo y/o la tarifa por tokens. Los segundos y tokens reportados por el Provider permanecen como mediciones separadas. La longitud en base64 no es una duración de audio ni un recuento de tokens. Las tarifas por duración de entrada requieren WAV, MP3 o FLAC autodescriptivos con una duración combinada de como máximo 600 segundos; las bases de tiempo desconocidas o PCM sin procesar no se admiten para precios por duración.
Elija el identificador exacto del modelo habilitado desde la Consola. Su operación declarada y capacidades de entrada/salida deben coincidir con este endpoint; un modelo de chat de texto no puede sustituirse por otra operación. Sus restricciones de credenciales, proveedor y cuenta aún se aplican.
Precios y uso#
Las tarifas se publican en créditos de IA en EUR para el modelo, proveedor, unidades y variantes seleccionados. Solo se cobran las dimensiones en su tarifa activa. Una estimación reserva créditos antes de la ejecución; los cargos finales usan el uso medido. Los precios pueden depender de la resolución, el formato de salida o una banda de uso. Consulte Uso en la Consola para el débito final de ShareAI. Los campos de costos ascendentes y bytes de medios no se convierten en recuentos de tokens inventados.
Acceso y errores#
Usar inference para inferencia aprobada con costo de red o monetization_gateway para un margen aprobado del Builder y términos de facturación aceptados. El acceso solo con identidad no autoriza gastos. La validación, autorización del modelo, créditos insuficientes, límites de tarifa y fallos de ejecución devuelven una error. estructura. Después de un tiempo de espera o envío incierto, inspeccione Uso o el trabajo de video antes de crear otra solicitud potencialmente pagada.
Última actualización noviembre 3, 2026.