Processo di richiesta
Per utilizzare Fish Audios Generation API, ottenete innanzitutto il vostro API Token dalla console di Ace Data Cloud e conservatelo per l’uso.
Se non avete ancora effettuato l’accesso o la registrazione, verrete automaticamente reindirizzati alla pagina di accesso che vi inviterà a registrarvi e ad accedere; al termine tornerete automaticamente alla pagina corrente.
Un solo API Token può chiamare tutti i servizi della piattaforma, senza doverne richiedere uno separatamente per ogni servizio. Alla prima richiesta verrà assegnato credito gratuito, utilizzabile per una prova gratuita; quando il credito è insufficiente, potete ricaricare il saldo universale nella console.
📘 Documentazione completa: Fish Audios Generation API →
Esempio di richiesta
Fish Tasks API può essere utilizzata per interrogare i risultati di Fish Audios Generation API. Per sapere come utilizzare Fish Audios Generation API, consultate la documentazione Fish Videos Generation API . Prendiamo come esempio un ID attività restituito dal servizio Fish Audios Generation API per mostrare come utilizzare questa API. Supponiamo di avere un ID attività: 2725a2d3-f87e-4905-9c53-9988d5a7b2f5, di seguito mostreremo come passare un ID attività.Immagine di esempio dell’attività
Impostare le intestazioni e il corpo della richiesta
Request Headers includono:accept: specifica la ricezione del risultato della risposta in formato JSON; qui compilare conapplication/json.authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dal menu a discesa dopo la richiesta.
id: l’ID dell’attività caricata.action: il metodo di operazione sull’attività.
Esempio di codice
Si può notare che sul lato destro della pagina sono stati generati automaticamente codici in vari linguaggi, come mostrato nella figura:
CURL
Esempio di risposta
Dopo che la richiesta è andata a buon fine, l’API restituirà le informazioni dettagliate dell’attività qui. Ad esempio:id, l’ID generato per questa attività, utilizzato per identificare univocamente questa attività di generazione.request, le informazioni della richiesta nell’interrogazione dell’attività.response, le informazioni di ritorno nell’interrogazione dell’attività; al successo finale, il relativocost.amountrappresenta i Credits effettivamente detratti per questa sintesi.created_at, l’ora di creazione dell’attività, timestamp Unix (secondi, in virgola mobile).started_at, l’ora di inizio dell’esecuzione dell’attività, timestamp Unix (secondi, in virgola mobile).finished_at, l’ora di completamento dell’attività, timestamp Unix (secondi, in virgola mobile). Questo campo non viene restituito quando l’attività non è completata.elapsed, il tempo richiesto per l’esecuzione dell’attività, in secondi (in virgola mobile, con 3 cifre decimali). Questo campo non viene restituito quando l’attività non è completata.
Operazione di interrogazione in batch
Questa operazione serve a interrogare i dettagli delle attività per più ID attività; la differenza rispetto a quanto sopra è che è necessario selezionare action come retrieve_batch Request Body include:ids: l’array di ID delle attività caricate.action: il metodo di operazione sull’attività.
Esempio di codice
Si può notare che sul lato destro della pagina sono stati generati automaticamente codici in vari linguaggi, come mostrato nella figura:
Esempio di risposta
Dopo che la richiesta è andata a buon fine, l’API restituirà informazioni dettagliate specifiche di tutte le attività batch di questa richiesta. Ad esempio:items contiene le informazioni dettagliate specifiche delle attività batch; le informazioni specifiche di ciascuna attività sono uguali ai campi sopra indicati. Le informazioni sui campi sono le seguenti.
items, tutte le informazioni dettagliate specifiche delle attività batch. È un array, e il formato di ogni elemento dell’array è uguale al formato del risultato restituito dalla query di una singola attività sopra indicato.count, il numero di attività nella query batch qui.
CURL
Gestione degli errori
Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.500 api_error: Errore interno del server, qualcosa è andato storto sul server.