Processo de Solicitação
Para usar a API de Geração de Movimento Kling, primeiro acesse o Console da Ace Data Cloud para obter seu Token de API, que deve ser mantido em segurança.
Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, onde será convidado a se registrar e logar; após a conclusão, você será redirecionado de volta para a página atual.
Um Token de API é suficiente para acessar todos os serviços da plataforma, não sendo necessário solicitar individualmente para cada serviço. A primeira solicitação oferece um crédito gratuito para que você possa experimentar; quando o crédito estiver baixo, você pode recarregar o saldo geral no console.
📘 Documentação Completa: API de Geração de Movimento Kling →
Uso Básico
Primeiro, entenda a forma básica de uso, que consiste em inserir a palavra-chaveprompt, a URL da imagem de referência image_url e o link do vídeo de referência video_url, para obter o resultado processado. Em seguida, precisamos inserir o modelo mode, que atualmente possui os modelos std e pro, conforme descrito abaixo:
accept: o formato de resposta desejado, que deve ser preenchido comoapplication/json, ou seja, formato JSON.authorization: a chave para chamar a API, que pode ser selecionada diretamente após a solicitação.
image_url: URL da imagem de referência da aparência da pessoa. Suporta JPG/JPEG/PNG, arquivo ≤50MB, largura e altura ≥300px, proporção de aspecto de 1:2.5 a 2.5:1; a pessoa deve ser claramente visível na parte superior do corpo ou no corpo inteiro, incluindo a cabeça.video_url: URL do vídeo de referência de movimento. Suporta MP4/MOV, arquivo ≤100MB, largura e altura entre 340–3850px, com duração mínima de 3 segundos;character_orientation=imagetem um máximo de 10 segundos, enquantocharacter_orientation=videotem um máximo de 30 segundos. Recomenda-se usar um vídeo contínuo de um único plano em que a pessoa esteja sempre visível.mode: o modo de geração do vídeo, que pode ser o modo padrãostdou o modo rápidopro.keep_original_sound: opção para manter o som original do vídeo, valores enumerados: yes, no.character_orientation: a orientação da pessoa no vídeo gerado, podendo ser escolhida para ser consistente com a imagem ou com o vídeo, valores enumerados: image, video.prompt: palavra-chave.callback_url: URL para onde os resultados devem ser enviados.async: opcional, se definido comotrue, a interface retorna imediatamentetask_id, sem necessidade de fornecercallback_url, e os resultados podem ser obtidos posteriormente através da interface de consulta de tarefas correspondente.
success, o estado da tarefa de geração do vídeo.task_id, o ID da tarefa de geração do vídeo.video_id, o ID do vídeo gerado pela tarefa.video_url, o link do vídeo gerado pela tarefa.duration, a duração do vídeo gerado pela tarefa.state, o estado da tarefa de geração do vídeo.
data do resultado para obter o vídeo Kling.
Além disso, se você quiser gerar o código de integração correspondente, pode copiá-lo diretamente, por exemplo, o código CURL é o seguinte:
Callback Assíncrono
Como o tempo de geração da API de Geração de Movimento Kling é relativamente longo, levando cerca de 1-2 minutos, se a API não responder por um longo período, a solicitação HTTP manterá a conexão, resultando em consumo adicional de recursos do sistema. Portanto, esta API também oferece suporte a callbacks assíncronos. O fluxo geral é: quando o cliente inicia a solicitação, deve especificar um campocallback_url adicional. Após a solicitação da API, a API retornará imediatamente um resultado, contendo um campo task_id, que representa o ID da tarefa atual. Quando a tarefa for concluída, o resultado do vídeo gerado será enviado para o callback_url especificado pelo cliente em formato JSON POST, incluindo também o campo task_id, permitindo que o resultado da tarefa seja associado pelo ID.
Abaixo, vamos entender como operar isso através de um exemplo.
Primeiro, o callback Webhook é um serviço que pode receber solicitações HTTP, e os desenvolvedores devem substituí-lo pela URL do servidor HTTP que construíram. Para facilitar a demonstração, usaremos um site de exemplo de Webhook público https://webhook.site/, onde você pode abrir o site e obter uma URL de Webhook, como mostrado na imagem:
Copie esta URL para usá-la como Webhook; o exemplo aqui é https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3.
Em seguida, podemos definir o campo callback_url para a URL do Webhook acima, enquanto inserimos os parâmetros correspondentes, conforme mostrado na imagem:
https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3, como mostrado na imagem:
O conteúdo é o seguinte:
task_id, e os outros campos são semelhantes aos mencionados anteriormente, através deste campo é possível realizar a associação da tarefa.
Tratamento de Erros
Ao chamar a API, se encontrar um erro, a API retornará o código de erro e a mensagem correspondente. Por exemplo:400 token_mismatched: Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.400 api_not_implemented: Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.401 invalid_token: Não autorizado, token de autorização inválido ou ausente.429 too_many_requests: Muitas solicitações, você excedeu o limite de taxa.500 api_error: Erro interno do servidor, algo deu errado no servidor.