Procedura di richiesta
Per utilizzare la Kling Videos Generation API, ottenete prima il vostro API Token nella console di Ace Data Cloud e conservatelo come riserva.
Se non avete ancora effettuato l’accesso o non vi siete registrati, verrete automaticamente reindirizzati alla pagina di accesso per registrarvi e accedere; una volta completato, tornerete automaticamente alla pagina corrente.
Un solo API Token può chiamare tutti i servizi della piattaforma, senza necessità di richiederne uno separatamente per ciascun servizio. Alla prima richiesta verrà assegnato credito gratuito, per provare il servizio gratuitamente; quando il credito è insufficiente, potete ricaricare il saldo comune nella console.
📘 Documentazione completa: Kling Videos Generation API →
Esempio di richiesta
La Kling Tasks API può essere utilizzata per interrogare i risultati della Kling Videos Generation API. Per sapere come utilizzare la Kling Videos Generation API, fate riferimento alla documentazione Kling Videos Generation API . Prendiamo come esempio un ID attività restituito dal servizio Kling Videos Generation API, per mostrare come utilizzare questa API. Supponiamo di avere un ID attività: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0, di seguito mostreremo come farlo passando un ID attività.Immagine di esempio dell’attività
Impostare le intestazioni e il corpo della richiesta
Request Headers includono:accept: specifica la ricezione dei risultati di risposta in formato JSON, qui compilare conapplication/json.authorization: la chiave per chiamare l’API, dopo averla richiesta è possibile selezionarla direttamente dal menu a discesa.
id: l’ID dell’attività caricata.action: la modalità di operazione sull’attività.
Esempio di codice
Si può notare che sul lato destro della pagina sono già stati generati automaticamente codici in vari linguaggi, come mostrato nell’immagine:
CURL
Python
Esempio di risposta
Dopo che la richiesta è stata completata con successo, l’API restituirà le informazioni dettagliate dell’attività video qui. Ad esempio:id, l’ID che genera questa attività video, utilizzato per identificare univocamente questa attività di generazione video.request, le informazioni della richiesta nell’interrogazione dell’attività video.response, le informazioni di risposta nell’interrogazione dell’attività video.created_at, l’orario di creazione dell’attività, timestamp Unix (secondi, virgola mobile).started_at, l’orario di inizio dell’esecuzione dell’attività, timestamp Unix (secondi, virgola mobile).finished_at, l’orario di completamento dell’attività, timestamp Unix (secondi, virgola mobile). Questo campo non viene restituito quando l’attività non è completata.elapsed, il tempo impiegato per l’esecuzione dell’attività, in secondi (virgola mobile, mantenendo 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à video per più ID attività; a differenza di quanto sopra, è necessario selezionare retrieve_batch come action. Request Body include:ids: l’array degli ID attività caricati.action: la modalità di operazione sull’attività.
Esempio di codice
Si può notare che sul lato destro della pagina sono già stati generati automaticamente codici in vari linguaggi, come mostrato nell’immagine:
Esempio di risposta
Dopo che la richiesta è stata completata con successo, l’API restituirà le informazioni dettagliate specifiche di tutte le attività video in batch di questa volta. Ad esempio:items contiene le informazioni dettagliate specifiche delle attività video in batch; le informazioni specifiche di ogni attività video sono uguali ai campi sopra descritti e le informazioni sui campi sono le seguenti.
items, tutte le informazioni dettagliate specifiche delle attività video in batch. È un array, e il formato di ogni elemento dell’array è uguale al formato del risultato restituito dalla query di una singola attività sopra descritta.count, il numero di attività video interrogate in batch in questo caso.
CURL
Gestione degli errori
Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e il messaggio 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.