Fish Model Get API Integrazione

Questo API si basa su Fish Audio Official Model API ed è utilizzato per richiedere i dettagli completi di un singolo clone vocale in base a _id. L’indirizzo è GET https://api.acedata.cloud/fish/model/{id}.

Per creare un timbro vocale, si prega di fare riferimento a Fish Model Create API; per la ricerca paginata, si prega di fare riferimento a Fish Model Query API.

Processo di richiesta

Per utilizzare l’API Fish Model, prima di tutto vai al Ace Data Cloud Console per ottenere il tuo API Token, da conservare per uso futuro.

Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e accedere; una volta completato, verrai riportato automaticamente alla pagina corrente. Un API Token è sufficiente per accedere a tutti i servizi della piattaforma, non è necessario richiederne uno separato per ogni servizio. La prima richiesta ti darà un credito gratuito, che ti permetterà di provare gratuitamente; se il credito è insufficiente, puoi ricaricare il saldo generale nella console.

📘 Documentazione completa: Fish Model API →

Parametri del percorso

Parametro	Obbligatorio	Descrizione
`id`	Sì	`_id` del timbro vocale (stringa esadecimale di 32 caratteri). Può essere restituito durante la creazione tramite Fish Model Create o recuperato tramite Fish Model Query.

Nessun corpo della richiesta, nessun parametro di query.

Esempio: Recuperare i dettagli completi di un timbro vocale spagnolo pubblico

curl 'https://api.acedata.cloud/fish/model/8d2c17a9b26d4d83888ea67a1ee565b2' \
  -H 'authorization: Bearer {token}'

Risposta (testato, rimosso il query string di firma in samples[].audio per facilitare la lettura):

{
  "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
  "type": "tts",
  "title": "Valentino Narración Biblica Fer",
  "description": "Una voce maschile matura e autorevole con un tono calmo e spirituale. È ben adatta per narrazioni religiose, contenuti educativi e narrazioni professionali in spagnolo.",
  "cover_image": "coverimage/8d2c17a9b26d4d83888ea67a1ee565b2",
  "train_mode": "fast",
  "state": "trained",
  "tags": [
    "male", "old", "narration", "calm", "serious",
    "authoritative", "professional", "clear", "Spanish"
  ],
  "samples": [
    {
      "title": "Default Sample",
      "text": "Hermanos míos, recordemos las palabras del Señor en estos tiempos difíciles. Como dice la Escritura, la fe mueve montañas, y el amor de Dios nos guía en cada paso del camino. Mantengamos firme nuestra confianza en Su divina providencia.",
      "task_id": "59ce7df6935c42249759327ddf70f37b",
      "audio": "https://c97f3361a1c971323738e24f451a0225.r2.cloudflarestorage.com/fish-platform-data/task/59ce7df6935c42249759327ddf70f37b.mp3?X-Amz-...signed..."
    }
  ],
  "created_at": "2025-03-13T08:11:10.326000Z",
  "updated_at": "2026-05-03T09:01:41.437000Z",
  "languages": ["es"],
  "visibility": "public",
  "lock_visibility": false,
  "dmca_taken_down": false,
  "default_text": "Hermanos míos, recordemos las palabras del Señor...",
  "quality": null,
  "like_count": 4344,
  "mark_count": 4409,
  "shared_count": 590,
  "task_count": 708461,
  "unliked": false,
  "liked": false,
  "marked": false,
  "author": {
    "_id": "1b82fb6a329c4462b67aa9ee0a42046f",
    "nickname": "Fernando Caicedo",
    "avatar": "avatars/1b82fb6a329c4462b67aa9ee0a42046f.jpg"
  }
}

L’ _id ottenuto può essere direttamente fornito a Fish TTS come reference_id per sintetizzare la voce con lo stesso timbro:

curl -X POST 'https://api.acedata.cloud/fish/tts' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "text": "Hermanos míos, hoy es un buen día.",
    "reference_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
    "format": "mp3"
  }'

Differenze con l’interfaccia di elenco

Campo	`GET /fish/model` (elenco)	`GET /fish/model/{id}` (dettagli)
`samples[].audio`	URL R2 cache a breve termine	Link diretto R2 firmato (incluso query di firma)
`unliked` / `liked` / `marked` / `dmca_taken_down`	Esistono entrambi	Esistono entrambi
`default_text` / `lock_visibility`	Esistono entrambi	Esistono entrambi

Se desideri solo ascoltare, il samples[].audio nell’interfaccia di elenco è già sufficiente; per un link di download più stabile, si consiglia di utilizzare questa interfaccia.

Campi di risposta (estratto)

Campo	Tipo	Descrizione
`_id`	string	ID del timbro vocale (utilizzato per `reference_id` in `/fish/tts`).
`type`	string	Tipo di modello, solitamente `tts`.
`title`	string	Nome del timbro vocale.
`description`	string	Descrizione lunga.
`state`	string	Stato di addestramento: `trained` indica disponibile, `training` indica in fase di addestramento.
`tags`	string[]	Etichette della libreria pubblica.
`samples`	object[]	Campioni preimpostati, contenenti `title`, `text`, `task_id`, `audio` link diretto.
`languages`	string[]	Codici delle lingue in cui il timbro vocale è esperto.
`visibility`	string	`public` o `private`.
`like_count`	integer	Numero di “mi piace” nella libreria pubblica.
`task_count`	integer	Numero di sintesi storiche (può essere utilizzato come riferimento per la popolarità).
`author`	object	Informazioni sull’autore: `_id` / `nickname` / `avatar`.
`created_at`	string	Data di creazione in formato ISO 8601.
`updated_at`	string	Data di ultimo aggiornamento in formato ISO 8601.

Informazioni di fatturazione

Questa interfaccia non comporta costi - la richiesta di dettagli di un singolo timbro vocale per ID è un’operazione gratuita. La creazione di un timbro vocale (Fish Model Create) è anch’essa gratuita, i costi si generano solo quando si utilizza Fish TTS per sintetizzare la voce.

Gestione degli errori

400 token_mismatched: L’id nel percorso non è in un formato valido, oppure il sistema upstream riporta “Model not found”.
401 invalid_token: Il token di autorizzazione non esiste o è invalido.
404 not_found: L’_id specificato non è visibile nell’upstream di Fish (il modello è stato eliminato, è privato o appartiene a un altro account).
429 too_many_requests: È stato attivato il limite di velocità dell’account.
500 api_error: Errore interno del server.

Quando si richiede un ID inesistente, l’upstream restituisce direttamente 400 Model not found (testato):

curl 'https://api.acedata.cloud/fish/model/test123' \
  -H 'authorization: Bearer {token}'

Restituisce:

{ "status": 400, "message": "Model not found" }

Esempio di risposta di errore:

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Conclusione

Quando si conosce l’_id del modello, utilizzare direttamente questa interfaccia per ottenere il ModelEntity completo. Gli usi più comuni sono: (1) ascoltare samples[].audio, (2) fornire l’_id a reference_id di /fish/tts per completare la sintesi. Se si dispone solo del titolo o delle etichette, utilizzare prima Fish Model Query per effettuare la ricerca.

Inizia

Chat AI

Immagine AI

Video AI

Audio AI

Web e Dati

CAPTCHA

Identità

Proxy

Avanzato

Coding

Fish Model Get API Integrazione

Processo di richiesta

Parametri del percorso

Esempio: Recuperare i dettagli completi di un timbro vocale spagnolo pubblico

Differenze con l’interfaccia di elenco

Campi di risposta (estratto)

Informazioni di fatturazione

Gestione degli errori

Conclusione

​Processo di richiesta

​Parametri del percorso

​Esempio: Recuperare i dettagli completi di un timbro vocale spagnolo pubblico

​Differenze con l’interfaccia di elenco

​Campi di risposta (estratto)

​Informazioni di fatturazione

​Gestione degli errori

​Conclusione

Processo di richiesta

Parametri del percorso

Esempio: Recuperare i dettagli completi di un timbro vocale spagnolo pubblico

Differenze con l’interfaccia di elenco

Campi di risposta (estratto)

Informazioni di fatturazione

Gestione degli errori

Conclusione