aisplice

Référence API

Audio

Aucun modèle disponible pour l'instant

Aucun modèle du catalogue ne prend en charge cette route actuellement. La page reste disponible pour référence.
POST/v1/audio/speech
POST/v1/audio/transcriptions
POST/v1/audio/translations

La parole dans les deux sens : /v1/audio/speech synthétise du texte en octets audio ; /v1/audio/transcriptions transforme l'audio en texte (compatible Whisper) ; /v1/audio/translations transcrit directement en anglais.

#Paramètres de la requête

  • modelstringobligatoire

    Classe tts-1 pour la synthèse vocale ; classe whisper-1 pour la transcription.

  • inputstringobligatoire

    speech uniquement : le texte à prononcer.

  • voicestringobligatoire

    speech uniquement : nom de la voix (alloy, nova, …) ; voix disponibles selon la fiche du modèle.

  • filefile (multipart)obligatoire

    transcriptions uniquement : le fichier audio (mp3, wav, m4a, webm …).

  • languagestringfacultatif

    transcriptions uniquement : indication ISO-639-1 qui améliore la précision.

  • response_formatstringfacultatif

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

  • speednumberfacultatif

    speech uniquement : vitesse de lecture de 0,25 à 4,0.

Deux Content-Type différents

speech prend un corps JSON et renvoie des octets audio bruts ; transcriptions/translations prennent du multipart/form-data et renvoient du JSON. Ne mélangez pas les deux.

#Erreurs associées

  • 413 payload_too_largeLe corps de la requête (prompt, image ou fichier audio) dépasse la taille acceptée.
  • 401Jeton bearer invalide ou manquant. Pas de error.code sur ce chemin — basez-vous sur le statut.
  • 402 insufficient_user_quotaLe solde du portefeuille ne couvre pas l'estimation préréservée.
  • 429Limitation par clé. Corps vide ; attendez Retry-After. Un 429 qui contient insufficient_user_quota correspond en revanche à un plafond de dépenses quotidien.
  • 503 model_not_foundModèle inconnu, ou aucun canal opérationnel ne le sert actuellement.

Table complète des codes d'erreur →

#Exemple de requête

# 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

#Réponse

response.json
// /v1/audio/speech → binary audio body (Content-Type: audio/mpeg)

// /v1/audio/transcriptions
{"text": "…transcript…"}

Toujours bloqué ?

Envoyez-nous l'ID de requête ou le message d'erreur, et nous examinerons le problème.

PrécédentModèles 3DSuivantPolitique d'envoi de fichiers