Vai al contenuto principale

​
Introduzione

Kling è un servizio video AI fornito da Ace Data Cloud, un modello di generazione video rapido e intelligente. Attraverso l’API unificata di Ace Data Cloud, puoi integrare rapidamente Kling con Python per realizzare funzionalità come testo in video, immagine in video, continuazione video, diverse durate e proporzioni.

​
Prerequisiti

  • Possedere un account su Ace Data Cloud e ottenere un API Token
  • Ambiente Python 3.7 o superiore
  • Installare la libreria requests: pip install requests

​
Uso base

L’endpoint principale per chiamare l’API Kling è: 
POST https://api.acedata.cloud/kling/videos
In questo esempio si utilizza il modello kling-v2-5-turbo. I modelli disponibili includono: kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-video-o1. Esempio completo di codice Python: 
import requests

url = "https://api.acedata.cloud/kling/videos"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "action": "text2video",
    "prompt": "A white cat walking in the snow",
    "model": "kling-v2-5-turbo",
    "duration": 5,
    "aspect_ratio": "16:9"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Sostituisci YOUR_API_TOKEN con il token reale ottenuto sulla piattaforma Ace Data Cloud.

​
Gestione della risposta

Dopo una chiamata riuscita, l’API restituisce dati in formato JSON. Si consiglia di verificare lo status code HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Chiamata riuscita:", result)
else:
    print(f"Chiamata fallita, codice stato: {response.status_code}")
    print(response.text)

​
Uso avanzato

Per le API che supportano attività asincrone, è possibile ottenere i risultati tramite URL di callback: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Il risultato sarà inviato al tuo server tramite la callback URL

​
Gestione degli errori

Codici di errore comuni:
CodiceDescrizione
401Autenticazione fallita, controlla l’API Token
403Credito insufficiente o accesso negato
429Limite di frequenza delle richieste superato
500Errore interno del server

​
Altri endpoint

Il servizio Kling offre anche i seguenti endpoint:
  • POST https://api.acedata.cloud/kling/tasks
  • POST https://api.acedata.cloud/kling/motion

​
Passi successivi