Referencia de la API
Audio
Ningún modelo lo admite todavía
/v1/audio/speech/v1/audio/transcriptions/v1/audio/translationsVoz en ambos sentidos: /v1/audio/speech sintetiza texto en bytes de audio; /v1/audio/transcriptions convierte audio en texto (compatible con Whisper); /v1/audio/translations transcribe directamente al inglés.
#Parámetros de la solicitud
modelstringobligatorioClase tts-1 para voz; clase whisper-1 para transcripción.
inputstringobligatorioSolo speech: el texto que se leerá en voz alta.
voicestringobligatorioSolo speech: nombre de la voz (alloy, nova, …); las voces disponibles están en la ficha del modelo.
filefile (multipart)obligatorioSolo transcriptions: el archivo de audio (mp3, wav, m4a, webm …).
languagestringopcionalSolo transcriptions: indicación ISO-639-1 que mejora la precisión.
response_formatstringopcionalspeech: mp3 | wav | opus …; transcriptions: json | text | srt | verbose_json.
speednumberopcionalSolo speech: velocidad de reproducción de 0.25–4.0.
Dos tipos de contenido distintos
#Errores relacionados
- 413 payload_too_largeEl cuerpo de la solicitud (prompt, imagen o archivo de audio) supera el tamaño aceptado.
- 401Bearer token no válido o ausente. Esta ruta no tiene error.code — compara por el estado.
- 402 insufficient_user_quotaEl saldo de la billetera no cubre la estimación reservada previamente.
- 429Limitación por clave. Cuerpo vacío; espera el Retry-After. Un 429 que sí incluye insufficient_user_quota indica en cambio un límite de gasto diario.
- 503 model_not_foundModelo desconocido, o ningún canal sano lo atiende ahora mismo.
#Ejemplo de solicitud
# text → speech (bytes saved to file)
curl https://www.aisplice.store/v1/audio/speech \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "tts-1", "voice": "alloy", "input": "Hello from the gateway."}' \
--output hello.mp3
# speech → text (multipart)
curl https://www.aisplice.store/v1/audio/transcriptions \
-H "Authorization: Bearer sk-YOUR_KEY" \
-F file=@meeting.mp3 -F model=whisper-1#Respuesta
// /v1/audio/speech → binary audio body (Content-Type: audio/mpeg)
// /v1/audio/transcriptions
{"text": "…transcript…"}¿Sigues con el problema?
Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.