> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Guida all'integrazione del parlato e-commerce

> Kling video generation API guide - Ace Data Cloud

Invia un'attività tramite `POST /kling/video-commerce` e utilizza il già disponibile `POST /kling/tasks` per verificare lo stato dell'attività sulla piattaforma.

## Input

Carica un'immagine di una persona e specifica voice\_id, oppure utilizza un avatar\_id preimpostato (i due sono mutuamente esclusivi e per i personaggi preimpostati non è possibile specificare ulteriormente voice\_id). È obbligatorio fornire uno speech\_script di massimo 2000 caratteri. Quando si forniscono informazioni sul prodotto, sono necessari almeno una ref\_image e un goods\_title; il parlato del prodotto non supporta speech\_rate. Il normale parlato di una persona supporta una velocità di 0.8, 1.0 o 1.2 volte.

Di seguito è riportato un esempio della struttura della richiesta: sostituisci gli URL delle risorse prima di effettuare la chiamata.

```json theme={null}
{
  "contents": [
    {
      "type": "avatar_image",
      "url": "https://your-cdn.example/person.jpg"
    },
    {
      "type": "ref_image",
      "url": "https://your-cdn.example/product.jpg"
    },
    {
      "type": "goods_title",
      "text": "你的商品或口播内容"
    },
    {
      "type": "speech_script",
      "text": "你的商品或口播内容"
    }
  ],
  "settings": {
    "resolution": "720p",
    "voice_id": "male_calm_informative"
  },
  "async": true
}
```

## Risultati e fatturazione

La modalità sincrona restituisce il risultato generato; la modalità asincrona restituisce prima `task_id`, e il risultato completato include i collegamenti al video o all'immagine in `data` e l'`usage` calcolato dal server. `callback_url` viene utilizzato per la notifica di completamento; una richiesta con `watermark=true` restituisce contemporaneamente la versione con filigrana.

Normale parlato di una persona: 1.4 Credits/secondo per 720p e 1.68 Credits/secondo per 1080p; parlato del prodotto: 1.96 Credits/secondo per 720p e 2.24 Credits/secondo per 1080p. I video vengono fatturati in base alla durata effettiva generata; il prezzo base al secondo prima della generazione non rappresenta il prezzo totale dell'intera attività. Le attività non riuscite non comportano costi di generazione.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.