Skip to main content
Questo documento presenta le istruzioni per l’integrazione dell’API Fish Model Get (GET /fish/model/{id}), compatibile al 100% con Fish Audio API OpenAPI ufficiale, utilizzata per ricercare i dettagli completi di un singolo clone di voice tramite ID.
Per creare una voice, fare riferimento a Fish Model Create API; per la ricerca tramite paginazione, consultare Fish Model Query API.

​
Processo di richiesta

Per utilizzare l’API, è necessario prima richiedere il servizio corrispondente alla pagina Fish Model API. Accedendo alla pagina, cliccare sul pulsante “Acquire”. Se non sei ancora loggato o registrato, verrai automaticamente reindirizzato alla pagina di login per registrarti e accedere. Dopo aver effettuato login o registrazione, verrai reindirizzato automaticamente alla pagina corrente. Durante la prima richiesta, viene assegnato un credito gratuito che consente di usare l’API gratuitamente.

​
Differenze rispetto all’API ufficiale

  • Metodo di autenticazione: utilizza Authorization: Bearer {token}, dove {token} è la chiave richiesta sulla piattaforma.
  • Struttura di risposta: trasmette direttamente l’oggetto Fish ModelEntity upstream, senza incapsulamento platform envelope; in caso di errore, utilizza la struttura standard {success:false, error:{code,message}, trace_id}.
  • Parametri di percorso: {id} corrisponde all’_id della voice, che può essere ottenuto durante la creazione tramite Fish Model Create API o tramite ricerca paginata con Fish Model Query API.

​
Esempio di richiesta

Sostituisci semplicemente {id} nel percorso URL con l’ID specifico della voice, senza bisogno di parametri di query o corpo della richiesta.

​
Esempio di risposta

La risposta di successo trasmette direttamente l’oggetto Fish ModelEntity:
L’_id restituito può essere utilizzato come valore del campo reference_id nel Fish TTS API per effettuare la sintesi vocale con questa voice clonata.

​
Note sui costi

Questa API è gratuita — la ricerca dei dettagli di una voice tramite ID è un’operazione gratuita. La creazione di nuove voci tramite POST /fish/model con il campo voices nel corpo della richiesta è l’unica operazione soggetta a costo.

​
Gestione degli errori

  • 400 token_mismatched: parametri mancanti o non validi.
  • 400 api_not_implemented: metodo o parametri non supportati attualmente.
  • 401 invalid_token: mancanza o invalidità delle credenziali di autenticazione.
  • 404 not_found: la voice con _id specificato non esiste o non è visibile dall’account corrente.
  • 429 too_many_requests: superato il limite di richiesta per l’account.
  • 500 api_error: errore interno del server.

​
Esempio di risposta di errore

​
Conclusioni

L’API Fish Model Get offre una funzionalità di ricerca dettagliata di singole voci, compatibile con l’API ufficiale Fish Audio. Dopo aver ottenuto l’ID della voice, è possibile usare questa API per recuperare l’oggetto completo ModelEntity (inclusi campioni, stato, visibilità, statistiche, ecc.), e combinarla con Fish TTS API per completare il flusso end-to-end di clonazione e sintesi.