Fish Model Create API Integrazione Istruzioni

Questo API si basa su Fish Audio Official Model API ed è utilizzato per creare un modello di voce clonata riutilizzabile a lungo termine basato su un campione audio. L’indirizzo è POST https://api.acedata.cloud/fish/model.

Se hai bisogno di utilizzare una voce di riferimento temporaneamente, non è necessario creare un modello, puoi utilizzare direttamente il references dell’Fish TTS API per un clone istantaneo. Per la ricerca paginata delle voci esistenti, consulta il Fish Model Query API; per cercare i dettagli di una singola voce per _id, consulta il Fish Model Get API.

Processo di Richiesta

Per utilizzare il Fish Model API, prima 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 per un’esperienza senza costi; se il credito è insufficiente, puoi ricaricare il saldo generale nel console.

📘 Documentazione completa: Fish Model API →

Campi del Corpo della Richiesta

Campo	Tipo	Obbligatorio	Descrizione
`title`	string	Sì	Nome della voce, utilizzato per l’identificazione nell’elenco del console.
`voices`	string	Sì	URL HTTP(S) del campione audio (stringa singola, non un array). Questo API non supporta l’upload multipart/binario, si prega di caricare l’audio in un qualsiasi storage pubblico accessibile.
`description`	string	No	Descrizione della voce.
`cover_image`	string	No	URL HTTP(S) dell’immagine di copertura.
`tags`	string[]	No	Tag di ricerca per la libreria pubblica, ad esempio `["male","narration","zh"]`.
`texts`	string[]	No	Testi di riferimento corrispondenti ai campioni (utilizzati per correggere la pronuncia).
`enhance_audio_quality`	boolean	No	Se migliorare la qualità audio del campione prima dell’addestramento.
`generate_sample`	boolean	No	Se generare automaticamente un campione audio dopo il completamento dell’addestramento.

I campi sono completamente coerenti con quelli upstream, si prega di consultare anche la documentazione ufficiale di Fish.

Esempio: Creare una Voce Clonata Privata

curl -X POST 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "title": "La mia voce clonata",
    "description": "Voce cinese clonata da una registrazione di un podcast",
    "voices": "https://example.com/sample-voice.mp3",
    "cover_image": "https://cdn.acedata.cloud/e724d7f13d.png"
  }'

Nota: voices deve essere una stringa (singolo URL audio), non un array. Se inviato come ["..."], l’upstream rifiuterà.

La risposta di successo restituisce direttamente l’oggetto ModelEntity della piattaforma Fish (l’esempio seguente è il campione minimo utilizzabile che abbiamo testato, con alcune lunghe stringhe rimosse per facilitarne la lettura):

{
  "_id": "e5c6db52c3ed417f9cb2e5a33fb04667",
  "type": "tts",
  "title": "copilot-smoke-test",
  "description": "smoke test from api.acedata.cloud",
  "cover_image": "coverimage/e5c6db52c3ed417f9cb2e5a33fb04667",
  "train_mode": "fast",
  "state": "trained",
  "tags": [],
  "samples": [
    {
      "title": "Default Sample",
      "text": "师父，[语气坚定]我真的受够了这山上的清冷日子！...",
      "task_id": "6a1bf398dfae49dca0e23159214342a0",
      "audio": "https://platform.r2.fish.audio/task/6a1bf398dfae49dca0e23159214342a0.mp3"
    }
  ],
  "created_at": "2026-05-10T03:52:55.601000Z",
  "updated_at": "2026-05-10T03:52:55.601000Z",
  "languages": ["zh"],
  "visibility": "public",
  "default_text": "师父，[语气坚定]我真的受够了这山上的清冷日子！...",
  "like_count": 0,
  "mark_count": 0,
  "shared_count": 0,
  "task_count": 0,
  "author": {
    "_id": "780f2b2f862d41a08c0507bbbda77eb6",
    "nickname": "Penny Conrad",
    "avatar": "avatars/780f2b2f862d41a08c0507bbbda77eb6.jpg"
  }
}

_id può essere utilizzato come valore del campo reference_id nell’Fish TTS API per utilizzare questa voce clonata per la sintesi vocale:

curl -X POST 'https://api.acedata.cloud/fish/tts' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "text": "Ciao, questa è una voce sintetizzata utilizzando la mia voce clonata appena creata.",
    "reference_id": "e5c6db52c3ed417f9cb2e5a33fb04667",
    "format": "mp3"
  }'

Requisiti per i Campioni

Valori di esperienza (coerenti con l’upstream, consultare la documentazione ufficiale di Fish):

La durata consigliata è superiore a 30 secondi e inferiore a 5 minuti; oltre 10 minuti il guadagno marginale è limitato.
Frequenza di campionamento di 16 kHz o superiore, mono o stereo va bene.
Contenuto il più pulito possibile: senza musica di sottofondo, eco, rumori ambientali evidenti; stesso parlante.
Formato consigliato mp3 / wav.

Se non sei sicuro della qualità del campione, puoi inviare anche enhance_audio_quality: true per far migliorare la qualità audio upstream.

Informazioni di Fatturazione

La creazione di un modello di voce clonata (POST /fish/model) è gratuita, non ci sono costi; anche le interfacce di query delle voci ([Fish Model Query](https://platform.acedata.cloud/documents/fish-model-query), [Fish Model Get](https://platform.acedata.cloud/documents/fish-model-get)) non comportano costi. I costi si generano solo durante le chiamate successive a Fish TTS per la sintesi vocale in base all’uso.

Gestione degli Errori

400 token_mismatched：parametri della richiesta mancanti o non validi (il più comune è che voices non sia un URL, o sia passato come array).
401 invalid_token：token di autenticazione assente o non valido.
429 too_many_requests：limite di velocità dell’account attivato.
500 api_error：errore interno del server.

Esempio di risposta di errore:

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "voices è richiesto e deve essere un URL HTTP(S) che punta a un file audio"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Conclusione

Per chiamare questa interfaccia è sufficiente preparare un URL di campione audio accessibile pubblicamente, metterlo nel campo voices per ottenere _id, e poi fornirlo a reference_id di /fish/tts per completare il processo end-to-end di “clonazione → sintesi”. Un comune punto critico è che voices deve essere una stringa, non può essere un array.

Inizia

Chat AI

Immagine AI

Video AI

Audio AI

Web e Dati

CAPTCHA

Identità

Proxy

Avanzato

Coding

Fish Model Create API Integrazione Istruzioni

Processo di Richiesta

Campi del Corpo della Richiesta

Esempio: Creare una Voce Clonata Privata

Requisiti per i Campioni

Informazioni di Fatturazione

Gestione degli Errori

Conclusione

​Processo di Richiesta

​Campi del Corpo della Richiesta

​Esempio: Creare una Voce Clonata Privata

​Requisiti per i Campioni

​Informazioni di Fatturazione

​Gestione degli Errori

​Conclusione

Processo di Richiesta

Campi del Corpo della Richiesta

Esempio: Creare una Voce Clonata Privata

Requisiti per i Campioni

Informazioni di Fatturazione

Gestione degli Errori

Conclusione