Saltar para o conteúdo principal

Introdução

Kling é um serviço de vídeo AI fornecido pela Ace Data Cloud, um modelo de geração rápida de vídeo da Kuaishou. Através da API unificada da Ace Data Cloud, você pode usar cURL para chamar rapidamente o Kling, realizando funções como geração de vídeo a partir de texto, geração de vídeo a partir de imagens, continuação de vídeo, múltiplas durações e múltiplas proporções.

Pré-requisitos

  • Ter uma conta Ace Data Cloud e obter o Token da API
  • Ter um ambiente de terminal com cURL instalado

Uso Básico

O endpoint principal para chamar a API Kling é:
POST https://api.acedata.cloud/kling/videos
Este exemplo usa o modelo kling-v2-5-turbo.
Modelos disponíveis incluem: kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-video-o1.
Exemplo completo do comando cURL:
curl -X POST https://api.acedata.cloud/kling/videos \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "text2video", "prompt": "A white cat walking in the snow", "model": "kling-v2-5-turbo", "duration": 5, "aspect_ratio": "16:9"}'
Substitua YOUR_API_TOKEN pelo Token real obtido na plataforma Ace Data Cloud.

Exemplo de Resposta

Após uma chamada bem-sucedida, será retornado um dado em formato JSON, por exemplo:
{
  "status": "success",
  "data": {
    ...
  }
}

Usando jq para Processar a Resposta

Recomenda-se usar a ferramenta jq para formatar a saída:
curl -s -X POST https://api.acedata.cloud/kling/videos \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "text2video", "prompt": "A white cat walking in the snow", "model": "kling-v2-5-turbo", "duration": 5, "aspect_ratio": "16:9"}' | jq .

Tratamento de Erros

Códigos de erro comuns:
Código de StatusDescrição
401Falha na autenticação, verifique o API Token
403Saldo insuficiente ou acesso negado
429Limite de frequência de requisições excedido
500Erro interno do servidor

Próximos Passos