> ## 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.

# Посібник з інтеграції озвучення для електронної комерції

> Kling video generation API guide - Ace Data Cloud

Надсилайте завдання через `POST /kling/video-commerce`, використовуйте наявний `POST /kling/tasks` для перевірки статусу завдання платформи.

## Вхідні дані

Завантажте одне зображення людини та вкажіть voice\_id, або використовуйте попередньо встановлений avatar\_id (ці два варіанти взаємовиключні, для попередньо встановленого персонажа не можна окремо вказувати voice\_id). Необхідно надати speech\_script обсягом до 2000 символів. Під час надання інформації про товар потрібні щонайменше одне ref\_image та один goods\_title; озвучення товару не підтримує speech\_rate. Звичайне озвучення персонажа підтримує швидкість мовлення 0.8, 1.0 або 1.2.

Нижче наведено приклад структури запиту, замініть URL-адреси матеріалів перед викликом.

```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
}
```

## Результати та тарифікація

Синхронний режим повертає результат генерації; асинхронний режим спочатку повертає `task_id`, а завершений результат містить у `data` посилання на відео або зображення та обчислений сервером `usage`. `callback_url` використовується для сповіщення про завершення; запит із `watermark=true` одночасно повертає версію з водяним знаком.

Звичайне озвучення персонажа: 720p — 1.4 Credits/секунду, 1080p — 1.68 Credits/секунду; озвучення товару: 720p — 1.96 Credits/секунду, 1080p — 2.24 Credits/секунду. Відео тарифікується за фактичною тривалістю генерації, базова ціна за секунду до генерації не є загальною ціною всього завдання. За невдалі завдання плата за генерацію не стягується.


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