Processo de solicitação
Para usar a API Kling Videos Generation, primeiro obtenha seu API Token no Console Ace Data Cloud e guarde-o para uso posterior.
Se você ainda não estiver conectado ou registrado, será automaticamente redirecionado para a página de login, onde será convidado a se registrar e entrar. Após a conclusão, você retornará automaticamente à página atual.
Um único API Token pode chamar todos os serviços da plataforma, sem necessidade de solicitar separadamente para cada serviço. A primeira solicitação oferecerá créditos gratuitos para uma experiência sem custo; quando os créditos forem insuficientes, você poderá recarregar o saldo geral no console.
📘 Documentação completa: Kling Videos Generation API →
Exemplo de solicitação
A API Kling Tasks pode ser usada para consultar os resultados da API Kling Videos Generation. Para saber como usar a API Kling Videos Generation, consulte a documentação Kling Videos Generation API 。 Usaremos como exemplo um ID de tarefa retornado pelo serviço API Kling Videos Generation para demonstrar como usar esta API. Suponha que temos um ID de tarefa: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0; em seguida, demonstraremos como fazer isso passando um ID de tarefa.Imagem de exemplo da tarefa
Configurar cabeçalhos e corpo da solicitação
Request Headers incluem:accept: especifica o recebimento de resultados de resposta no formato JSON; aqui, preencha comapplication/json.authorization: a chave para chamar a API, que pode ser selecionada diretamente na lista suspensa após a solicitação.
id: o ID da tarefa enviada.action: o modo de operação da tarefa.
Exemplo de código
É possível observar que vários códigos em diferentes linguagens já foram gerados automaticamente no lado direito da página, como mostrado na imagem:
CURL
Python
Exemplo de resposta
Após a solicitação ser bem-sucedida, a API retornará as informações detalhadas da tarefa de vídeo aqui. Por exemplo:request é o request body ao iniciar a tarefa, enquanto o campo response é o response body retornado após a conclusão da tarefa. A descrição dos campos é a seguinte.
id, o ID que gera esta tarefa de vídeo, usado para identificar exclusivamente esta tarefa de geração de vídeo.request, as informações da solicitação na consulta da tarefa de vídeo.response, as informações de retorno na consulta da tarefa de vídeo.created_at, horário de criação da tarefa, timestamp Unix (segundos, ponto flutuante).started_at, horário de início da execução da tarefa, timestamp Unix (segundos, ponto flutuante).finished_at, horário de conclusão da tarefa, timestamp Unix (segundos, ponto flutuante). Este campo não é retornado quando a tarefa não foi concluída.elapsed, tempo de execução da tarefa, em segundos (ponto flutuante, com 3 casas decimais). Este campo não é retornado quando a tarefa não foi concluída.
Operação de consulta em lote
Isto é para consultar os detalhes de tarefas de vídeo de vários IDs de tarefa. Diferentemente do acima, é necessário selecionarretrieve_batch como action.
Request Body inclui:
ids: array de IDs de tarefas enviados.action: o modo de operação da tarefa.
Exemplo de código
É possível observar que vários códigos em diferentes linguagens já foram gerados automaticamente no lado direito da página, como mostrado na imagem:
Exemplo de resposta
Após a solicitação ser bem-sucedida, a API retornará informações detalhadas específicas de todas as tarefas de vídeo em lote desta vez. Por exemplo:items contém as informações detalhadas específicas das tarefas de vídeo em lote. As informações específicas de cada tarefa de vídeo são iguais aos campos acima, e as informações dos campos são as seguintes.
items, todas as informações detalhadas específicas das tarefas de vídeo em lote. É um array, e cada elemento do array tem o mesmo formato de resultado retornado da consulta de uma única tarefa acima.count, o número de tarefas de vídeo consultadas em lote aqui.
CURL
Tratamento de erros
Ao chamar a API, se ocorrer um erro, a API retornará o código e a mensagem de erro correspondentes. 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.