aisplice

Riferimento API

Audio

Nessun modello lo supporta ancora

Al momento nessun modello del catalogo supporta questa route. La pagina resta come riferimento.
POST/v1/audio/speech
POST/v1/audio/transcriptions
POST/v1/audio/translations

Voce in entrambe le direzioni: /v1/audio/speech sintetizza il testo in byte audio; /v1/audio/transcriptions trasforma l'audio in testo (compatibile con Whisper); /v1/audio/translations trascrive direttamente in inglese.

#Parametri della richiesta

  • modelstringobbligatorio

    Classe tts-1 per la sintesi vocale; classe whisper-1 per la trascrizione.

  • inputstringobbligatorio

    Solo speech: il testo da pronunciare.

  • voicestringobbligatorio

    Solo speech: nome della voce (alloy, nova, …); voci disponibili nella scheda del modello.

  • filefile (multipart)obbligatorio

    Solo transcriptions: il file audio (mp3, wav, m4a, webm …).

  • languagestringfacoltativo

    Solo transcriptions: indicazione ISO-639-1 che migliora l'accuratezza.

  • response_formatstringfacoltativo

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

  • speednumberfacoltativo

    Solo speech: velocità di riproduzione 0.25–4.0.

Due Content-Type diversi

speech accetta un corpo JSON e restituisce byte audio grezzi; transcriptions/translations accettano multipart/form-data e restituiscono JSON. Non mescolare i due.

#Errori correlati

  • 413 payload_too_largeIl corpo della richiesta (prompt, immagine o file audio) supera la dimensione accettata.
  • 401Bearer token non valido o mancante. Su questo percorso non c'è error.code — basati sullo stato.
  • 402 insufficient_user_quotaIl saldo del portafoglio non copre la stima pre-riservata.
  • 429Limitazione per chiave. Corpo vuoto; attendi Retry-After. Un 429 che contiene insufficient_user_quota indica invece un limite di spesa giornaliero.
  • 503 model_not_foundModello sconosciuto, oppure nessun canale funzionante lo serve al momento.

Tabella completa dei codici di errore →

#Esempio di richiesta

# 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

#Risposta

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

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

Non hai ancora risolto?

Inviaci l'ID richiesta o il messaggio di errore e verificheremo.

PrecedenteModelli 3DSuccessivoPolicy di upload dei file