API audio

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

Scegli un’API audio

Create speech

Converti il testo in parlato.

Create transcription

Trascrivi l’audio in testo.

Create translation

Traduci l’audio in testo inglese.

Create speech

Usa un model ID con capacità audio dalla pagina Models o dalla directory dei modelli. Gli esempi sotto chiamano l’endpoint speech.

Questi esempi usano il segnaposto your-audio-model-id. Sostituiscilo con un model ID audio disponibile dalla pagina Models o dalla directory dei modelli 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)

import { writeFile } from "node:fs/promises";

const response = await fetch("https://api.cometapi.com/v1/audio/speech", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "your-audio-model-id",
    input: "Welcome to CometAPI.",
    voice: "alloy",
    response_format: "mp3",
  }),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const audio = Buffer.from(await response.arrayBuffer());
await writeFile("speech.mp3", audio);

curl https://api.cometapi.com/v1/audio/speech \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-audio-model-id",
    "input": "Welcome to CometAPI.",
    "voice": "alloy",
    "response_format": "mp3"
  }' \
  --output speech.mp3

Esempio di risposta

Una risposta speech riuscita è audio binario. La risposta HTTP può essere simile a questa:

HTTP/1.1 200 OK
Content-Type: audio/mpeg

speech.mp3

Esempi di record dei modelli

Questa risposta di esempio del catalogo modelli mostra l’involucro /api/models e la forma di un record di modello audio. Non è un elenco completo dei modelli.

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

Formato audio non supportato

Usa i formati documentati nella pagina dell’endpoint.

Upload di grandi dimensioni rifiutato

Comprimi il file audio o suddividi il job in file più piccoli.

Trascrizione vuota

Verifica che il file contenga parlato e che il nome del campo corrisponda a quanto indicato nella documentazione.

Base URL errato

Usa https://api.cometapi.com/v1.

Codici di errore e strategia di retry

400

Non riprovare finché il testo, il file, il model ID, la voce o il formato non sono corretti.

401

Non riprovare finché la chiave API non è presente e valida.

404

Controlla il base URL, il path e il model ID prima di riprovare.

413

Riduci la dimensione dell’upload prima di riprovare.

429

Ripeti il tentativo con exponential backoff e riduci la concorrenza.

500 or 503

Ripeti il tentativo con backoff per errori transitori del provider o del servizio.

Per i pattern di implementazione, consulta Codici di errore e strategia di retry e Rate limits e concorrenza.

Prezzi e directory dei modelli

Pagina dei modelli

Leggi come CometAPI espone i model ID nella documentazione.

Directory dei modelli

Esplora la disponibilità e le capacità dei modelli.

Prezzi

Controlla i prezzi prima di chiamare un modello.

Moderazione dei contenuti

Chiavi API

Scegli un’API audio

Create speech

Create transcription

Create translation

Create speech

Esempio di risposta

Esempi di record dei modelli

Errori comuni

Codici di errore e strategia di retry

Prezzi e directory dei modelli

Pagina dei modelli

Directory dei modelli

Prezzi

​Scegli un’API audio

Create speech

Create transcription

Create translation

​Create speech

​Esempio di risposta

​Esempi di record dei modelli

​Errori comuni

​Codici di errore e strategia di retry

​Prezzi e directory dei modelli

Pagina dei modelli

Directory dei modelli

Prezzi

Scegli un’API audio

Create speech

Esempio di risposta

Esempi di record dei modelli

Errori comuni

Codici di errore e strategia di retry

Prezzi e directory dei modelli