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

# Guia de integração de vídeo de produto

> Kling video generation API guide - Ace Data Cloud

Envie uma tarefa por meio de `POST /kling/goods-studio` e use o `POST /kling/tasks` existente para consultar o status da tarefa na plataforma.

## Entrada

Forneça 1–5 imagens do produto e um título do produto de até 200 caracteres; a descrição do produto é opcional, com até 2000 caracteres. A duração pode ser de 15, 30 ou 60 segundos.

A seguir está um exemplo de estrutura da solicitação; substitua a URL do material antes de chamar.

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

## Resultados e cobrança

O modo síncrono retorna o resultado gerado; o modo assíncrono primeiro retorna `task_id`, e o resultado concluído inclui os links de vídeo ou imagem em `data` e o `usage` calculado pelo servidor. `callback_url` é usado para notificações de conclusão; a solicitação com `watermark=true` também retorna a versão com marca-d'água.

720p: 2,38 Credits/segundo; 1080p: 2,8 Credits/segundo. Os vídeos são cobrados de acordo com a duração real gerada; o preço-base por segundo antes da geração não representa o preço total de toda a tarefa. Tarefas com falha não incorrem em custos de geração.


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