Referencia de la API

Audio

Ningún modelo lo admite todavía

Ahora mismo ningún modelo del catálogo admite esta ruta. La página se mantiene como referencia.
POST/v1/audio/speech
POST/v1/audio/transcriptions
POST/v1/audio/translations

Voz 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

  • modelstringobligatorio

    Clase tts-1 para voz; clase whisper-1 para transcripción.

  • inputstringobligatorio

    Solo speech: el texto que se leerá en voz alta.

  • voicestringobligatorio

    Solo speech: nombre de la voz (alloy, nova, …); las voces disponibles están en la ficha del modelo.

  • filefile (multipart)obligatorio

    Solo transcriptions: el archivo de audio (mp3, wav, m4a, webm …).

  • languagestringopcional

    Solo transcriptions: indicación ISO-639-1 que mejora la precisión.

  • response_formatstringopcional

    speech: mp3 | wav | opus …; transcriptions: json | text | srt | verbose_json.

  • speednumberopcional

    Solo speech: velocidad de reproducción de 0.25–4.0.

Dos tipos de contenido distintos

speech recibe un cuerpo JSON y devuelve bytes de audio sin procesar; transcriptions/translations reciben multipart/form-data y devuelven JSON. No los mezcles.

#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.

Tabla completa de códigos de error →

#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

response.json
// /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.