Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Usa la documentazione dei modelli audio di CometAPI scegliendo se la tua app necessita di output vocale, trascrizione o traduzione. Gli endpoint audio usano lo stesso pattern di chiave API CometAPI degli altri endpoint compatibili con OpenAI.

​
Scegli un’API audio

Create Speech

Converti testo in voce.

Create Transcription

Trascrivi audio in testo.

Create Translation

Traduci audio in testo inglese.

​
Crea speech

Usa un model ID con capacità audio dalla Models page o dalla model directory. Gli esempi qui sotto chiamano l’endpoint speech.
Questi esempi usano il placeholder your-audio-model-id. Sostituiscilo con un model ID audio disponibile dalla Models page o dalla model directory prima di eseguire la richiesta.
Apri Create Speech per usare il playground e lo schema dell’endpoint.
import os
import requests

response = requests.post(
    "https://api.cometapi.com/v1/audio/speech",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "your-audio-model-id",
        "input": "Welcome to CometAPI.",
        "voice": "alloy",
        "response_format": "mp3",
    },
    timeout=60,
)

response.raise_for_status()

with open("speech.mp3", "wb") as audio_file:
    audio_file.write(response.content)

​
Esempio di risposta

Una risposta speech riuscita è audio binario. La risposta HTTP può apparire così: 
HTTP/1.1 200 OK
Content-Type: audio/mpeg

speech.mp3

​
Esempi di record del model

Questa risposta di esempio del catalogo dei model mostra l’envelope /api/models e la struttura di un record di un model audio. Non è un elenco completo di model.
cURL
curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 0,
      "id": "your-audio-model-id",
      "code": "your-audio-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example audio model",
      "model_type": "audio",
      "features": [
        "text-to-speech"
      ],
      "endpoints": [
        "openai"
      ],
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 12,
        "output": 12,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}

​
Errori comuni

Usa i formati documentati nella pagina dell’endpoint.
Comprimi il file audio o dividi il job in file più piccoli.
Conferma che il file contenga speech e che il nome del campo corrisponda alla documentazione.
Usa https://api.cometapi.com/v1.

​
Codici di errore e strategia di retry

Non ritentare finché testo, file, model ID, voice o formato non sono corretti.
Non ritentare finché la API key non è presente e valida.
Controlla base URL, percorso e model ID prima di ritentare.
Riduci la dimensione del caricamento prima di ritentare.
Riprova con backoff esponenziale e riduci la concorrenza.
Riprova con backoff per errori temporanei del provider o del servizio.
Per i pattern di implementazione, vedi Error codes and retry strategy e Rate limits and concurrency.

​
Pricing e model directory

Models page

Leggi come CometAPI espone i model ID nella documentazione.

Model directory

Esplora disponibilità e funzionalità dei model.

Pricing

Controlla il pricing prima di chiamare un model.
Last modified on May 28, 2026